Elevation Data - Point, Path, Charts & Statistics

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

Connect Your Agent In 5 Min

Watch the setup guide for your platform

Or Install Locally

STDIO connector for Claude Code, Codex, Cursor, Zed, and other LLMs that require STDIO or custom connections. This lightweight connector routes requests to https://api.agentpmt.com/mcp. All tool execution happens in the cloud and the server cannot edit any files on your computer.

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.

This tool supports credit-based access for external agents using AgentAddress identities or standard crypto wallets. External agents should use the External Agent API to buy credits with x402 and invoke this tool.

1. Buy Credits

Purchase credits via x402 payment (500 credit minimum, 100 credits = $1).

# Request payment requirements (returns 402 + PAYMENT-REQUIRED header)
curl -i -s -X POST "https://www.agentpmt.com/api/external/credits/purchase" \
  -H "Content-Type: application/json" \
  -d '{ "wallet_address":"0xYOUR_WALLET", "credits": 500, "payment_method":"x402" }'

# Sign the EIP-3009 authorization, then retry with signature header
curl -s -X POST "https://www.agentpmt.com/api/external/credits/purchase" \
  -H "Content-Type: application/json" \
  -H "PAYMENT-SIGNATURE: <base64-json>" \
  -d '{ "wallet_address":"0xYOUR_WALLET", "credits": 500, "payment_method":"x402" }'

2. Create a Session Nonce (nonce used in signed balance/invoke)

curl -s -X POST "https://www.agentpmt.com/api/external/auth/session" \
  -H "Content-Type: application/json" \
  -d '{ "wallet_address":"0xYOUR_WALLET" }'

3. Invoke This Tool

Sign the message with your wallet (EIP-191 personal-sign), then POST to the invoke endpoint.

# Sign this message (wallet MUST be lowercased):
# agentpmt-external
# wallet:0xyourwallet...
# session:<session_nonce>
# request:<request_id>
# action:invoke
# product:69615b4baa1df9dd0902d62e
# payload:<sha256(canonical_json(parameters))>

curl -s -X POST "https://www.agentpmt.com/api/external/tools/69615b4baa1df9dd0902d62e/invoke" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_address": "0xYOUR_WALLET",
    "session_nonce": "<session_nonce>",
    "request_id": "invoke-uuid",
    "signature": "0x<signature>",
    "parameters": {
      "action": "your_action",
      "your_param": "value"
    }
  }'

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

Usage Instructions

Usage guidance provided directly by the developer for this product.

Elevation Data - Point, Path, Charts & Statistics

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

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.

About The Developer

Apoth3osis

★15 stars

Joined Agent Payment: August 14, 2025

We build tools that enable AI agents to excel in the mathematical realm.

Our small team develops experimental and unique solutions in the AI arena, with a strong focus on modular computing for agentic applications and custom model deployment. We have handled projects for a variety of applications across many sectors, from algorithmic trading and financial analysis, to molecular simulations and predictions, to habitat and biodiversity monitoring and wildlife conservation.

Elevation Data - Point, Path, Charts & Statistics

Description