For Agents
Look up high-resolution elevation worldwide for single or many points, sample elevation along a path, or pull a 2D raster extract. Includes Google Maps Elevation and Open Topo Data drop-in compatibility.
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the GPXZ Elevation API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with GPXZ Elevation API.
Look up elevation for a single coordinate via GET /elevation/point
Batch elevation lookups for many coordinates with GET or POST /elevation/points
Sample elevation along a polyline path via /elevation/sample
Export a 2D high-resolution elevation raster through /elevation/hires-raster
GET STARTED
Use for: Get the elevation for a latitude and longitude pair, Look up elevation for 500 coordinates in one batch request, Sample elevation along a hiking trail polyline, Retrieve a 2D elevation raster for a bounding box
Not supported: Does not handle geocoding, routing, or weather data — use for elevation lookups and elevation rasters only.
Jentic publishes the only available OpenAPI specification for GPXZ Elevation API, keeping it validated and agent-ready. GPXZ is a worldwide elevation lookup service that returns high-resolution terrain data for single points, batches of points, sampled paths, and 2D raster extracts. It also exposes drop-in compatibility endpoints for Google Maps Elevation API and Open Topo Data, making migration from those services a header-and-host swap. The 11-endpoint surface covers point lookups, path sampling, raster export, source metadata, and a health probe.
Drop-in replace Google Maps Elevation API via /elevation/gmaps-compat/{outputFormat}
Drop-in replace Open Topo Data API via /elevation/otd-compat
Inspect available elevation source datasets with /elevation/sources
Patterns agents use GPXZ Elevation API for, with concrete tasks.
★ Outdoor Route Profile Generation
Hiking, cycling, and running apps build elevation profiles by sending a polyline to /elevation/sample and rendering the returned series as a chart. The endpoint accepts the path geometry and a sample count, returning evenly-spaced elevations across the route. Coverage and resolution depend on the underlying source dataset, which can be inspected via /elevation/sources.
POST /elevation/sample with a 50-point GeoJSON LineString and samples=200, then return the elevation series for chart rendering.
Drop-In Migration from Google Maps Elevation
Teams hitting Google Maps Elevation API quotas migrate to GPXZ via /elevation/gmaps-compat/{outputFormat}, which mirrors Google's request and response shapes. The agent only needs to swap the host and supply the GPXZ x-api-key — query parameters and JSON shape stay the same, so application code does not change. The compatibility endpoint is bound by GPXZ's source coverage rather than Google's.
Repoint application traffic from maps.googleapis.com/maps/api/elevation/json to https://api.gpxz.io/v1/elevation/gmaps-compat/json with x-api-key header and verify response equivalence.
Bulk Elevation for Geospatial Pipelines
Geospatial pipelines processing thousands of points use POST /elevation/points to avoid per-point HTTP overhead. The endpoint accepts an array of coordinates and returns elevations in matching order, making it the high-throughput entry point for terrain enrichment in ETL jobs. Single-point /elevation/point exists for low-volume interactive workflows.
POST /elevation/points with 1000 lat/lng pairs from a CSV and merge the elevation array back into the source rows.
2D Raster Export for Local Modelling
Hydrology, viewshed, and slope analyses need a 2D raster patch rather than point samples. GET /elevation/hires-raster returns a high-resolution elevation grid for a bounding box, ready to load into rasterio, GDAL, or QGIS. Resolution and format are bounded by what the underlying sources expose for the requested area.
GET /elevation/hires-raster with a bounding box for a watershed and load the response into rasterio for slope computation.
Agent-Driven Elevation Lookup via Jentic
An AI assistant answering 'how high is Ben Nevis?' uses Jentic to discover GPXZ, load /elevation/point, and execute with the user-supplied coordinates. The x-api-key sits in MAXsystem so the agent never handles the raw secret, and the agent reasons over the elevation value to compose a natural-language answer.
Use the Jentic SDK to search 'get elevation for a coordinate', load GET /elevation/point, and execute with lat=56.7969 lng=-5.0036 to return Ben Nevis's elevation.
11 endpoints — jentic publishes the only available openapi specification for gpxz elevation api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/elevation/point
Get elevation for a single point
/elevation/points
Batch elevation lookup for many points
/elevation/sample
Sample elevation along a path
/elevation/hires-raster
Export a 2D elevation raster for a bounding box
/elevation/gmaps-compat/{outputFormat}
Google Maps Elevation API drop-in compatibility
/elevation/otd-compat
Open Topo Data API drop-in compatibility
/elevation/sources
List elevation source datasets and coverage
/elevation/point
Get elevation for a single point
/elevation/points
Batch elevation lookup for many points
/elevation/sample
Sample elevation along a path
/elevation/hires-raster
Export a 2D elevation raster for a bounding box
/elevation/gmaps-compat/{outputFormat}
Google Maps Elevation API drop-in compatibility
Three things that make agents converge on Jentic-routed access.
Credential isolation
GPXZ's x-api-key is held in Jentic's MAXsystem vault. The header is injected at execution time, so the raw key never lands in agent prompts, tool calls, or transcripts. The query-parameter form (api-key) is supported but Jentic defaults to the header for safety.
Intent-based discovery
Agents search Jentic with intents like 'get elevation for a coordinate' or 'sample elevation along a path' and Jentic returns the matching GPXZ endpoint with its parameter schema, so the agent picks point versus sample versus raster automatically.
Time to first call
Direct integration: half a day to wire auth, batch payload shaping, and parse the per-endpoint response branches. Through Jentic: under 30 minutes — search, load, execute.
Alternatives and complements available in the Jentic catalogue.
Positionstack
Forward and reverse geocoding API for resolving addresses before elevation lookups
Choose Positionstack when geocoding cost matters and the workflow only needs lat/lng before calling GPXZ for elevation.
Specific to using GPXZ Elevation API through Jentic.
Why is there no official OpenAPI spec for GPXZ Elevation API?
GPXZ does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call GPXZ Elevation API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up .
What authentication does the GPXZ Elevation API use?
GPXZ supports two equivalent schemes — an x-api-key header (apiKeyHeader) and an api-key query parameter (apiKeyQuery). Prefer the header for production. Through Jentic, the key is stored in MAXsystem and injected at execution time so the agent never sees it.
Can I migrate from Google Maps Elevation without rewriting my code?
Yes. /elevation/gmaps-compat/{outputFormat} mirrors Google Maps Elevation API's request and response shapes. Swap the host to api.gpxz.io and add the x-api-key header — request parameters and JSON output are unchanged. Note that source coverage and resolution come from GPXZ's datasets, not Google's.
What are the rate limits for the GPXZ Elevation API?
The OpenAPI spec does not declare specific limits. Limits are tied to your plan tier in the GPXZ dashboard, with free, hobby, and commercial tiers offering different per-second and per-month quotas. Use POST /elevation/points to batch lookups and reduce per-request overhead.
How do I sample elevation along a route through Jentic?
Search Jentic for 'sample elevation along a path', load POST /elevation/sample, and execute with the polyline geometry and a samples count. The Jentic SDK returns the elevation series array directly, ready to plot.
Does GPXZ cover the entire world?
Yes — GPXZ provides worldwide coverage by stitching multiple elevation source datasets. Resolution varies by region: high-resolution lidar and survey data is available for some countries while remote areas fall back to global SRTM-style sources. Call /elevation/sources to inspect what's available for a given bounding box.
/elevation/otd-compat
Open Topo Data API drop-in compatibility
/elevation/sources
List elevation source datasets and coverage