Resolve an address
POST/api/address/resolve
Turns one of three inputs into a structured address and coordinates: lat+lng (reverse geocode), url (Google Maps link), or address (free text). When several are sent, the first present in that order wins.
Free text runs a cascade and returns the first step that matches: Google Geocoding (≥ 0.68), Google Places (0.75), Geocoding on the administrative parts only (≥ 0.68), postal-code centroid (0.55), province centroid (0.32). Always check confidence and source before using the coordinates — a centroid can be far from the real address.
Requires authentication (signature or session) but no plan feature or user permission. Error messages are fixed English strings, not localized.
Request
Responses
- 200
- 400
- 401
- 404
- 500
The resolved address.
Body is not JSON; lat/lng out of range; url is not a Google Maps link (https google.
No valid signature or session. Body is { "error": "Unauthorized" }.
Not resolved: no coordinates in the link, Google has no result for the point, or every cascade step missed (low-confidence Google matches are discarded, not returned).
Geocoder misconfigured or Google unreachable. The error is not caught by the route, so the body is not the JSON error shape.