Get Elevation Grid
elevation_get_gridRead-onlyIdempotent
Sample a regular grid of terrain elevations across a bounding box and report the highest and lowest sampled points, the mean elevation, and the relief, plus the full elevation matrix with each cell's dataset. Values are point samples at grid nodes (box edges included), not cell averages, so a summit between nodes is missed; to refine a candidate high or low point, call again with a smaller box around it. Over open water, Mapzen cells are sea-floor depths. Rows times columns may not exceed 250.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"south": "<south>",
"west": "<west>",
"north": "<north>",
"east": "<east>"
},
"name": "elevation_get_grid"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cols | No | Grid columns, west to east, edges included (2–25, default 10). rows × cols must be at most 250. | |
| east | Yes | Eastern edge longitude, decimal degrees. | |
| rows | No | Grid rows, north to south, edges included (2–25, default 10). rows × cols must be at most 250. | |
| west | Yes | Western edge longitude, decimal degrees. Must be less than east; a box crossing longitude 180 must be split into two calls. | |
| north | Yes | Northern edge latitude, decimal degrees. Must be greater than south. | |
| south | Yes | Southern edge latitude, decimal degrees. | |
| source | No | Elevation source: auto (default) uses USGS 3DEP where it has data and Open Topo Data (SRTM, with Mapzen terrain tiles where SRTM has no data) for the rest; usgs_3dep uses 3DEP only; opentopodata uses Open Topo Data only. Case is ignored and spaces or hyphens read as underscores, so USGS-3DEP and open topo data are accepted; 3dep, usgs, and epqs are also aliases for usgs_3dep. | auto |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cols | No | Node columns applied. | |
| east | No | Eastern edge longitude, as requested. | |
| rows | No | Node rows applied. | |
| west | No | Western edge longitude, as requested. | |
| error | No | Present when the call failed. Absent on success. | |
| north | No | Northern edge latitude, as requested. | |
| south | No | Southern edge latitude, as requested. | |
| notice | No | Guidance on nodes without data, boxes spanning the USGS 3DEP coverage edge, Mapzen sea-floor values, and node spacing against the source resolution. | |
| summary | No | Statistics over the nodes with data. | |
| attribution | No | Sources to credit for the returned values, one line per dataset that answered. | |
| source_mode | No | The source the call used (auto unless the caller chose one). | |
| elevations_m | No | Elevation matrix indexed [row][col], rows north to south, columns west to east. | |
| cell_datasets | No | Provenance matrix with the same [row][col] indexing as elevations_m. | |
| col_spacing_m | No | East-west distance between node columns at the box's center latitude, meters. | |
| datasets_used | No | Number of values each dataset answered. | |
| latitudes_deg | No | Latitude of each row, north to south; row 0 is the north edge. | |
| missing_cells | No | Nodes no queried dataset answered. | |
| row_spacing_m | No | North-south distance between node rows, meters. | |
| longitudes_deg | No | Longitude of each column, west to east; column 0 is the west edge. | |
| cells_with_data | No | Nodes with an elevation. | |
| resolution_m_range | No | Range of source resolutions over values that report one; absent when none does (all Mapzen). | |
| vertical_reference | No | Height-reference context per answering dataset, including unverified references and whether heights share a datum. No vertical datum conversion is performed. |