Geocode.Farm lleva mucho tiempo impulsando discretamente la geocodificación en varias aplicaciones pequeñas y herramientas internas, a menudo integrado durante una primera versión y sin tocar desde entonces. Nuestro host compatible está pensado exactamente para este tipo de integración, una que ha funcionado bien y merece un camino sencillo hacia adelante en lugar de una reescritura.
El host reproduce exactamente los parámetros de solicitud y el cuerpo de respuesta de Geocode.Farm, salvo los textos de copyright, términos y privacidad, que son propios de My Geocode. Las solicitudes preparadas actualmente para los endpoints de Geocode.Farm pueden apuntar a nuestro host tal cual, y la respuesta se devuelve con la misma estructura que el código existente ya espera.
Cambiar requiere modificar un nombre de host y una clave, y nada de la lógica de solicitud o de análisis de respuestas que los rodea. Esa clave puede autenticarse como cabecera X-API-Key, como cabecera Authorization: Bearer, mediante autenticación HTTP Basic con la clave como nombre de usuario o como parámetro de consulta, según lo que ya envíe tu integración actual.
Las integraciones antiguas como esta a menudo se escribieron directamente con llamadas HTTP sin procesar, antes de que existiera un SDK del proveedor o de que valiera la pena adoptarlo. My Geocode publica sus propios SDK, listados en /sdks/, para quien prefiera dejar atrás por completo las llamadas HTTP sin procesar ya que está tocando esta parte del código, aunque el host compatible no lo exige en absoluto.
Los precios siguen las mismas reglas que en el resto de la plataforma. Cualquier dirección recibe 2.500 solicitudes gratuitas al día sin ninguna clave, contadas por red. Una clave añade sus propias 2.500 solicitudes gratuitas al día. Más allá de eso, el crédito prepago cuesta 0,0001 € por solicitud, o un paquete Unlimited cubre el uso por 50 € al mes, con la misma tarifa sin importar qué host haya atendido la llamada.
Cada respuesta incluye nuestro conjunto completo de cabeceras de cuota: X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used, X-Credits-Remaining, X-Key-IPs-Used, X-Key-IPs-Limit y X-Quota-Reset, lo que ofrece una visibilidad del uso que una integración más pequeña y antigua quizá nunca haya tenido.
Para los proyectos que quieren más de lo que devuelve la respuesta compatible, añadir mg_extras=1 a la solicitud, o una cabecera X-MG-Extras, agrega campos extra opcionales, totalmente a elección y desactivados por defecto.
Con esto, nuestros hosts compatibles publicados llegan a diecisiete en total, entre geocodificación, geolocalización de IP y elevación. Llegar a esa cifra tuvo menos que ver con cubrir todos los proveedores posibles y más con cubrir los proveedores que las integraciones reales usan de verdad, por eso la lista abarca esas tres categorías en lugar de concentrarse por completo en una de ellas.
El propio host está documentado en /compatibility/geocode-farm/, y la lista completa está en /compatibility/. Si Geocode.Farm forma parte de una integración antigua de tu stack, esta es una forma sencilla de ver cómo es una estructura de cuotas moderna detrás de la misma forma de solicitud.