OpenStreetMap
Cartografía abierta y API de edición sobre datos de OpenStreetMap.
Ver la documentaciónPara qué sirve
Qué problema resuelve
La API 0.6 de OpenStreetMap sirve sobre todo para leer/editar el mapa (nodos, ways, changesets), no para búsquedas de direcciones ni consultas analíticas masivas.
Para geocodificar usa Nominatim; para consultas complejas, Overpass. Los datos son ODbL con atribución.
En la práctica
Qué puedes hacer con ella
- Leer elementos del mapa por id o bbox (con cuidado).
- Crear changesets si eres contribuidor autenticado.
- Entender capacidades y límites del endpoint /api/capabilities.
- Elegir la herramienta correcta (Nominatim / Overpass / API 0.6).
- Respetar políticas OSMF en servidores públicos.
¿Es gratis?
Abierto y gratuito (uso justo OSMF)
Datos y API abiertos. Servidores públicos sujetos a políticas de uso de la OSM Foundation: identifica el cliente, no satures, atribuye. Para cargas altas usa mirrors, Overpass dedicado o tu stack. No hay plan de pago obligatorio de OSMF para la API de edición.
Comprobado el 2026-08-02. Fuente: página oficial de precios o límites
Qué cuenta como una «llamada» aquí
Cada request a api.openstreetmap.org/api/0.6/… cuenta como uso del servidor de edición/mapa.
No es un buscador de direcciones: si haces search de lugares, estás en el producto equivocado (Nominatim).
Uso de servidores públicos
| Límite | Cuota | Qué significa en la práctica |
|---|---|---|
| Políticas OSMF | Uso justo | Respeta las policies publicadas; tráfico abusivo puede bloquearse. |
| API 0.6 | Edición / lectura puntual | Pensada para el ecosistema de edición, no para analytics masivos. |
| Búsqueda / consultas | Nominatim / Overpass | Usa las APIs adecuadas en lugar de forzar 0.6. |
Precios
| Plan | Precio | Para quién | Qué incluye (resumen) |
|---|---|---|---|
| OSM datos + API pública | $0 | Comunidad, apps con atribución. | ODbL · API 0.6 · políticas de uso. |
Uso permitido, comercial y licencia
| Pregunta | Respuesta clara |
|---|---|
| ¿Licencia? | Open Data Commons Open Database License (ODbL). Atribución obligatoria. |
| ¿Uso comercial? | Sí con ODbL (atribución y share-alike de la base). Cumple políticas de los servidores que uses. |
| ¿Hace falta cuenta? | Para editar sí (OAuth). Para muchas lecturas públicas, según endpoint; identifica el cliente. |
Cómo empezar
Entender cuándo usar API 0.6 vs Nominatim/Overpass.
Empieza por la wiki de la API y las políticas OSMF.
Dirección base de las imágenes: https://api.openstreetmap.org/api/0.6
- 01
Paso 1
Lee https://wiki.openstreetmap.org/wiki/API_v0.6 para el modelo de datos.
- 02
Paso 2
Prueba GET https://api.openstreetmap.org/api/0.6/capabilities
- 03
Paso 3
Para buscar un lugar, usa Nominatim (no la API 0.6).
- 04
Paso 4
Para consultas de mapa complejas, mira Overpass API.
- 05
Paso 5
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:
Trabaja con OpenStreetMap. API 0.6: https://wiki.openstreetmap.org/wiki/API_v0.6 . Copyright/ODbL: https://www.openstreetmap.org/copyright . No uses 0.6 para geocoding masivo: Nominatim/Overpass. ¿Edición, lectura o te interesa otro servicio OSM?Detalle técnico
Acceso, HTTPS y CORS
- 01
Acceso · OAuth
Requiere flujo OAuth: el usuario autoriza tu aplicación antes de leer sus datos.
- 02
HTTPS · No
Sirve en texto plano: no la uses desde una página segura ni con datos sensibles.
- 03
CORS · Sin verificar
No consta si permite llamadas desde el navegador; pruébalo antes de montar el cliente.