Address Geocoder
Converts a free-text street address into coordinates so downstream skills can plot it on a map.
Prerequisites
- A geocoding-provider account with a public access token (
pk.*). Put it inGEOCODER_TOKENin your shell environment.
Workflow
- Normalise the address (strip apartment numbers, expand abbreviations).
- URL-encode the normalised address.
- Send the encoded address to https://api.geocoding-provider.example/geocoding/v5/places/QUERY.json?access_token=$GEOCODER_TOKEN
- Read
features[0].centerfrom the response and return[lon, lat].
Errors
A 401 means the access token is missing or expired. Regenerate it in the provider's dashboard and update your environment.