Skills/Maps/Coordinates to address

Coordinates to address

~1 credits / lookup (up to 2)

Takes a latitude and longitude and returns the nearest address, along with the surrounding place hierarchy: street, city, region, and country. You can request a coarser level (just the city or postcode) when you do not need a full street address.

Use when

You have a latitude and longitude and want the address, or which city or region it falls in.

Not for

Resolving a place name to coordinates (use the address-to-coordinates path).

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.

latituderequired

Latitude in decimal degrees (-90 to 90).

longituderequired

Longitude in decimal degrees (-180 to 180).

leveloptional

How coarse the result should be. Options include street, city, postcode, state, or country. Defaults to the nearest building address.

What you get back

The nearest address at the requested level of detail, plus the full place hierarchy from street up to country.

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":"reverse_geocode","latitude":48.8584,"longitude":2.2945,"level":"city"}}'

Example requests

  • What address is at 48.8584, 2.2945?
  • Which city is at latitude 51.5, longitude -0.12?
  • What's the postcode for coordinates 40.7128, -74.0060?