Migrar una automatización de Zapier o Make a un nuevo host de geocodificación
Las automatizaciones sin código basadas en un paso de geocodificación necesitan un enfoque de migración distinto al del código propio. Así puedes gestionar ese cambio.
Migrar desde MapQuest Geocoding
MapQuest Geocoding existe desde hace tanto tiempo que muchas integraciones construidas sobre él son anteriores a buena parte de la ola actual de API de mapas. Su clave, generada a través de una cuenta de desarrollador de MapQuest, se envía como parámetro de consulta, y sus respuestas devuelven un array results con un array locations anidado, cada uno con un objeto latLng y una estructura de dirección desglosada con campos como adminArea5 para la ciudad y postalCode para el código ZIP o postal.
Las integraciones tan antiguas a veces arrastran un tipo particular de deuda técnica: el código que llama a MapQuest puede haberlo escrito alguien que ya no está en el equipo, con comentarios que hacen referencia a decisiones que nadie recuerda haber tomado. No es un motivo para evitar la migración, pero sí para probar a fondo en lugar de suponer que quien hace ahora la migración entiende bien el código existente.
El host de compatibilidad de MapQuest de My Geocode reproduce la estructura de los arrays results y locations junto con los campos latLng y de dirección, y solo cambia los textos de copyright, términos y privacidad. Todos los detalles están en /compatibility/mapquest/. En la mayoría de los casos, actualizar el host y la clave es todo el cambio; el patrón de acceso anidado results[0].locations[0].latLng debería seguir devolviendo los datos con la misma forma.
Un orden de operaciones sensato para una integración antigua como esta:
- Localiza cada lugar del código que hace referencia al host o a la clave de MapQuest, ya que el código antiguo a veces incrusta ambos directamente en lugar de leerlos de la configuración
- Mueve esas referencias a la configuración si todavía no lo están, sea cual sea el proveedor al que acabes llegando
- Apunta un entorno de staging al host de compatibilidad y compara una muestra de direcciones reales de producción con los resultados anteriores antes de tocar nada en producción
La autenticación en el nuevo lado acepta una cabecera X-API-Key, una cabecera Authorization: Bearer, la autenticación HTTP Basic o un parámetro de consulta, así que, se enviara como se enviara la antigua clave de MapQuest, aquí hay una opción equivalente.
Los precios son planos y no exigen decidir un nivel de cuenta: 2.500 solicitudes al día gratuitas sin clave, 2.500 gratuitas más por clave y por día, contadas por red, y después crédito prepago a 0,0001 € por solicitud o una clave Unlimited a 50 € al mes. Todos los endpoints, incluido este host de compatibilidad, cuestan lo mismo, lo que elimina una variable que los contratos antiguos a veces incluían en forma de saltos de nivel según el volumen.
Para una integración de MapQuest que ha seguido funcionando en silencio durante años sin mucha atención, el objetivo de una migración como esta es que siga igual de silenciosa después: la misma forma de respuesta, el mismo código y un host y una clave diferentes entre bastidores.