API de geocodificación directa
Envía una dirección, el nombre de un lugar, un código postal o una descripción aproximada como "cafetería cerca de Kings Cross" y recibe coordenadas, una dirección normalizada, sus partes, un cuadro delimitador y un nivel de precisión que te indica cuánto puedes confiar en el punto.
Ejemplo
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/forward?q=221B+Baker+Street,+London&limit=1"El texto libre funciona. También una consulta estructurada, si ya tienes las piezas: street=221B Baker Street&city=London&country=gb. Limita los resultados a uno o varios países con country=gb,ie, oriéntalos hacia un punto con proximity=lat,lon o hacia un recuadro con bounds.
{
"status": "ok",
"query": "221B Baker Street, London",
"results": [
{
"formatted": "221B Baker Street, London NW1 6XE, United Kingdom",
"lat": 51.523767,
"lon": -0.158555,
"type": "address",
"precision": "house",
"confidence": 0.97,
"components": {
"house_number": "221B",
"road": "Baker Street",
"neighbourhood": "Marylebone",
"city": "London",
"state": "England",
"postcode": "NW1 6XE",
"country": "United Kingdom",
"country_code": "gb"
},
"bounds": { "north": 51.523917, "south": 51.523617, "east": -0.158305, "west": -0.158805 }
}
]
}Qué recibes
| Campo | Significado |
|---|---|
formatted | La dirección completa, escrita como se escriben las direcciones en ese país. |
lat, lon | Grados decimales, WGS 84. Hasta seis decimales. |
type | Lo que coincidió: address, street, postcode, city, region, country o poi. |
precision | house, street, postcode o admin. Consulta la cobertura. |
confidence | De 0 a 1. Qué tan seguros estamos de que este es el lugar al que te referías, según la consulta. Es independiente de la precisión: una consulta de ciudad puede coincidir con una confianza de 1 con precisión admin. |
components | La dirección desglosada en partes, con los mismos nombres de clave en todos los países. Solo aparecen las partes que existen. |
bounds | Un cuadro delimitador del elemento encontrado: el edificio, la calle, la zona del código postal o la ciudad. |
Dónde se usa
Limpieza de direcciones de clientes
Geocodifica al registrarse el cliente y guarda formatted y components junto a lo que escribió. Rechaza todo lo que esté por debajo de precision: street y pídele que lo revise.
Colocar registros en un mapa
Procesa por lotes un CSV de direcciones de tiendas o inmuebles a 50 por segundo y represéntalas en el mapa. El campo bounds te da un zoom adecuado para cada una.
Búsqueda por lugar
Convierte "pisos en Hackney" en un cuadro delimitador y consulta con él tu propia base de datos. type te indica si el usuario escribió una ciudad, una calle o un edificio.
Precisión
Los resultados a nivel de número de portal dependen de que existan datos de direcciones para ese país, y no existen en todas partes. La página de cobertura indica el mejor nivel que alcanzamos en cada uno de los 249 países y territorios. Cuando no podemos encontrar un número de portal, recurrimos a la calle, después al código postal y después a la localidad, y el campo precision indica cuál. Nunca devolvemos el centroide de un país etiquetado como dirección.
Precio y límites
Una llamada es una solicitud, sin importar cuántos resultados devuelva (hasta 10 con limit). Cada clave tiene 2.500 solicitudes gratuitas al día; a partir de ahí, 0,0001 € cada una del crédito prepago, o nada con una clave Unlimited (50 € al mes). Detalles de precios.
¿Vienes de otro proveedor? Los hosts compatibles de Google, Bing, HERE, Mapbox y otros hosts compatibles (drop-in) responden a las solicitudes de geocodificación directa en los formatos de esos proveedores.