Nominatim funciona con datos de OpenStreetMap y lleva mucho tiempo siendo la opción por defecto para los equipos que querían geocodificación sin una licencia comercial de por medio. Las políticas de uso de una instancia pública compartida pueden hacer que ese arreglo sea menos fiable a medida que crece el tráfico, y ahí es donde resulta útil un host compatible con cuotas visibles.
Nuestro host compatible con Nominatim reproduce exactamente los parámetros de solicitud y el cuerpo de respuesta del servicio original, salvo los textos de copyright, términos y privacidad, que son propios de My Geocode. Las solicitudes construidas en el formato de Nominatim pueden enviarse a nuestro host sin cambios, y la respuesta se devuelve con la misma estructura que el código de análisis existente ya espera.
La autenticación sigue aquí también nuestros cuatro métodos habituales: una cabecera X-API-Key, una cabecera Authorization: Bearer, autenticación HTTP Basic con la clave como nombre de usuario o un parámetro de consulta. Como la instancia pública de Nominatim normalmente no requiere ninguna clave, añadir una aquí también significa obtener una cuota propia y medible en lugar de compartir un recurso público sin gestión.
Los precios son iguales a los de cualquier otro host y endpoint que operamos. Cualquier dirección recibe 2.500 solicitudes gratuitas al día sin necesidad de clave, contadas por red. Una clave añade sus propias 2.500 solicitudes gratuitas al día. Superadas ambas cuotas, el crédito prepago cuesta 0,0001 € por solicitud, o un paquete Unlimited lo cubre todo por 50 € al mes.
Una instancia pública compartida tiene que protegerse con políticas de uso que son conservadoras por necesidad, ya que no puede distinguir de antemano el tráfico de un llamante del de otro. Una clave cambia eso: el uso de una cuenta se mide frente a su propia cuota independientemente de lo que ocurra en el servicio ese día, que es una garantía distinta de la que puede ofrecer un recurso compartido por generosa que sea su política declarada.
Las cabeceras de cuota se añaden a cada respuesta de este host, lo que supone un cambio importante frente a una instancia pública compartida sin visibilidad por llamante: se incluyen X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used y X-Credits-Remaining, así que siempre sabes exactamente en qué situación estás en lugar de adivinar una política de uso no publicada.
Para los proyectos que quieren más de lo que devuelve por defecto la respuesta compatible, añadir mg_extras=1 a la solicitud, o una cabecera X-MG-Extras, agrega campos extra opcionales sin alterar la estructura base a menos que lo pidas.
Si no tienes claro cómo se comportará el cambio en un país o región concretos, la página de cobertura en /coverage/ documenta en detalle dónde hay datos de geocodificación disponibles, un buen primer paso antes de dirigir tráfico de producción a cualquier host nuevo, con la forma de Nominatim o no.
El host está documentado en /compatibility/nominatim/, y la guía general para cambiar de proveedor está en /docs/compatibility/. Para quien dependa hoy de una instancia pública de Nominatim, esto ofrece la misma estructura de solicitud con una cuota propia y cabeceras de cuota claras.