Migración

Migrar desde Geocodio

Geocodio se ganó una sólida reputación específicamente por la precisión de las direcciones de Estados Unidos y Canadá, junto con un flujo de carga masiva de CSV que permite geocodificar una hoja de cálculo de direcciones sin escribir ningún código de integración. Su clave de API se envía como parámetro de consulta (api_key), y las respuestas para una sola dirección llegan con un array results que contiene address_components y un campo accuracy que describe la confianza de la coincidencia.

Conviene tratar el flujo de CSV masivo como un elemento de migración propio, separado de cualquier llamada programática a la API que haga tu aplicación. A un equipo de marketing o a un analista de operaciones que sube una hoja de cálculo mediante un formulario web una vez al mes no le afectan los cambios en tu código de backend, y ese flujo necesita su propio plan, ya sea programar un trabajo por lotes contra la nueva API o gestionarlo manualmente durante un periodo de transición.

En la parte programática, el host compatible con Geocodio de My Geocode reproduce el array results y la estructura address_components que devuelve Geocodio, y el texto de copyright, términos y privacidad es el único contenido que cambia. Los detalles de referencia están en /compatibility/geocodio/. El código que lee results[0].address_components.city debería seguir funcionando una vez actualizados el host y la clave.

Algunos puntos que conviene planificar específicamente por el enfoque regional de Geocodio:

  • Si tu integración depende de algún campo adicional específico de EE. UU., como la información del distrito del Congreso, comprueba si ese dato forma parte del alcance de tu migración o si a partir de ahora necesita una consulta aparte
  • Confirma si algún trabajo masivo se ejecuta con un límite de frecuencia ajustado específicamente a los límites documentados de Geocodio, ya que una temporización de reintentos basada en las cifras de un proveedor no tiene por qué encajar con las de otro
  • Prueba un lote de direcciones históricas reales de tus propios datos contra el nuevo host antes de dar por hecha la paridad total, en particular en casos límite como apartados postales o direcciones de rutas rurales

La autenticación admite una cabecera X-API-Key, una cabecera Authorization: Bearer, autenticación HTTP Basic o un parámetro de consulta, así que el estilo que use tu cliente actual de Geocodio para su parámetro api_key tiene aquí un equivalente.

En cuanto al coste, no hay un nivel de precios masivo aparte en el que pensar: todos los endpoints, incluido este host compatible, tienen el mismo precio, con 2.500 solicitudes gratuitas al día sin necesidad de clave, otras 2.500 gratuitas por clave y día contadas por red y, por encima de eso, crédito prepago a 0,0001 € por solicitud o una clave Unlimited por 50 € al mes. Un gran trabajo masivo puntual y un goteo constante de llamadas a la API cuestan lo mismo por solicitud en ambos casos, lo que convierte la estimación del coste de una migración masiva en una simple multiplicación en lugar de una consulta de tarifas por niveles.