Migración

Migrar desde Geoapify

Geoapify agrupa la geocodificación junto con API de rutas, lugares y estilos de mapa bajo un único parámetro apiKey, lo que conviene a los equipos que quieren una sola cuenta para gestionar varias funciones de ubicación a la vez. Sus respuestas de geocodificación siguen una estructura similar a GeoJSON con un array features, cada uno con properties para los campos de dirección y geometry para las coordenadas.

Como Geoapify abarca más que la geocodificación, migrar desde ella rara vez es todo o nada. Conviene delimitar el alcance de forma deliberada: ¿trasladas todas las funciones de ubicación a la vez, o solo las llamadas de geocodificación y dejas por ahora las rutas o los estilos de mapa en Geoapify? Ambas opciones son razonables, pero implican cantidades de trabajo distintas, y mezclarlas a mitad de un proyecto suele generar confusión sobre qué clave autentica cada solicitud.

My Geocode es una API de geocodificación y de consulta de IP, zona horaria, elevación y códigos postales, así que es un sustituto directo de la parte de geocodificación de una integración con Geoapify en concreto. El host compatible con Geoapify reproduce el array features y sus campos anidados properties y geometry, y solo cambia el texto de copyright, términos y privacidad de la respuesta. Los detalles de los campos están en /compatibility/geoapify/.

Para las llamadas de geocodificación, migrar significa:

  • Apuntar la solicitud al nuevo host en lugar del de Geoapify
  • Enviar una clave de My Geocode en lugar del apiKey de Geoapify, en cualquiera de los cuatro estilos admitidos que ya use tu cliente (X-API-Key, Authorization: Bearer, autenticación HTTP Basic o parámetro de consulta)
  • Dejar intacto el código que lee features[0].properties y features[0].geometry.coordinates

Si las consultas de rutas o de lugares se quedan por ahora en Geoapify, nada de eso cambia; el host compatible de geocodificación funciona de forma independiente y no requiere que el resto de tu stack se mueva al mismo tiempo.

Los precios son donde una cuenta agrupada y una no agrupada difieren en estructura y no solo en cifras. My Geocode cobra la misma tarifa por todos los endpoints, incluidos todos los hosts compatibles: 2.500 solicitudes gratuitas al día sin clave, 2.500 gratuitas más por clave y día contadas por red, y después crédito prepago a 0,0001 € por solicitud o una clave Unlimited por 50 € al mes. No hay un nivel de precios distinto para la geocodificación frente a otras consultas, lo que simplifica las cuentas si más adelante decides trasladar más partes de un stack basado en Geoapify.

Los extras opcionales (elevación del terreno, detalles de amenazas de IP e información de red) están disponibles en el host compatible de geocodificación añadiendo mg_extras=1 o una cabecera X-MG-Extras, algo que conviene saber si parte del motivo por el que usabas un proveedor agrupado era obtener más de un tipo de dato en una sola llamada.

Migrar una parte de una cuenta con varias funciones es una forma normal y gradual de reducir la dependencia de un único proveedor, y no exige tomar una decisión firme sobre el resto del stack desde el primer día.