Migración

Comparar el soporte de lotes y de solicitudes masivas entre proveedores

Las necesidades de geocodificación masiva, como procesar de una vez una hoja de cálculo de unos miles de direcciones o geocodificar toda una base de datos de clientes como proyecto de limpieza puntual, se resuelven de forma distinta según el proveedor, y las diferencias importan más de lo que podría parecer a primera vista cuando planificas una migración.

Algunos proveedores ofrecen una interfaz web específica para el trabajo masivo: subes un CSV, esperas a que se procese y descargas los resultados con columnas nuevas añadidas. Esto se adapta a usuarios no técnicos, como un miembro del equipo de operaciones o marketing que necesita geocodificar direcciones una vez y no quiere escribir código, pero es una superficie de producto independiente de la API programática y necesita su propio plan de migración si dependes de ella.

Otros proveedores esperan que la geocodificación masiva se haga íntegramente mediante la API programática, enviando muchas solicitudes individuales, a menudo con cierta concurrencia, y reuniendo tú mismo los resultados. Esto da más control a la aplicación que hace las llamadas, incluida la decisión sobre el comportamiento de los reintentos, los límites de concurrencia y cómo gestionar los fallos parciales dentro de un lote grande.

Unas cuantas lecciones realmente independientes del proveedor se aplican sea cual sea el enfoque que adopte cada uno:

  • Incluye siempre lógica de reintento para las solicitudes individuales que fallen dentro de un lote más grande, ya que un trabajo por lotes que falla por completo porque una dirección de cada diez mil devolvió un error es un diseño frágil, sea cual sea el proveedor
  • Respeta la estructura de límite de frecuencia o de cuota que documente la API, ya que un bucle ingenuo que lanza solicitudes lo más rápido posible es la forma más común de que un trabajo masivo se tope con limitaciones o costos inesperados
  • Registra suficiente detalle por solicitud, no solo por lote, para poder identificar y volver a procesar un subconjunto fallido sin repetir todo el trabajo desde cero

El enfoque de My Geocode para el trabajo masivo sigue el patrón programático: las solicitudes pasan por los mismos endpoints que cualquier otra consulta, con las mismas opciones de autenticación (un encabezado X-API-Key, Authorization: Bearer, autenticación HTTP Basic o un parámetro de consulta) y la misma visibilidad de la cuota mediante encabezados de respuesta como X-Quota-Used y X-Quota-Free-Remaining en cada solicitud, documentados en /docs/rate-limits/. Para un trabajo masivo grande y puntual, esta visibilidad de la cuota es realmente útil para regular el ritmo del trabajo de forma automática, ya que un script puede comprobar X-Quota-Free-Remaining en cada respuesta y limitarse a sí mismo en consecuencia en lugar de adivinar un ritmo de solicitudes seguro.

Como los precios son iguales en todos los endpoints, crédito prepago a 0,0001 € por solicitud o una clave Unlimited a 50 € al mes, el costo de un trabajo masivo grande es una simple multiplicación en cuanto sabes cuántas direcciones hay que procesar, sin un nivel de precios masivo aparte que negociar o comparar con tu uso habitual por solicitud. Para los equipos que migran un flujo de trabajo masivo recurrente, ya sea una limpieza mensual de la lista de clientes o un proyecto puntual de migración de datos, ese costo por solicitud fijo y predecible suele hacer que el presupuesto sea la parte más fácil de todo el cambio.