Migrar desde la API Google Geocoding en una línea
Addrova ofrece un punto de acceso compatible con Google. En la mayoría de los casos cambia la URL base y la clave, y conserva el resto de su código.
Antes y después
La URL base de producción https://api.addrova.eu aún no está en línea; la ruta de abajo procede de la especificación de la API.
https://maps.googleapis.com/maps/api/geocode/json
?address=10+rue+de+Rivoli+Paris
&key=GOOGLE_KEYhttps://api.addrova.eu/compat/google/maps/api/geocode/json
?address=10+rue+de+Rivoli+Paris
&key=ADDROVA_KEYSolo se emula el formato de las solicitudes y las respuestas. No se usa ningún dato de Google.
Qué se admite
| Elemento | Compatibilidad |
|---|---|
| address | Geocodificación directa |
| latlng | Geocodificación inversa (`lat,lng`) |
| components | Solo se tiene en cuenta `country:XX` |
| language, region | Aceptados |
| Respuesta | status, results con formatted_address, place_id, types, partial_match, address_components y geometry (location, location_type, viewport) |
| Errores | En formato Google: un campo `status` con HTTP 200, para que los clientes existentes sigan funcionando |
| Extensión de Addrova | Una lista `attribution`, ignorada por los clientes existentes; muéstrela junto a los resultados |
El valor de place_id es un identificador de Addrova, no un place ID de Google: no los mezcle.
Lista de comprobación de la migración
- Sustituir la URL base, el prefijo de ruta y la clave de API.
- Pasar una muestra de sus propias direcciones por ambos servicios y comparar los resultados.
- Mostrar la atribución junto a los resultados, como exigen las licencias de los datos.
- Una vez validado, almacenar las coordenadas en su base de datos. No se aplica ninguna caducidad.
Por qué importa el almacenamiento
Las condiciones de Google limitan el tiempo que pueden almacenarse en caché la latitud y la longitud, y solo los identificadores de lugar pueden conservarse sin límite (véanse las condiciones de Google Maps Platform y las políticas de la API Geocoding). Si necesita conservar coordenadas, compruebe las condiciones vigentes para su caso. Addrova permite el almacenamiento permanente.