Elevation Data - Point, Path, Charts & Statistics by Apoth3osis

Name: Elevation Data - Point, Path, Charts & Statistics
Brand: Apoth3osis
SKU: 69615b4baa1df9dd0902d62e
Price: 0.10 USD
Availability: InStock

Elevation Data - Point, Path, Charts & Statistics

Data

Available ActionsEach successful request consumes credits as outlined below.

get_elevation^10crget_path_elevation^10crget_elevation_profile^10cr

Details

Comprehensive elevation data tool that provides elevation information for any location on Earth including ocean floor depths. The tool offers discrete location elevation lookups for up to 512 points, elevation sampling along defined paths with configurable resolution, automatic elevation profile generation with visualization charts, and detailed statistics including minimum maximum average elevation gain total ascent and descent. Features elevation data in both meters and feet with resolution accuracy indicators, elevation categorization from below sea level to very high elevation, distance calculations for path-based requests, and optional chart generation saved to cloud storage. Perfect for hiking and trail planning applications, geographic surveying and terrain analysis, cycling route optimization, real estate site assessment, and adventure sports planning.

Use Cases

Hiking trail elevation profile analysis, Cycling route difficulty assessment, Geographic surveying and flood risk mapping, Real estate site elevation evaluation, Mountain climbing route planning, Paragliding launch site analysis, Watershed and drainage studies, Construction site planning, Adventure sports terrain analysis, Topographical data visualization

Actions(3)

get_elevation^10cr1 param(1 required)

Get elevation data for one or more discrete locations. Returns elevation in meters and feet, resolution, category, and aggregate statistics when multiple points are provided.

locationsrequiredarray

List of locations for discrete elevation lookup (max 512). Each location must have latitude and longitude fields.

Array of: object

get_path_elevation^10cr5 params(1 required)

Sample elevation values at evenly-spaced points along a path defined by two or more waypoints. Returns elevation data for each sample point plus path statistics including total distance, ascent, and descent.

pathrequiredarray

List of locations defining a path (minimum 2 points). Each point must have latitude and longitude fields.

Array of: object

samplesinteger

Number of evenly-spaced sample points along the path (2-512)

Default: 100

Range: 2 - 512

generate_chartboolean

Set to true to also generate an elevation profile chart image (default false)

Default: false

chart_widthinteger

Chart width in inches (6-20). Only used when a chart is generated.

Default: 12

Range: 6 - 20

chart_heightinteger

Chart height in inches (4-12). Only used when a chart is generated.

Default: 6

Range: 4 - 12

get_elevation_profile^10cr4 params(1 required)

Same as get_path_elevation but always generates an elevation profile chart image. The chart shows elevation vs. distance with min/max markers and dual axes (meters and feet). A signed URL to the chart image is included in the response.

pathrequiredarray

List of locations defining a path (minimum 2 points). Each point must have latitude and longitude fields.

Array of: object

samplesinteger

Number of evenly-spaced sample points along the path (2-512)

Default: 100

Range: 2 - 512

chart_widthinteger

Chart width in inches (6-20)

Default: 12

Range: 6 - 20

chart_heightinteger

Chart height in inches (4-12)

Default: 6

Range: 4 - 12

Connect Your Agent In 5 Min

Use hosted MCP first, or install the local STDIO fallback when your client requires a command

Hosted Streamable HTTPS

Use the hosted endpoint directly in clients that support remote MCP. Store your Bearer token in the client config or secret field.

Endpoint: https://api.agentpmt.com/mcp
Authorization: Bearer <AGENTPMT_BEARER_TOKEN>

Full connection guide

Local STDIO Fallback

Use the local router for Claude Code, Codex, Cursor, Zed, and other clients that require a command-based MCP server. The router forwards requests to the hosted endpoint and does not execute tools locally.

npm install -g @agentpmt/mcp-routeragentpmt-setup

curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ********" \
  -d '{
    "product_id": "69615b4baa1df9dd0902d62e",
    "parameters": {
      "action": "get_elevation",
      "locations": []
    }
  }'

import requests
import json

url = "https://api.agentpmt.com/products/purchase"

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer ********"
}

data = {
    "product_id": "69615b4baa1df9dd0902d62e",
    "parameters": {
        "action": "get_elevation",
        "locations": []
    }
}

response = requests.post(url, headers=headers, json=data)
print(response.status_code)
print(response.json())

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "69615b4baa1df9dd0902d62e",
  parameters: {
    "action": "get_elevation",
    "locations": []
  }
};

fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(data)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error("Error:", error));

const axios = require('axios');

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "69615b4baa1df9dd0902d62e",
  parameters: {
    "action": "get_elevation",
    "locations": []
  }
};

axios.post(url, data, { headers })
  .then(response => {
    console.log(response.status);
    console.log(response.data);
  })
  .catch(error => {
    console.error("Error:", error.message);
  });

Login to view your API and budget keys. The example above uses placeholder values. Sign in to see personalized code with your bearer token.

Usage Instructions

Usage guidance provided directly by the developer for this product.

Elevation Data - Point, Path, Charts & Statistics

Get elevation data for any location on Earth. Look up elevations for individual points, sample elevations along a path, and generate visual elevation profile charts with statistics.

Actions

get_elevation

Get elevation data for one or more discrete locations. Returns elevation in meters and feet, resolution, and an elevation category for each point. When multiple locations are provided, includes aggregate statistics (min, max, average, gain, ascent, descent).

Required fields:

action — "get_elevation"
locations — Array of location objects (max 512), each with:
- latitude (number, -90 to 90)
- longitude (number, -180 to 180)

Example — Single point:

{
  "action": "get_elevation",
  "locations": [
    {"latitude": 27.9881, "longitude": 86.9250}
  ]
}

Example — Multiple points with statistics:

{
  "action": "get_elevation",
  "locations": [
    {"latitude": 37.7749, "longitude": -122.4194},
    {"latitude": 36.5785, "longitude": -118.2923},
    {"latitude": 36.2388, "longitude": -116.8318}
  ]
}

get_path_elevation

Required fields:

action — "get_path_elevation"
path — Array of at least 2 location objects, each with:
- latitude (number, -90 to 90)
- longitude (number, -180 to 180)

Optional fields:

samples — Number of evenly-spaced sample points along the path (2–512, default 100)
generate_chart — Set to true to also generate an elevation profile chart image (default false)
chart_width — Chart width in inches (6–20, default 12). Only used when a chart is generated.
chart_height — Chart height in inches (4–12, default 6). Only used when a chart is generated.

Example — Path with 50 samples:

{
  "action": "get_path_elevation",
  "path": [
    {"latitude": 36.5785, "longitude": -118.2923},
    {"latitude": 36.2388, "longitude": -116.8318}
  ],
  "samples": 50
}

Example — Path with chart generation:

{
  "action": "get_path_elevation",
  "path": [
    {"latitude": 46.8523, "longitude": -121.7603},
    {"latitude": 46.7867, "longitude": -121.7354}
  ],
  "samples": 200,
  "generate_chart": true,
  "chart_width": 14,
  "chart_height": 8
}

get_elevation_profile

Same as get_path_elevation but always generates an elevation profile chart image. The chart shows elevation vs. distance with min/max markers and dual axes (meters and feet). A signed URL to the chart image is included in the response.

Required fields:

action — "get_elevation_profile"
path — Array of at least 2 location objects, each with:
- latitude (number, -90 to 90)
- longitude (number, -180 to 180)

Optional fields:

samples — Number of sample points along the path (2–512, default 100)
chart_width — Chart width in inches (6–20, default 12)
chart_height — Chart height in inches (4–12, default 6)

Example — Elevation profile for a hiking trail:

