Las API
Ocho endpoints bajo https://api.mygeocode.com/v1/. Cada uno acepta parámetros de consulta en una solicitud GET y devuelve JSON. Comparten una cuota, un conjunto de códigos de error y un precio.
API de geocodificación directa
GET /v1/forwardEnvía una dirección, el nombre de un lugar o una descripción aproximada y obtén las coordenadas, una dirección normalizada y cada una de sus partes.
Detalles y ejemplosAPI de geocodificación inversa
GET /v1/reverseEnvía una latitud y una longitud y obtén la dirección más cercana, con la ciudad, la región, el código postal y el país desglosados.
Detalles y ejemplosAPI de autocompletado de direcciones
GET /v1/autocompleteSugiere direcciones mientras alguien escribe. Cada sugerencia incluye coordenadas, así que rara vez necesitas una segunda llamada.
Detalles y ejemplosAPI de consulta de IPv4
GET /v1/ipv4País, región, ciudad, coordenadas, zona horaria y titular de la red para cualquier dirección IPv4, o para quien hace la llamada si la omites.
Detalles y ejemplosAPI de consulta de IPv6
GET /v1/ipv6Los mismos datos para direcciones IPv6, además del prefijo anunciado al que pertenece la dirección.
Detalles y ejemplosAPI de consulta de zona horaria
GET /v1/timezoneNombre de zona horaria IANA, desfase respecto a UTC, estado del horario de verano y hora local para cualquier coordenada, ahora o en la marca de tiempo que elijas.
Detalles y ejemplosAPI de consulta de elevación
GET /v1/elevationAltura sobre el nivel del mar en metros para un punto, o para hasta 100 puntos en una sola llamada.
Detalles y ejemplosAPI de consulta de código postal
GET /v1/postcodeConvierte un código postal en un nombre de lugar, una región y unas coordenadas. Funciona con los códigos ZIP, los postcodes y sus equivalentes en la mayoría de los países.
Detalles y ejemplosLo que tienen en común
La misma estructura
Cada respuesta tiene un status de nivel superior con el valor ok o error. Los errores llevan un code legible por máquina y una frase que puedes registrar. Las coordenadas siempre van en grados decimales en lat y lon.
Las mismas reglas en todas partes
Cualquier dirección recibe 2.500 solicitudes gratuitas al día sin clave. Cada clave tiene sus propias 2.500 solicitudes gratuitas al día (compartidas con las solicitudes sin clave de la misma red), y después crédito prepago o un paquete Unlimited. Una clave de pago por uso atiende a dos direcciones IP por cada periodo móvil de 24 horas, y una clave Unlimited, a tres. Consulta autenticación.
El mismo precio
Una geocodificación inversa cuesta lo mismo que una consulta de IP: nada por las primeras 2.500 al día en cada clave, después 0,0001 € cada una del crédito prepago, o 50 € al mes por una clave Unlimited. Consulta los precios.
Qué cuenta como una solicitud
Casi todo es una llamada, una solicitud. Las excepciones son las llamadas por lotes, donde cada elemento del lote cuenta por separado.
| Endpoint | Cuenta como |
|---|---|
| Geocodificación directa, geocodificación inversa, consulta de código postal | 1 solicitud por llamada, independientemente de cuántos resultados se devuelvan |
| Autocompletado de direcciones | 1 solicitud por llamada. Aplica debounce a las pulsaciones de teclas en tu cliente; los SDK lo harán por ti |
| Consulta de IPv4 e IPv6 | 1 solicitud por llamada, o 1 por dirección en un lote |
| Consulta de zona horaria | 1 solicitud por llamada |
| Consulta de elevación | 1 solicitud por punto. Una llamada con 20 puntos cuenta como 20 |
| Hosts compatibles (Google, Bing, HERE y otros) | Las mismas reglas que el endpoint en el que se basan |
| Reemplazos compatibles de JavaScript: cargas de mapa y teselas | 0. Solo cuentan las llamadas de geocodificación, autocompletado y elevación |
Todavía no disponible
El cálculo de rutas, las matrices de distancias y las isócronas no forman parte del servicio y no están previstos para este año. La búsqueda de puntos de interés por categoría está en estudio. Si necesitas alguno de ellos para cambiarte, dínoslo; nos ayuda a decidir qué construir después.