Reverse Geocode

Convert geographic coordinates to a human-readable address.

POST /api/v1/{customer_uuid}/reverse/

Request Body

Field	Type	Required	Description
lat	float	Yes	Latitude (-90 to 90)
lng	float	Yes	Longitude (-180 to 180)
radius	integer	No	Search radius in meters (max 10,000)
language	string	No	BCP47 language code (e.g., en-US, es-CL)

Example Request

curl -X POST https://geocoder.amigocloud.com/api/v1/{uuid}/reverse/ \
  -H "X-API-Key: your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "lat": -33.4175,
    "lng": -70.6065,
    "language": "es-CL"
  }'

Example Response

{
  "results": [
    {
      "label": "Av. Andrés Bello 2425, Providencia, Región Metropolitana, Chile",
      "position": { "lat": -33.4175, "lng": -70.6065 },
      "address": {
        "house_number": "2425",
        "street": "Av. Andrés Bello",
        "neighborhood": "Providencia",
        "city": "Santiago",
        "county": null,
        "state": "Región Metropolitana",
        "state_code": "RM",
        "postal_code": null,
        "country": "Chile",
        "country_code": "CHL"
      },
      "result_type": "house_number",
      "provider_id": "locationiq:node:987654321",
      "relevance": null,
      "distance": null,
      "bounding_box": null
    }
  ],
  "provider": "locationiq",
  "cached": false
}

Caching

Results are cached for 5 minutes. Cached responses include "cached": true.