Nominatim
Geocodificación directa e inversa sobre OpenStreetMap, gratis con atribución.
Ver la documentaciónPara qué sirve
Qué problema resuelve
Nominatim convierte direcciones en coordenadas (y al revés) usando datos de OpenStreetMap.
El servicio público de OSMF es gratuito pero muy limitado: máximo 1 petición/segundo, User-Agent/Referer válidos y atribución. Para volumen, monta tu propia instancia.
En la práctica
Qué puedes hacer con ella
- Geocodificar una dirección a lat/lon.
- Hacer geocodificación inversa (coordenadas → lugar).
- Mostrar resultados en un mapa con atribución OSM.
- Probar demos ligeras sin pagar.
- Planificar self-host cuando el tráfico crezca.
¿Es gratis?
Gratis con máx. 1 req/s y atribución
Uso del Nominatim público: máximo absoluto 1 request/segundo, Identificación con User-Agent o Referer real (no el default de la librería), atribución OSM/ODbL. Bulk geocoding no está bienvenido en el servicio público. Apps deben poder cambiar de endpoint si OSMF lo pide.
Comprobado el 2026-08-02. Fuente: página oficial de precios o límites
Qué cuenta como una «llamada» aquí
Cada search/reverse a nominatim.openstreetmap.org es 1 request. No hay créditos de pago: el límite es de ritmo y de uso justo.
No hagas geocodificación masiva ni polling periódico desde apps; eso se considera bulk y debe ir a tu instancia.
Política de uso Nominatim (OSMF)
| Límite | Cuota | Qué significa en la práctica |
|---|---|---|
| Ritmo máximo | 1 request / segundo | Tope absoluto del servicio público donado. |
| Identificación | User-Agent o Referer válido | Los UA genéricos de librerías no valen. |
| Bulk / apps pesadas | Self-host | Geocodificación masiva o periódica: instancia propia o proveedor compatible. |
Precios
| Plan | Precio | Para quién | Qué incluye (resumen) |
|---|---|---|---|
| Servicio público OSMF | $0 | Uso ligero con atribución. | Search/reverse · 1 req/s · políticas OSMF. |
| Instancia propia | Tu infra | Volumen o producción seria. | Nominatim self-hosted sin saturar OSMF. |
Uso permitido, comercial y licencia
| Pregunta | Respuesta clara |
|---|---|
| ¿Licencia de datos? | Datos OpenStreetMap bajo ODbL: atribución obligatoria adecuada al medio. |
| ¿Uso comercial? | Posible con ODbL y dentro de la usage policy; el servicio público no es para carga comercial pesada. |
| ¿Hace falta cuenta? | No en el endpoint público; sí User-Agent/Referer identificable. |
Cómo empezar
Geocodificar «Madrid» a coordenadas.
Obligatorio un User-Agent que identifique tu app.
Dirección base de las imágenes: https://nominatim.openstreetmap.org
- 01
Paso 1
Envía User-Agent: MiApp/1.0 (https://tu-sitio.example)
- 02
- 03
Paso 3
Lee lat y lon del primer resultado.
- 04
Paso 4
Muestra atribución © OpenStreetMap contributors.
- 05
Paso 5
No superes 1 req/s. Política: https://operations.osmfoundation.org/policies/nominatim/
Con tu agente
Prompt para integrar la API
Prompt para que tu agente lo deje listo
Pega esto en Cursor, Claude Code, Codex u otro agente de código:
Integra Nominatim público. Docs: https://nominatim.org/release-docs/latest/api/Overview/ . Política: https://operations.osmfoundation.org/policies/nominatim/ . Máx 1 req/s, UA real, atribución ODbL. No hagas bulk. ¿Search o reverse?Detalle técnico
Acceso, HTTPS y CORS
- 01
Acceso · Sin clave
Se llama directamente desde el navegador o el servidor sin registrarse.
- 02
HTTPS · Sí
Sirve sobre TLS, así que vale para producción y para páginas ya en HTTPS.
- 03
CORS · Sí
Permite llamarla directamente desde el navegador sin proxy intermedio.