Ground a location
ground_locationRead-onlyIdempotent
Get location grounding in one call: reverse-geocoded address, surrounding categories, reachable-area stats, and nearby notable places from lat/lon or a place name.
Instructions
One-hop location grounding: where, surroundings, reach, notable.
Answers "orient me at this point" in a single call instead of chaining
a reverse lookup, an area summary, a reachable-area scan, and a
nearby-places search. Give the point as lat/lon, or as `where` — a
{"lat", "lon"} dict, a GERS id, or a free-text place name — but not
both (and not neither); either way returns {"error": "bad_request"}
naming the choice. A `where` given as an id/name adds a compact
"resolved": {"name", "id", "lat", "lon", "matched_by"} to the answer
(a separate key from the answer's own "where" section below); absent
for lat/lon or a {lat,lon} where. Returns:
- where: reverse_geocode's answer for the point (address/divisions
chain, or a "divisions_only" degrade).
- surroundings: total places and the top few categories within a fixed
500m radius, plus density_per_km2.
- reach: reachable-area stats only for (minutes, mode) —
{reachable_nodes, max_radius_m, area_km2}. Never includes the
reachable-area polygon; this tool returns no geometry, ever.
- notable: the nearest 2-3 named places, no category filter.
Each section is independent: if its underlying call fails or comes
back empty, that section is dropped and a short line explaining why is
added to "notes" instead — the call only fails outright if every
section failed, returning a structured {"error":
"upstream_unavailable", ...}.
minutes must be > 0 and <= 60; omit mode to use the stored
preferences mode, else walk.
Both, plus out-of-range coordinates, return {"error": "bad_request"}.
No confirm gate: the reach scan runs with the requested minutes/mode
as-is (it self-caps its graph extraction radius; no nearby street
graph just degrades the reach section to a note).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | ||
| lon | No | ||
| mode | No | Travel mode. Default: stored preference, else walk. | |
| where | No | ||
| minutes | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||