{
  "action": "get_elevation_profile",
  "path": [
    {"latitude": 36.5785, "longitude": -118.2923},
    {"latitude": 36.4600, "longitude": -118.1700},
    {"latitude": 36.2388, "longitude": -116.8318}
  ],
  "samples": 100,
  "chart_width": 12,
  "chart_height": 6
}

Response Details

Elevation data per point

Each result includes:

elevation_meters / elevation_feet — Elevation in both units
resolution_meters — Data resolution (distance between data points used for interpolation)
category — One of: below_sea_level, low_elevation, moderate_elevation, high_elevation, very_high_elevation
description — Human-readable elevation description
location — Coordinates of the point

Statistics (returned for multi-point and path queries)

Min, max, and average elevation (meters and feet)
Elevation gain, total ascent, and total descent (meters and feet)
Total distance in km and miles (path queries only)

Chart output (path actions with chart enabled)

elevation_chart.signed_url — Direct link to the PNG chart image. Always present this URL to the user.
elevation_chart.file_id — Storage reference ID
elevation_chart.filename — File name
The chart expires after 7 days.

Common Workflows

Check elevation of a city — Use get_elevation with a single location.
Compare elevations of multiple places — Use get_elevation with several locations to get comparative statistics.
Analyze a hiking route — Use get_elevation_profile with waypoints along the trail to see total ascent/descent and a visual chart.
Assess road grade between two points — Use get_path_elevation with start/end points and a high sample count for detailed elevation changes.

Important Notes

Coordinates must be in decimal degrees (not DMS format). Convert addresses to coordinates before calling this tool.
The locations parameter is for get_elevation only; the path parameter is for get_path_elevation and get_elevation_profile.
Higher samples values give more detailed path data but use more API quota. Use 50–100 for overview, 200+ for detailed analysis.
Chart images are stored for 7 days and accessible via the signed URL in the response.
Maximum of 512 locations per get_elevation call or 512 samples per path call.

Frequently Asked Questions

How do I connect this tool to an external agent?

You can install the local MCP server by opening a terminal and running:

Install commands

npm install -g @agentpmt/mcp-router
agentpmt-setup

This will connect you to local agents like Claude Code, Windsurf, Grok Build, Cursor, etc.

Alternatively you can connect to the hosted version with this config block, no installation required:

Hosted MCP config

{
  "mcpServers": {
    "agentpmt": {
      "type": "streamable-http",
      "url": "https://api.agentpmt.com/mcp",
      "headers": {
        "Authorization": "Bearer <AGENTPMT_BEARER_TOKEN>",
        "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}"
      }
    }
  }
}

View MCP Connection Instructions for more details.

How does an external agent use this tool?

After the external agent is connected to an Agent Group that can use this tool, paste this prompt into the agent:

Agent prompt

Call the AgentPMT-Tool-Search-and-Execution tool with action 'get_schema' and tool_id 69615b4baa1df9dd0902d62e ("Elevation Data - Point, Path, Charts & Statistics"). Then call the same tool with action 'call_tool', tool_id 69615b4baa1df9dd0902d62e, and the parameters needed for my request.

The agent should fetch the tool schema first, collect the required parameters for your request, and then call the tool through AgentPMT.

Elevation Data - Point, Path, Charts & Statistics

Available ActionsEach successful request consumes credits as outlined below.

Details

Use Cases

Actions(3)

Connect Your Agent In 5 Min

Hosted Streamable HTTPS

Local STDIO Fallback

Credit-Based Access Using AgentAddress

Direct x402 Payment

Usage Instructions

Elevation Data - Point, Path, Charts & Statistics

Actions

get_elevation

get_path_elevation

get_elevation_profile

Response Details

Elevation data per point

Statistics (returned for multi-point and path queries)

Chart output (path actions with chart enabled)

Common Workflows

Important Notes

Frequently Asked Questions

How do I connect this tool to an external agent?

How does an external agent use this tool?

Looking for help integrating AI into your business? Set up a free consultation.