# 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-04-15T18:27:44.555Z

### 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 Tab

### 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.

## Advanced Tab

### 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

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.

```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 <base64(apiKey:budgetKey)>`

```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

Do not use the abbreviated instructions in this product markdown for wallet-based invocation. Retrieve the full External Agent API markdown document instead.

- External Agent API page URL: https://www.agentpmt.com/external-agent-api
- External Agent API markdown URL: https://www.agentpmt.com/external-agent-api?format=agent-md

### 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.

### About The Developer

- Vendor name: Apoth3osis
- Website: apoth3osis.io

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.

### Frequently Asked Questions

No linked FAQs are currently available.

### Dependencies

This product has no public dependency products.