geocode_address
Forward-geocode an address to coordinates (lat/lng) with an explicit accuracy_type — you always know what you got.
accuracy_type is an OPEN set; new tiers are added as reference data
improves. Do NOT write code that treats an unrecognised value as a failure.
Branch on the boolean `point_coordinate` instead, which is true when the
coordinate identifies one address. Current values: rooftop and
arrival_point (both point coordinates — a point on the building, or the
property's entrance / access point), then street_interpolated,
street_centroid, postcode_centroid, locality_centroid, admin_centroid.
House-number-level matches may ALSO carry `arrival_point: {lat, lng}` —
the premise's entrance/access coordinate beside the served pin (equal to
lat/lng when accuracy_type is arrival_point). Use it for delivery and
navigation; omitted when not on file.
`country` is ISO-3 lowercase. Give fielded parts or a single line in `q`.
For UK (gbr) addresses use validate_address instead — it returns point
coordinates from Royal Mail PAF.
A geocode result is a coordinate, not a verdict: it carries no `status`
and no partial_match. accuracy_type says only where the pin is; to tell
the user whether the address itself is valid, use validate_address.
Cost: 1 credit per successful geocode; failures are refunded. A result
whose only location is the state or province (admin_centroid) is not
charged and carries charged: false.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": {
"country": "<country>"
},
"name": "geocode_address"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | ||
| city | No | ||
| state | No | ||
| street | No | ||
| country | Yes | ||
| postcode | No | ||
| house_number | No |