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 Bing Maps REST Services
Bing Maps REST Services tiene una forma de respuesta reconocible: un objeto de nivel superior con un array resourceSets, cada uno con resources, y cada recurso con un objeto point cuyas coordenadas van anidadas dentro de un array coordinates en lugar de campos separados de latitud y longitud. Los desarrolladores que trabajaron con ella, a menudo en empresas .NET donde Bing Maps era la opción natural, conocen esta estructura de memoria, y reescribir el código en torno a otra distinta es justo el tipo de trabajo silencioso y tedioso que mantiene una migración fuera del calendario durante meses.
Una clave generada en el Bing Maps Dev Center se envía como parámetro de consulta, un patrón que comparten la mayoría de las API de mapas para consumidores. Esa parte de la integración suele ser la menor de las preocupaciones; el análisis de la respuesta es donde está el acoplamiento real.
My Geocode ofrece un host compatible con Bing Maps que reproduce exactamente esta estructura resourceSets, de modo que el código de análisis que lee resourceSets[0].resources[0].point.coordinates sigue funcionando después del cambio. El único contenido de la respuesta que no sigue la forma original de Bing es el texto de copyright, términos y privacidad, que por necesidad es nuestro. Tienes todos los detalles en /compatibility/bing-maps/.
Algunas cosas que conviene comprobar antes del cambio:
- Confirma si tu código lee campos de confianza o de código de coincidencia, ya que merece la pena compararlos rápidamente en paralelo
- Confirma qué estilo de autenticación usa tu biblioteca cliente; una clave se puede enviar como
X-API-Key,Authorization: Bearer, autenticación HTTP Basic o parámetro de consulta, así que el que ya use tu biblioteca debería seguir funcionando - Decide si quieres activar los campos extra opcionales (elevación, amenazas de IP, detalles de red) mediante
mg_extras=1, ya que se añaden junto a la forma estándar en lugar de sustituirla
La parte comercial es sencilla en comparación. No hay que configurar una cuenta de facturación: 2.500 solicitudes al día son gratuitas sin clave alguna, y cada clave recibe sus propias 2.500 solicitudes gratuitas al día, contadas por red. Por encima de esa cuota, se paga con crédito prepago a 0,0001 € por solicitud o con una clave Unlimited por 50 € al mes, y el host compatible cuesta lo mismo que cualquier otro endpoint de la plataforma.
Para los equipos que usan la geocodificación dentro de una aplicación .NET o empresarial más grande, la migración suele ser de menor alcance de lo que parece desde fuera, porque el contenedor resourceSets normalmente se lee a través de unos pocos métodos de acceso bien delimitados, y no de forma dispersa por todo el código. Localizar primero esos puntos de acceso y después apuntarlos al nuevo host en un entorno de staging es una forma razonable de validar el cambio antes de tocar el tráfico de producción.
Si tu integración también llama a un endpoint de zona horaria o de elevación de Bing además de la geocodificación, estos se gestionan por separado, ya que las consultas propias de zona horaria y elevación de My Geocode funcionan con independencia del host compatible de geocodificación y conviene conectarlas por su cuenta en lugar de forzarlas por la misma ruta de código. Los detalles completos de la cuota, incluida la cabecera X-Quota-Limit y las cabeceras de respuesta relacionadas que lleva cada solicitud, están documentados en /docs/rate-limits/.