Reemplazo compatible de OpenStreetMap Nominatim

La instancia pública de Nominatim pide como máximo una solicitud por segundo y nada de uso intensivo. osm.mygeocode.com habla la misma interfaz de search y reverse, en los formatos JSON, JSONv2 y GeoJSON, con una cuota con la que de verdad puedes planificar.

Cambia un nombre de host

Host original	`nominatim.openstreetmap.org`
Usa en su lugar	`osm.mygeocode.com`
Parámetro de la clave	El original no usa clave, y aquí tampoco la necesitas: cualquier dirección recibe 2.500 solicitudes al día sin ella. Para tener crédito, paquetes y un historial de uso, añade `key=...` a la consulta o envía la cabecera `X-API-Key`.

Antes

curl "https://nominatim.openstreetmap.org/search?q=Brandenburg+Gate+Berlin&format=json&addressdetails=1"

Después

curl "https://osm.mygeocode.com/search?q=Brandenburg+Gate+Berlin&format=json&addressdetails=1"

Por qué se cambia la gente

El servidor público de Nominatim es un recurso compartido con una política de uso estricta. Mantener uno propio es un trabajo a tiempo completo. Esta es la misma interfaz sin ninguno de los dos problemas.

La misma cuota gratuita, con clave o sin ella. Las solicitudes a osm.mygeocode.com cuentan para las mismas 2.500 solicitudes gratuitas al día que tu dirección, o tu clave, recibe en nuestros propios endpoints. Por encima de eso, crédito prepago a 0,0001 € por solicitud, o 50 € al mes por una clave Unlimited. Para registrarte solo necesitas una dirección de correo electrónico.

Ver precios Obtén una clave gratis

Endpoints

Ruta en osm.mygeocode.com	Qué hace	Respaldado por
`/search?q=...&format=json`	Búsqueda de texto libre	Geocodificación directa
`/search?street=...&city=...&country=...&format=json`	Búsqueda estructurada	Geocodificación directa
`/reverse?lat=...&lon=...&format=json`	Inversa	Geocodificación inversa

Ejemplo de respuesta

Esto es lo que devuelve la solicitud anterior. Los nombres de campo, el anidamiento y los tipos siguen a Nominatim (OSM). Solo los datos que hay detrás son nuestros.

Respuesta de osm.mygeocode.com

[
  {
    "place_id": 2384719,
    "licence": "Data by My Geocode, https://www.mygeocode.com/terms/",
    "osm_type": "way",
    "osm_id": 518071791,
    "lat": "52.5162746",
    "lon": "13.3777041",
    "class": "tourism",
    "type": "attraction",
    "place_rank": 30,
    "importance": 0.8317,
    "addresstype": "tourism",
    "name": "Brandenburger Tor",
    "display_name": "Brandenburger Tor, Pariser Platz, Mitte, Berlin, 10117, Deutschland",
    "address": {
      "tourism": "Brandenburger Tor",
      "road": "Pariser Platz",
      "suburb": "Mitte",
      "borough": "Mitte",
      "city": "Berlin",
      "state": "Berlin",
      "postcode": "10117",
      "country": "Deutschland",
      "country_code": "de"
    },
    "boundingbox": ["52.5161073", "52.5164414", "13.3775375", "13.3778623"]
  }
]

Detalles y diferencias

Nominatim no usa clave, y aquí tampoco se necesita para las primeras 2.500 solicitudes al día. Para tener crédito, paquetes y un historial de uso, añade key=... a la consulta o envía la cabecera X-API-Key.

Las líneas de copyright, los nombres de licencia y los enlaces a los términos y a la privacidad de la respuesta son nuestros y no del proveedor original. Todo lo demás conserva la estructura original.

/search responde jsonv2 de forma predeterminada y /reverse responde XML, igual que los valores predeterminados del propio Nominatim.
Se sirven todos los formatos: xml, json, jsonv2, geojson y geocodejson.
La línea de licencia y el atributo de atribución del XML son nuestros.
No hay endpoint por lotes, porque el original no lo tiene. Para trabajos masivos, usa POST /v1/forward o /v1/reverse en api.mygeocode.com (hasta 100 por llamada, una solicitud cada una).

Si tu cliente depende de un campo o de un comportamiento que no aparece aquí, dínoslo. Las carencias de compatibilidad se corrigen rápido porque suelen ser pequeñas.

Otros hosts compatibles

Cómo funcionan los hosts compatibles, el resumen y los reemplazos compatibles de bibliotecas JavaScript.