Point Elevation
get_point_elevationPurpose: read one contextual elevation worldwide from Copernicus GLO-30 surface data, or an operator-configured Open Topo Data-compatible service. When to use: when a user asks about elevation at a known worldwide point. Returns: finite point elevation in metres, provider-declared dataset, nominal grid spacing, expected EGM96 vertical datum, retrieval time and explicit limitations. Limitations: Copernicus includes buildings and vegetation and uses EGM2008 heights. A configured service retains its own expected datum; no public test-service default or Mapbox RGB guessing. ASTER and SRTM have different latitude/void coverage. Provider deployment/version, local accuracy, licence and datum are unverified. One point does not establish slope, contours, drainage, flood risk, wind exposure, measured site levels or 3D terrain. Parameter guidance: supply country-aware address, resolved site_ref or coordinates {lat,lng} with explicit country_code. Non-UK address lookup also requires the configured geocoder. Missing, invalid or out-of-range source data returns an explicit error, never zero elevation or low risk. Chaining: every response returns site_ref; pass it unchanged into another Atlasly tool to reuse the canonical site, coordinates, boundary confidence, LPA, evidence links, and project context.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_point_elevation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| address | No | Site address or postcode, with town and country outside the UK. Alternatively pass site_ref from an earlier result; do not send both for different locations. | |
| site_ref | No | Canonical site_ref returned by any previous Atlasly tool. Pass it unchanged to chain the same resolved site into this call; address, search_area, or project_id will be filled from it when omitted. | |
| coordinates | No | User-supplied WGS84 point {lat, lng}. Send with country_code. The point is not reverse-geocoded, so its address and planning jurisdiction stay unverified. | |
| country_code | No | ISO two-letter country code such as gb, us, in or fr. Required with coordinates and for addresses outside the UK. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | ||
| status | Yes | ||
| details | No | ||
| message | No | ||
| sources | Yes | ||
| headline | Yes | ||
| site_ref | Yes | ||
| retryable | No | ||
| error_code | No | ||
| atlasly_link | Yes | ||
| error_source | No | ||
| human_message | No | ||
| key_data_points | Yes | ||
| top_constraints | Yes | ||
| confidence_notes | Yes | ||
| executive_summary | Yes | ||
| next_best_actions | Yes | ||
| top_opportunities | Yes |