Primeros Pasos
Servicio proxy de geocodificacion para clientes de AmigoCloud. Proporciona acceso seguro y con limite de tasa a servicios de geocodificacion con un formato de respuesta normalizado.
Inicio Rapido
URL Base:
Ejemplo de solicitud:
curl -X POST https://geocoder.amigocloud.com/api/v1/{customer_uuid}/geocode/ \
-H "X-API-Key: your-api-key" \
-H "Content-Type: application/json" \
-d '{"address": "1600 Amphitheatre Parkway, Mountain View, CA", "country": "USA"}'
Ejemplo de respuesta:
{
"results": [
{
"label": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, United States",
"position": { "lat": 37.42249, "lng": -122.08473 },
"address": {
"house_number": "1600",
"street": "Amphitheatre Pkwy",
"city": "Mountain View",
"state": "California",
"state_code": "CA",
"postal_code": "94043",
"country": "United States",
"country_code": "USA"
},
"result_type": "house_number",
"relevance": 1.0
}
],
"provider": "locationiq",
"cached": false
}
Endpoints Disponibles
| Endpoint | Metodo | Descripcion |
|---|---|---|
/{uuid}/geocode/ |
POST | Convertir direcciones a coordenadas |
/{uuid}/reverse/ |
POST | Convertir coordenadas a direcciones |
/{uuid}/autocomplete/ |
POST | Completar direcciones parciales |
/{uuid}/usage/ |
GET | Ver estadisticas de uso y cuotas |
/{uuid}/dashboard/ |
GET | Panel visual de uso (compatible con navegador) |
Convenciones Clave
- Codigos de pais: ISO 3166-1 alpha-3 (ej.,
USA,CHL,MEX) - Codigos de idioma: BCP47 (ej.,
en-US,es-CL) - Autenticacion: Encabezado
X-API-Keyen cada solicitud - Formato de respuesta: Envoltorio JSON normalizado con los campos
results,providerycached