Address to coordinates
~1 credits / lookup (up to 2)Converts a free-text address, postcode, or place name into latitude and longitude, returning a ranked list of matching candidates with confidence scores. Handles ambiguous names by surfacing multiple matches so you can pick the right one, and applies country or region context to narrow results when the caller implies a location.
Use when
You have a free-text address or place name and need its coordinates or structured components.
Not for
Labeling a coordinate you already have (use the reverse path), or validating mail deliverability.
Cost
~1 credits / lookup (up to 2)
Estimated; the actual charge depends on your input and is shown in the response.
What it accepts
Set these inside the intent when you run it.
The address, postcode, or place name to resolve to coordinates.
Country or region to restrict or bias results, e.g. "United Kingdom". Helps with ambiguous names.
What you get back
Ranked candidate locations, each with latitude, longitude, formatted address, confidence score, and place type.
Run it
Run this sub-skill directly: pin it with operation and pass its inputs in the intent. (Omit operation and the Maps skill will route from your intent instead.)
curl -X POST "https://skill.askfaro.com/skills/maps/run" \
-H "Authorization: Bearer $FARO_TOKEN" \
-H "Content-Type: application/json" \
-d '{"intent":{"operation":"geocode","location":"10 Downing Street, London","country":"France"}}'Example requests
- ›What are the coordinates of 221B Baker Street, London?
- ›Find the location of the Louvre museum
- ›Geocode "Central Park, New York"