Geocodificacion

Convierte una cadena de direccion en coordenadas geograficas.

POST /api/v1/{customer_uuid}/geocode/

Cuerpo de la Solicitud

Campo	Tipo	Requerido	Descripcion
address	string	Si	La direccion a geocodificar
country	string	No	Codigo de pais ISO 3166-1 alpha-3 (ej., USA, CHL)
language	string	No	Codigo de idioma BCP47 (ej., en-US, es-CL)
limit	integer	No	Maximo de resultados (1-20, predeterminado 5)

Ejemplo de Solicitud

curl -X POST https://geocoder.amigocloud.com/api/v1/{uuid}/geocode/ \
  -H "X-API-Key: your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "Costanera Center, Santiago",
    "country": "CHL",
    "language": "es-CL",
    "limit": 3
  }'

Ejemplo de Respuesta

{
  "results": [
    {
      "label": "Costanera Center, Av. Andres Bello 2425, Providencia, Region Metropolitana, Chile",
      "position": { "lat": -33.4175, "lng": -70.6065 },
      "address": {
        "house_number": "2425",
        "street": "Av. Andres Bello",
        "neighborhood": "Providencia",
        "city": "Santiago",
        "county": null,
        "state": "Region Metropolitana",
        "state_code": "RM",
        "postal_code": null,
        "country": "Chile",
        "country_code": "CHL"
      },
      "result_type": "poi",
      "provider_id": "locationiq:way:123456789",
      "relevance": 0.85,
      "distance": null,
      "bounding_box": [-33.418, -33.416, -70.608, -70.605]
    }
  ],
  "provider": "locationiq",
  "cached": false
}

Cache

Los resultados se almacenan en cache durante 5 minutos. Las respuestas en cache incluyen "cached": true.