# Elevation Data - Point, Path, Charts & Statistics ## Links - Product page URL: https://www.agentpmt.com/marketplace/elevation-data-point-path-charts-statistics - Product markdown URL: https://www.agentpmt.com/marketplace/elevation-data-point-path-charts-statistics?format=agent-md - Product JSON URL: https://www.agentpmt.com/marketplace/elevation-data-point-path-charts-statistics?format=agent-json ## Overview - Product ID: 69615b4baa1df9dd0902d62e - Vendor: Apoth3osis - Type: data - Unit type: request - Price: 1000 credits - Categories: Data Science, Mapping & Visualization, Geocoding & Location Services, Spatial Analysis - Generated at: 2026-05-30T20:19:39.013Z ### Page Description 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. ### Agent Description Get elevation data for points or paths. Returns stats (min, max, avg, gain, descent), optional profile charts. Up to 512 points. ## Details ### 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. ### Actions - `get_elevation` (10 credits): 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. - `get_path_elevation` (10 credits): 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. - `get_elevation_profile` (10 credits): 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. ### 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 ### Workflows Using This Tool No public workflows currently reference this product. ### Related Content No related content is currently linked to this product. ## Integration Details ### DynamicMCP - Setup page URL: https://www.agentpmt.com/dynamic-mcp - Claude setup guide: https://www.agentpmt.com/dynamic-mcp?platform=claude#videos - ChatGPT setup guide: https://www.agentpmt.com/dynamic-mcp?platform=chatgpt#videos - Cursor setup guide: https://www.agentpmt.com/dynamic-mcp?platform=cursor#videos - Windsurf setup guide: https://www.agentpmt.com/dynamic-mcp?platform=windsurf#videos Use the local router for command-based MCP clients. It forwards requests to `https://api.agentpmt.com/mcp` and does not execute tools locally. ```bash npm install -g @agentpmt/mcp-router agentpmt-setup ``` ### REST API The live page renders cURL, Python, JavaScript, and Node.js examples. Logged-in users see those examples prefilled with their own API and budget credentials. - Purchase endpoint: https://api.agentpmt.com/products/purchase - Authorization format: `Bearer ` ```bash curl -X POST "https://api.agentpmt.com/products/purchase" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer eW91ci1hcGkta2V5LWhlcmU6eW91ci1idWRnZXQta2V5LWhlcmU=" \ -d '{ "product_id": "69615b4baa1df9dd0902d62e", "parameters": { "action": "get_elevation", "locations": [] } }' ``` ### Autonomous Agents Autonomous agents can access this tool through AgentAddress credit balances or direct x402 payments. Use the Autonomous Agent API reference for endpoint shapes after choosing the access pattern below. - Autonomous Agent API reference URL: https://www.agentpmt.com/docs/api-reference/autonomous-agents - Autonomous Agent API reference markdown URL: https://www.agentpmt.com/docs/api-reference/autonomous-agents?format=agent-md - Credit-Based Access Using AgentAddress: https://www.agentpmt.com/docs/autonomous-agents/credit-based-tool-usage-with-agentaddress - AgentAddress is preferred for persistent file access, stored platform state, and maximum tool use ability across repeated calls. - Direct x402 is for independent one-off tool calls that do not require shared files or stored platform state. - Direct x402 public payments: USDC on Base, Arbitrum, Optimism, Polygon, and Avalanche. ### Schema #### Parameters - Schema type: actions ```json { "actions": { "get_elevation": { "description": "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.", "properties": { "locations": { "type": "array", "description": "List of locations for discrete elevation lookup (max 512). Each location must have latitude and longitude fields.", "required": true, "maxItems": 512, "items": { "type": "object", "properties": { "latitude": { "type": "number", "description": "Latitude in decimal degrees (-90 to 90)", "required": true }, "longitude": { "type": "number", "description": "Longitude in decimal degrees (-180 to 180)", "required": true } } } } } }, "get_path_elevation": { "description": "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.", "properties": { "path": { "type": "array", "description": "List of locations defining a path (minimum 2 points). Each point must have latitude and longitude fields.", "required": true, "minItems": 2, "items": { "type": "object", "properties": { "latitude": { "type": "number", "description": "Latitude in decimal degrees (-90 to 90)", "required": true }, "longitude": { "type": "number", "description": "Longitude in decimal degrees (-180 to 180)", "required": true } } } }, "samples": { "type": "integer", "description": "Number of evenly-spaced sample points along the path (2-512)", "required": false, "default": 100, "minimum": 2, "maximum": 512 }, "generate_chart": { "type": "boolean", "description": "Set to true to also generate an elevation profile chart image (default false)", "required": false, "default": false }, "chart_width": { "type": "integer", "description": "Chart width in inches (6-20). Only used when a chart is generated.", "required": false, "default": 12, "minimum": 6, "maximum": 20 }, "chart_height": { "type": "integer", "description": "Chart height in inches (4-12). Only used when a chart is generated.", "required": false, "default": 6, "minimum": 4, "maximum": 12 } } }, "get_elevation_profile": { "description": "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.", "properties": { "path": { "type": "array", "description": "List of locations defining a path (minimum 2 points). Each point must have latitude and longitude fields.", "required": true, "minItems": 2, "items": { "type": "object", "properties": { "latitude": { "type": "number", "description": "Latitude in decimal degrees (-90 to 90)", "required": true }, "longitude": { "type": "number", "description": "Longitude in decimal degrees (-180 to 180)", "required": true } } } }, "samples": { "type": "integer", "description": "Number of evenly-spaced sample points along the path (2-512)", "required": false, "default": 100, "minimum": 2, "maximum": 512 }, "chart_width": { "type": "integer", "description": "Chart width in inches (6-20)", "required": false, "default": 12, "minimum": 6, "maximum": 20 }, "chart_height": { "type": "integer", "description": "Chart height in inches (4-12)", "required": false, "default": 6, "minimum": 4, "maximum": 12 } } } }, "properties": { "action": { "type": "string", "description": "Action to perform. Use 'get_instructions' to get documentation", "required": false, "default": "get_elevation", "enum": [ "get_instructions", "get_elevation", "get_path_elevation", "get_elevation_profile" ] }, "chart_height": { "type": "integer", "description": "Chart height in inches (4-12)", "required": false, "default": 6, "minimum": 4, "maximum": 12 }, "chart_width": { "type": "integer", "description": "Chart width in inches (6-20)", "required": false, "default": 12, "minimum": 6, "maximum": 20 }, "generate_chart": { "type": "boolean", "description": "Generate an elevation profile chart (for path elevation actions)", "required": false }, "locations": { "type": "array", "description": "List of locations for discrete elevation lookup (max 512). Each location must have 'latitude' and 'longitude' fields", "required": false, "items": { "properties": { "latitude": { "description": "Latitude in decimal degrees (-90 to 90)", "type": "number" }, "longitude": { "description": "Longitude in decimal degrees (-180 to 180)", "type": "number" } }, "type": "object" }, "maxItems": 512 }, "path": { "type": "array", "description": "List of locations defining a path (minimum 2 points). Each point must have 'latitude' and 'longitude' fields", "required": false, "items": { "properties": { "latitude": { "description": "Latitude in decimal degrees (-90 to 90)", "type": "number" }, "longitude": { "description": "Longitude in decimal degrees (-180 to 180)", "type": "number" } }, "type": "object" }, "minItems": 2 }, "samples": { "type": "integer", "description": "Number of samples to take along the path (2-512)", "required": false, "default": 100, "minimum": 2, "maximum": 512 } } } ``` ### Usage Instructions # 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:** ```json { "action": "get_elevation", "locations": [ {"latitude": 27.9881, "longitude": 86.9250} ] } ``` **Example — Multiple points with statistics:** ```json { "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 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. **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:** ```json { "action": "get_path_elevation", "path": [ {"latitude": 36.5785, "longitude": -118.2923}, {"latitude": 36.2388, "longitude": -116.8318} ], "samples": 50 } ``` **Example — Path with chart generation:** ```json { "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:** ```json { "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 1. **Check elevation of a city** — Use `get_elevation` with a single location. 2. **Compare elevations of multiple places** — Use `get_elevation` with several locations to get comparative statistics. 3. **Analyze a hiking route** — Use `get_elevation_profile` with waypoints along the trail to see total ascent/descent and a visual chart. 4. **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? - Page URL: https://www.agentpmt.com/faq - Markdown URL: https://www.agentpmt.com/faq?format=agent-md You can install the local MCP server by opening a terminal and running: ``` 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: ``` { "mcpServers": { "agentpmt": { "type": "streamable-http", "url": "https://api.agentpmt.com/mcp", "headers": { "Authorization": "Bearer ", "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}" } } } } ``` [View MCP Connection Instructions](/docs/mcp-reference/connection) for more details. #### How does an external agent use this tool? - Page URL: https://www.agentpmt.com/faq - Markdown URL: https://www.agentpmt.com/faq?format=agent-md After the external agent is connected to an Agent Group that can use this tool, paste this prompt into the agent: > 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. ### Dependencies This product has no public dependency products.