osrmroute
Documentación de API, SDK y guías de integraciónIntegración y migración
OSRMRoute / API

Documentación de API, SDK y guías de integración

Consulta endpoints, autenticación, límites y ejemplos de API. Integra SDK móviles, CLI, MCP, estilos de mapas, búsqueda de lugares y datos viales.

OpenAPI · Postman

Catálogo de API

Busca API por nombre, caso de uso o endpoint. Cada entrada enlaza a parámetros, ejemplos y límites de uso.

Navegación (10)
  • Routing API →

    Calcula una ruta que pase por los puntos en el orden indicado, en coche, bicicleta o a pie. Usa steps=true para las instrucciones y geometries=geojson para GeoJSON.

    GET /api/v1/osrm/route/v1/{profile}/{coordinates}
  • Isochrones API →

    Estima la accesibilidad a partir de tiempos de viaje a puntos de muestra. Si cada dirección tiene un punto alcanzable, quality.status es estimated; en caso contrario es insufficient_data y polygons está vacío. Un resultado vacío no demuestra que no haya vías alcanzables. El límite es aproximado; solo se admiten límites de tiempo.

    GET /api/1/isochrone
  • Map Matching API →

    Ajusta trazas GPS imprecisas a la red vial real (snap to road). Se usa para limpiar el ruido en las señales GPS.

    GET /api/v1/osrm/match/v1/{profile}/{coordinates}
  • Nearest API →

    Ajusta cualquier coordenada al segmento de carretera real más cercano (snap) y devuelve información sobre el nombre de la vía.

    GET /api/v1/osrm/nearest/v1/{profile}/{coordinates}
  • Directions API →

    Devuelve navegación paso a paso entre dos o más puntos con una lista de instrucciones limpia (texto, distancia, duración, tipo de maniobra y ubicación). Admite coche, bici y a pie, además de hasta 3 rutas alternativas en una sola llamada.

    GET /api/1/directions
  • Alternative Routes API →

    Devuelve navegación paso a paso entre dos o más puntos con una lista de instrucciones limpia (texto, distancia, duración, tipo de maniobra y ubicación). Admite coche, bici y a pie, además de hasta 3 rutas alternativas en una sola llamada.

    GET /api/1/directions
  • Snap to Road API →

    Ajusta puntos GPS crudos e imprecisos a la posición más cercana de la red vial. Repite el parámetro point por cada coordenada (hasta 100).

    GET /api/1/snap
  • API de estimación de combustible →

    Estime combustible y valor del viaje con distancia, peso cargado, consumos en vacío/plena carga y precio por litro. Por separado o en Truck.

    POST /api/v1/fuel/estimate
  • Truck Routing API →

    Planifica rutas de camión nacionales y transfronterizas en carreteras conectadas. Envía las dimensiones y el peso del vehículo cargado en cada solicitud.

    POST /api/v1/truck/route
  • Search Along Route API →

    Compara paradas y tiempo de conducción adicional en una ruta.

    POST /api/v1/places/along-route
Operaciones y planificación de carga (7)
  • Route Optimization API →

    Planifica rutas con restricciones de capacidad, ventanas horarias, habilidades y recogidas/entregas vinculadas. Una heurística con tiempo limitado reduce el viaje sin garantizar un óptimo global. Las tareas no asignadas permanecen en solution.unassigned; las entradas no válidas se rechazan por completo.

    POST /api/1/vrp
  • Matrix API →

    Calcula tiempos, distancias o ambos entre orígenes y destinos. Selecciona índices de la lista de coordenadas con sources y destinations.

    GET /api/v1/osrm/table/v1/{profile}/{coordinates}
  • Trip API (TSP) →

    Ordena las paradas de un único vehículo mediante la red vial. Para una ruta abierta, envía roundtrip=false&source=first&destination=last. El orden puede no ser óptimo.

    GET /api/v1/osrm/trip/v1/{profile}/{coordinates}
  • Agrupación de ubicaciones →

    Agrupa (agrupa en clústeres) las coordenadas dadas según su proximidad y densidad geográfica.

    POST /api/1/cluster
  • Planificación de carga →

    Planifica cargas mixtas para camiones, remolques y contenedores. Revisa el apilado, el orden de carga y el espacio en 3D o integra la API en tu sistema.

    POST /api/v1/load-plansGET /api/v1/load-plansGET /api/v1/load-plans/{id}
    Todos los endpoints (+38)
    DELETE /api/v1/load-plans/{id}POST /api/v1/load-plans/{id}/cancelGET /api/v1/load-plans/{id}/worksheetGET /api/v1/load-plans/{id}/csvGET /api/v1/load-plans/{id}/modelGET /api/v1/load-plans/pricesGET /api/v1/load-plans/import-previewPOST /api/v1/load-plans/import-previewPOST /api/v1/load-plans/comparePOST /api/v1/load-plans/fleetPOST /api/v1/load-plans/{id}/placement-previewPOST /api/v1/load-plans/{id}/placement-revisionsGET /api/v1/load-plans/{id}/pdfGET /api/v1/load-plans/{id}/xlsxPOST /api/v1/load-plans/{id}/shareDELETE /api/v1/load-plans/{id}/sharePOST /api/v1/load-plans/shared-viewPOST /api/v1/load-plans/palletizePOST /api/v1/load-plans/{id}/axle-estimateGET /api/v1/load-plans/workspace/{kind}GET /api/v1/load-plans/workspace/{kind}/{id}PUT /api/v1/load-plans/workspace/{kind}/{id}DELETE /api/v1/load-plans/workspace/{kind}/{id}GET /api/v1/load-plans/webhookPOST /api/v1/load-plans/webhookDELETE /api/v1/load-plans/webhookGET /api/v1/load-plans/webhook/eventsPOST /api/v1/load-plans/webhook/events/{id}POST /api/v1/load-plans/multi-stopPOST /api/v1/load-plans/bulkPOST /api/v1/load-plans/packagingPOST /api/v1/load-plans/dispatchPOST /api/v1/load-plans/fulfillmentPOST /api/v1/load-plans/simulationGET /api/v1/load-plans/{id}/warehousePOST /api/v1/load-plans/{id}/warehouseGET /api/v1/load-plans/{id}/simulation-reportGET /api/v1/load-plans/partner
  • Analítica de viaje: prueba de visita →

    Evidencia de visita y permanencia a partir de su trazado.

    POST /api/v1/trip-analytics/visit-proof
  • Optimización de flota de camiones →

    Matrices estáticas de camión específicas por vehículo.

    POST /api/v1/truck/optimize
Búsqueda (8)
  • Geocoding API →

    Convierte un texto de búsqueda en coordenadas geográficas (directa) o coordenadas en una dirección (inversa). Autocompletado rápido y tolerante a errores tipográficos que cubre calles, direcciones y puntos de interés (cafés, tiendas, hoteles, oficinas). Ideal para buscar mientras se escribe.

    GET /api/1/geocode
  • Places API →

    Encuentra puntos de interés cerca de una ubicación — cafés, tiendas, hoteles, cajeros, farmacias y más — filtrados por categoría y radio, ordenados por distancia.

    GET /api/1/places
  • Autocomplete API →

    Sugerencias de lugares rápidas y tolerantes a errores mientras el usuario escribe, con sesgo por ubicación.

    GET /api/1/autocomplete
  • Batch Geocoding API →

    Geocodifica hasta 100 direcciones por solicitud. Los resultados siguen el orden de entrada y cada dirección cuesta un crédito.

    POST /api/1/geocode/batch
  • Búsqueda en lenguaje natural →

    Encuentre lugares con una consulta breve en inglés.

    POST /api/v1/search/natural
  • Detalles de lugares →

    Consulte atributos proporcionados por la fuente.

    POST /api/v1/places/details
  • Structured Geocoding API →

    Busca direcciones por calle, ciudad, código postal y país.

    POST /api/v1/search/structured
  • Suggest & Retrieve API →

    Crea búsquedas de lugares con sugerencias y recuperación segura.

    POST /api/v1/search/suggestPOST /api/v1/search/retrieve
Mapas (4)
  • Vista previa de estilo por texto →

    Describa colores y capas y revise el mapa.

    POST /api/v1/studio/preview
  • Static Maps API →

    Exporta mapas con estilo como PNG para informes y aplicaciones.

    POST /api/v1/maps/static
  • Studio API →

    Gestiona estilos, conjuntos de datos y publicación desde tu aplicación.

    GET /api/v1/studio/{resource}POST /api/v1/studio/{resource}
  • Estilos de mapa y teselas vectoriales →

    Carga mapas base públicos o estilos publicados en MapLibre. Las solicitudes públicas no requieren clave ni consumen créditos. Usa las URL de teselas del estilo y conserva la atribución.

    GET /api/basemaps/{style}GET /api/map-styles/{id}GET /api/map-styles/{id}/tiles/{dataset}/{z}/{x}/{y}
    Todos los endpoints (+2)
    GET /api/private-maps/{id}GET /api/private-maps/{id}/tiles/{dataset}/{z}/{x}/{y}
Datos (15)
  • Timezone API →

    Zona horaria IANA, desfase UTC actual, estado del horario de verano y hora local para cualquier coordenada.

    GET /api/1/timezone
  • Elevation API →

    Altura sobre el nivel del mar, en metros, para cualquier coordenada — un punto o el perfil de toda una ruta.

    GET /api/1/elevation
  • Boundary Lookup API →

    Averigua en qué país, estado, ciudad y distrito cae una coordenada — con el polígono de límite si se solicita.

    GET /api/1/boundary
  • Geofencing API →

    Comprueba en una llamada en cuáles de tus zonas cae cada punto — vallas poligonales o circulares.

    POST /api/1/geofence
  • Elevation Profile API →

    Altitud en cada punto de una ruta más ascenso, descenso y distancia totales — un perfil completo.

    POST /api/1/elevation/profile
  • Solar API →

    Amanecer, atardecer, crepúsculo, mediodía solar y duración del día para cualquier coordenada y fecha.

    GET /api/1/solar
  • Geometry Utilities API →

    Distancia, rumbo, área, centroide, simplificación y polyline encode/decode — matemática espacial como servicio.

    POST /api/1/geometry
  • Coordinate Conversion API →

    Convierte latitud/longitud a y desde referencias de cuadrícula UTM y MGRS.

    GET /api/1/convert
  • Country Info API →

    Moneda, código telefónico, idiomas, capital y bandera de cualquier país por código ISO o nombre.

    GET /api/1/country
  • Dataset Query API →

    Encuentra objetos cercanos en tus propios datos geográficos.

    POST /api/v1/maps/datasets/{id}/query
  • API de datos viales →

    Límites de velocidad, atributos viales y observaciones de señales según la cobertura disponible.

    POST /api/v1/roads/lookupPOST /api/v1/roads/batch
  • Uso de la cuenta →

    Datos viales: 100.000 operaciones al mes

    POST /api/v1/roads/usage
  • API de señales de tráfico →

    Encuentra observaciones de señales en un área del mapa. Obtén clasificaciones, coordenadas, direcciones y fechas de observación con paginación por cursor.

    POST /api/v1/roads/signs
  • Evidencia de conformidad de ruta →

    Evidencia de velocidad con fuente para posiciones de ruta enviadas.

    POST /api/v1/roads/compliance
  • Consulta de límite de velocidad →

    Consulta el límite de velocidad cartografiado para turismos cerca de una coordenada. Si falta o es ambiguo, se devuelve null.

    GET /api/1/speed-limit
Guía de integración de la plataforma (6)
  • Tareas asíncronas →

    Operaciones: geocode_batch, matrix, optimize. POST /api/jobs devuelve 202 y un ID de tarea. El mismo Idempotency-Key y contenido devuelven la tarea existente; otro contenido devuelve 409.

    POST /api/jobsGET /api/jobsGET /api/jobs/{id}
    Todos los endpoints (+1)
    DELETE /api/jobs/{id}
  • API Sandbox →

    Valide el análisis de respuestas en el sandbox con datos de prueba antes de una llamada real de pago.

    POST /api/sandbox
  • Metadatos de fuentes →

    Consulta las fuentes, la cobertura geográfica y la actualización de los datos por servicio.

    GET /api/source-metadata
  • Acceso móvil →

    Conecta tu aplicación sin incluir una clave API secreta.

    POST /api/mobile/challengePOST /api/mobile/token
  • API MCP remota →

    Conecta herramientas de IA con servicios de ubicación.

    POST /api/mcp
  • Endpoints de compatibilidad →

    Antes de migrar una integración, verifica el orden de coordenadas y las unidades de respuesta.

    GET /api/v1/route/{profile}/{coordinates}GET /api/1/routeGET /api/1/route/info
    Todos los endpoints (+9)
    GET /api/1/matrixPOST /api/1/matrixPOST /api/1/matrix/calculatePOST /api/1/matchPOST /api/1/elevationPOST /api/1/optimizePOST /api/1/vrp/optimizePOST /api/1/cluster/calculatePOST /api/1/batch-geocode

Introducción

#

OSRMRoute ofrece API de rutas, planificación de flotas, búsqueda de direcciones, mapas y datos geográficos. Busca en el catálogo la guía de la operación que vas a integrar.

Límites actuales de los planes

Los límites de créditos y solicitudes por minuto se comparten entre todas las claves de la cuenta. Un límite adicional por clave no aumenta el presupuesto. Primero se usan los créditos incluidos y luego los comprados.

Free incluye las API Routing, Route Optimization, Geocoding (con búsqueda inversa y autocompletado) y Matrix dentro de los límites del plan. Map Matching, Isochrone, Truck Routing, Fuel Estimate y otras API independientes requieren un plan de pago, incluido PAYG. El acceso a las API depende del plan efectivo de la cuenta; un saldo positivo por sí solo no elimina las restricciones Free. Los datos viales y AI mantienen sus requisitos Business independientes.

Route, Directions y Truck Routing: una solicitud procesada sin carretera accesible cercana o sin ruta conectada cuesta una sola vez 0,5 créditos en todos los planes aptos, incluido PAYG. No se cobran entradas inválidas, rechazos de acceso/plan o cobertura del grafo ni errores del servidor. Primero se reserva el precio de una solicitud correcta y se devuelve el resto.

Cargando límites…

La demo pública admite Route, Matrix, Match, Nearest y Trip con límites propios. Para los demás servicios, usa tu clave API y los ejemplos siguientes.

Autenticación

#

Envía la clave como token Bearer en el encabezado Authorization. Consulta en la guía el ámbito de la clave y el entorno requeridos. Algunos endpoints antiguos aceptan claves en la URL.

HTTP
Authorization: Bearer YOUR_API_KEY

Códigos de error

#

OSRMRoute usa códigos de estado HTTP estándar y mensajes de error JSON detallados para indicar el estado de una solicitud.

Los errores incluyen error y, a veces, code. Comprueba el estado HTTP y las cabeceras de presupuesto, no solo el mensaje. Reset indica ventanas móviles, no un reinicio a medianoche.

X-RateLimit-Limit · X-RateLimit-Remaining · X-RateLimit-Reset · X-Compute-* · X-Quota-* · X-Credits-* · Retry-After

Proporciona una clave API válida y comprueba su estado.

HTTP 401
{
  "error": "Invalid API Key"
}

Recarga el saldo o elige un plan compatible.

HTTP 402
{
  "error": "Insufficient balance: this request costs 1 credit and your balance is 0 credits. Top up your account to continue."
}

Comprueba los límites de complejidad y las restricciones de la clave.

HTTP 403
{
  "error": "This API Key is disabled"
}

Respeta Retry-After y reduce la frecuencia de solicitudes.

HTTP 429
{
  "error": "Rate limit exceeded: this account has exceeded its configured requests-per-minute limit. Please slow down."
}

El servicio o su fuente no están disponibles. Reintenta con cautela y esperas crecientes.

HTTP 500
{
  "error": "Internal Server Error"
}

Routing API

#

Calcula una ruta que pase por los puntos en el orden indicado, en coche, bicicleta o a pie. Usa steps=true para las instrucciones y geometries=geojson para GeoJSON.

GET
/api/v1/osrm/route/v1/{profile}/{coordinates}

Parámetros (Query Params)

ParámetroTipoEstadoPredeterminadoDescripción
profilestringObligatoriodrivingPerfil de modo de transporte. Valores admitidos: driving (coche), cycling (bici), walking (peatón).
coordinatesstringObligatorio-Coordenadas de los puntos. Formato: lon,lat;lon,lat;lon,lat... (al menos 2 puntos).
overviewstringOpcionalsimplifiedNivel de detalle de la geometría de ruta devuelta: simplified (simplificada), full (geometría completa), false (sin geometría).
geometriesstringOpcionalpolylineFormato de geometría: geojson (objeto GeoJSON), polyline (cadena codificada).
stepsbooleanOpcionalfalseSi se devuelven instrucciones paso a paso para cada giro.
alternativesinteger | booleanOpcionalfalseCantidad de alternativas que se intentan encontrar. Depende de la red vial.

Ejemplo de solicitud

Sustituye YOUR_KEY por tu clave API. Las solicitudes consumen créditos; copiar el ejemplo no envía ninguna solicitud.

Routing API
curl "https://osrmroute.com/api/v1/osrm/route/v1/driving/49.8516,40.3777;49.86,40.40?steps=true&overview=full&geometries=geojson" -H "Authorization: Bearer YOUR_KEY"

Límites y coordenadas

Coste en créditos: 1 crédito por cada bloque iniciado de 10 puntos de entrada, incluidos origen y destino.

Route, Directions y Truck Routing: una solicitud procesada sin carretera accesible cercana o sin ruta conectada cuesta una sola vez 0,5 créditos en todos los planes aptos, incluido PAYG. No se cobran entradas inválidas, rechazos de acceso/plan o cobertura del grafo ni errores del servidor. Primero se reserva el precio de una solicitud correcta y se devuelve el resto.

Ruta OSRM: lon,lat; GeoJSON: [lon,lat].

  • points ≥ 2; points ≤ plan.maxRoutePoints
  • snap_distance_m ≤ 2000

Los perfiles de coche, a pie y bicicleta son mundiales. Los puntos deben conectarse por vías permitidas. El VRP es heurístico y las isócronas aproximadas; no se promete un óptimo global ni tráfico en directo.

Planes y precios actualesCobertura por servicio

Ejemplo de respuesta JSON

JSON ilustrativo y abreviado. Los valores, campos opcionales y datos cartográficos pueden variar. Las distancias están en metros y las duraciones de ruta en segundos, salvo indicación contraria.

HTTP 200 · application/json
{
  "code": "Ok",
  "routes": [
    {
      "distance": 3200,
      "duration": 420,
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            49.8516,
            40.3777
          ],
          [
            49.86,
            40.4
          ]
        ]
      },
      "legs": [
        {
          "distance": 3200,
          "duration": 420,
          "steps": []
        }
      ]
    }
  ],
  "waypoints": [
    {
      "name": "Example road",
      "location": [
        49.8516,
        40.3777
      ],
      "distance": 4.2
    }
  ]
}
Errores del servicio

Corrige los parámetros ausentes o inválidos.

HTTP 400
{
  "code": "InvalidQuery",
  "error": "Coordinates must be finite longitude,latitude pairs."
}

Elige un perfil compatible. No se cambia automáticamente a coche.

HTTP 422
{
  "code": "ProfileNotAvailable",
  "error": "This travel profile is not available at one or more coordinates. No driving fallback was used."
}

La API no pudo procesar todos los puntos en una misma red vial para el perfil elegido. Envía los tramos conectados por separado.

HTTP 422
{
  "code": "CrossRegionNotSupported",
  "error": "These coordinates are not served by one routing graph. Split the request by region."
}

Comprueba que los puntos estén cerca de vías accesibles y que estas estén conectadas para el perfil elegido.

HTTP 422
{
  "code": "NoNearbyRoad",
  "error": "No connected route within 2000 metres of the requested coordinates."
}

El servicio o su fuente no están disponibles. Reintenta con cautela y esperas crecientes.

HTTP 504
{
  "code": "RoutingTimeout",
  "error": "The routing service did not respond within the request deadline. Retry later."
}

Explicación de la estructura de la respuesta

La distancia se expresa en metros y la duración en segundos. La línea predeterminada es simplificada y usa polyline. Usa overview=full para obtener la línea completa.

Matrix API

#

Calcula tiempos, distancias o ambos entre orígenes y destinos. Selecciona índices de la lista de coordenadas con sources y destinations.

GET
/api/v1/osrm/table/v1/{profile}/{coordinates}

Parámetros (Query Params)

ParámetroTipoEstadoPredeterminadoDescripción
profilestringObligatoriodrivingPerfil de transporte (driving, cycling, walking).
coordinatesstringObligatorio-Puntos de la matriz. Formato: lon,lat;lon,lat;lon,lat...
annotationsstringOpcionaldurationDatos a calcular: duration (tiempo), distance (distancia) o ambos.
sourcesstringOpcionalallÍndices de origen desde cero, separados por punto y coma, o all.
destinationsstringOpcionalallÍndices de destino desde cero, separados por punto y coma, o all.

Ejemplo de solicitud

Sustituye YOUR_KEY por tu clave API. Las solicitudes consumen créditos; copiar el ejemplo no envía ninguna solicitud.

Matrix API
curl "https://osrmroute.com/api/v1/osrm/table/v1/driving/49.85,40.37;49.86,40.40;49.83,40.39?annotations=duration,distance" -H "Authorization: Bearer YOUR_KEY"

Límites y coordenadas

Coste en créditos: max(1, ceil(cells * 2 / 5))

Ruta OSRM: lon,lat; GeoJSON: [lon,lat].

  • points ≥ 2; points ≤ plan.maxRoutePoints
  • cells = sources × destinations
  • credits = max(1, ceil(cells * 2 / 5))

Los perfiles de coche, a pie y bicicleta son mundiales. Los puntos deben conectarse por vías permitidas. El VRP es heurístico y las isócronas aproximadas; no se promete un óptimo global ni tráfico en directo.

Planes y precios actualesCobertura por servicio

Ejemplo de respuesta JSON

JSON ilustrativo y abreviado. Los valores, campos opcionales y datos cartográficos pueden variar. Las distancias están en metros y las duraciones de ruta en segundos, salvo indicación contraria.

HTTP 200 · application/json
{
  "code": "Ok",
  "durations": [
    [
      0,
      420
    ],
    [
      430,
      0
    ]
  ],
  "distances": [
    [
      0,
      3200
    ],
    [
      3300,
      0
    ]
  ],
  "sources": [
    {
      "name": "Example road",
      "location": [
        49.8516,
        40.3777
      ],
      "distance": 4.2
    },
    {
      "name": "Second road",
      "location": [
        49.86,
        40.4
      ],
      "distance": 3
    }
  ],
  "destinations": [
    {
      "name": "Example road",
      "location": [
        49.8516,
        40.3777
      ],
      "distance": 4.2
    },
    {
      "name": "Second road",
      "location": [
        49.86,
        40.4
      ],
      "distance": 3
    }
  ]
}
Errores del servicio

Corrige los parámetros ausentes o inválidos.

HTTP 400
{
  "code": "InvalidQuery",
  "error": "Coordinates must be finite longitude,latitude pairs."
}

Elige un perfil compatible. No se cambia automáticamente a coche.

HTTP 422
{
  "code": "ProfileNotAvailable",
  "error": "This travel profile is not available at one or more coordinates. No driving fallback was used."
}

La API no pudo procesar todos los puntos en una misma red vial para el perfil elegido. Envía los tramos conectados por separado.

HTTP 422
{
  "code": "CrossRegionNotSupported",
  "error": "These coordinates are not served by one routing graph. Split the request by region."
}

Comprueba que los puntos estén cerca de vías accesibles y que estas estén conectadas para el perfil elegido.

HTTP 422
{
  "code": "UnreachablePoints",
  "error": "Some locations are disconnected in this road network."
}

El servicio o su fuente no están disponibles. Reintenta con cautela y esperas crecientes.

HTTP 504
{
  "code": "RoutingTimeout",
  "error": "The routing service did not respond within the request deadline. Retry later."
}

Explicación de la estructura de la respuesta

Por defecto se devuelve la matriz durations. Usa annotations=distance para distancias o annotations=duration,distance para ambas. Las duraciones están en segundos y las distancias en metros. Si ningún grafo válido puede completar la matriz, los puntos desconectados devuelven HTTP 422 UnreachablePoints.

Map Matching API

#

Ajusta trazas GPS imprecisas a la red vial real (snap to road). Se usa para limpiar el ruido en las señales GPS.

GET
/api/v1/osrm/match/v1/{profile}/{coordinates}

Parámetros (Query Params)

ParámetroTipoEstadoPredeterminadoDescripción
geometriesstringOpcionalpolylineFormato de geometría: geojson (objeto GeoJSON), polyline (cadena codificada).
profilestringObligatoriodrivingPerfil de transporte.
coordinatesstringObligatorio-La secuencia de coordenadas GPS a ajustar (lon,lat;lon,lat...)
overviewstringOpcionalsimplifiedPrecisión de la geometría de la ruta ajustada.
timestampsstringOpcional-Marcas Unix en segundos, en orden no decreciente, una por punto, separadas por punto y coma.
radiusesstringOpcional-Precisión GPS en metros, un valor por punto, separado por punto y coma.

Ejemplo de solicitud

Sustituye YOUR_KEY por tu clave API. Las solicitudes consumen créditos; copiar el ejemplo no envía ninguna solicitud.

Map Matching API
curl "https://osrmroute.com/api/v1/osrm/match/v1/driving/49.851536,40.375480;49.844011,40.379982;49.839336,40.389620;49.837774,40.389268?overview=full&geometries=geojson" -H "Authorization: Bearer YOUR_KEY"

Límites y coordenadas

Coste en créditos: 1 credit

Ruta OSRM: lon,lat; GeoJSON: [lon,lat].

  • points ≥ 2; points ≤ plan.maxRoutePoints
  • tracepoints[]: object | null

Los perfiles de coche, a pie y bicicleta son mundiales. Los puntos deben conectarse por vías permitidas. El VRP es heurístico y las isócronas aproximadas; no se promete un óptimo global ni tráfico en directo.

Planes y precios actualesCobertura por servicio

Ejemplo de respuesta JSON

JSON ilustrativo y abreviado. Los valores, campos opcionales y datos cartográficos pueden variar. Las distancias están en metros y las duraciones de ruta en segundos, salvo indicación contraria.

HTTP 200 · application/json
{
  "code": "Ok",
  "matchings": [
    {
      "distance": 3200,
      "duration": 420,
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            49.8516,
            40.3777
          ],
          [
            49.86,
            40.4
          ]
        ]
      },
      "legs": [
        {
          "distance": 3200,
          "duration": 420,
          "steps": []
        }
      ],
      "confidence": 0.97
    }
  ],
  "tracepoints": [
    {
      "name": "Example road",
      "location": [
        49.8516,
        40.3777
      ],
      "distance": 4.2
    },
    null
  ]
}
Errores del servicio

Corrige los parámetros ausentes o inválidos.

HTTP 400
{
  "code": "InvalidQuery",
  "error": "Coordinates must be finite longitude,latitude pairs."
}

Elige un perfil compatible. No se cambia automáticamente a coche.

HTTP 422
{
  "code": "ProfileNotAvailable",
  "error": "This travel profile is not available at one or more coordinates. No driving fallback was used."
}

La API no pudo procesar todos los puntos en una misma red vial para el perfil elegido. Envía los tramos conectados por separado.

HTTP 422
{
  "code": "CrossRegionNotSupported",
  "error": "These coordinates are not served by one routing graph. Split the request by region."
}

Comprueba que los puntos estén cerca de vías accesibles y que estas estén conectadas para el perfil elegido.

HTTP 422
{
  "code": "NoNearbyRoad",
  "error": "No connected route within 2000 metres of the requested coordinates."
}

El servicio o su fuente no están disponibles. Reintenta con cautela y esperas crecientes.

HTTP 504
{
  "code": "RoutingTimeout",
  "error": "The routing service did not respond within the request deadline. Retry later."
}

Explicación de la estructura de la respuesta

matchings[]: distance — distancia (m), duration — duración (s), confidence — confianza (0–1), geometry — geometría; tracepoints[] — objeto o null.

Nearest API

#

Ajusta cualquier coordenada al segmento de carretera real más cercano (snap) y devuelve información sobre el nombre de la vía.

GET
/api/v1/osrm/nearest/v1/{profile}/{coordinates}

Parámetros (Query Params)

ParámetroTipoEstadoPredeterminadoDescripción
profilestringObligatoriodrivingPerfil de transporte.
coordinatesstringObligatorio-El punto cerca del cual buscar. Formato: lon,lat (un solo par).
numberintegerOpcional1El número de carreteras candidatas más cercanas a encontrar.

Ejemplo de solicitud

Sustituye YOUR_KEY por tu clave API. Las solicitudes consumen créditos; copiar el ejemplo no envía ninguna solicitud.

Nearest API
curl "https://osrmroute.com/api/v1/osrm/nearest/v1/driving/49.8516,40.3777?number=3" -H "Authorization: Bearer YOUR_KEY"

Límites y coordenadas

Coste en créditos: 1 credit

Ruta OSRM: lon,lat; GeoJSON: [lon,lat].

  • coordinates: 1
  • number: default = 1; example = 3

Los perfiles de coche, a pie y bicicleta son mundiales. Los puntos deben conectarse por vías permitidas. El VRP es heurístico y las isócronas aproximadas; no se promete un óptimo global ni tráfico en directo.

Planes y precios actualesCobertura por servicio

Ejemplo de respuesta JSON

JSON ilustrativo y abreviado. Los valores, campos opcionales y datos cartográficos pueden variar. Las distancias están en metros y las duraciones de ruta en segundos, salvo indicación contraria.

HTTP 200 · application/json
{
  "code": "Ok",
  "waypoints": [
    {
      "name": "Example road",
      "location": [
        49.8516,
        40.3777
      ],
      "distance": 4.2
    }
  ]
}
Errores del servicio

Corrige los parámetros ausentes o inválidos.

HTTP 400
{
  "code": "InvalidQuery",
  "error": "Coordinates must be finite longitude,latitude pairs."
}

Elige un perfil compatible. No se cambia automáticamente a coche.

HTTP 422
{
  "code": "ProfileNotAvailable",
  "error": "This travel profile is not available at one or more coordinates. No driving fallback was used."
}

Comprueba que los puntos estén cerca de vías accesibles y que estas estén conectadas para el perfil elegido.

HTTP 422
{
  "code": "NoNearbyRoad",
  "error": "No connected route within 2000 metres of the requested coordinates."
}

El servicio o su fuente no están disponibles. Reintenta con cautela y esperas crecientes.

HTTP 504
{
  "code": "RoutingTimeout",
  "error": "The routing service did not respond within the request deadline. Retry later."
}

Explicación de la estructura de la respuesta

waypoints[] → name, distance (m), location [lon,lat].

Trip API

#

Ordena las paradas de un único vehículo mediante la red vial. Para una ruta abierta, envía roundtrip=false&source=first&destination=last. El orden puede no ser óptimo.

GET
/api/v1/osrm/trip/v1/{profile}/{coordinates}

Parámetros (Query Params)

ParámetroTipoEstadoPredeterminadoDescripción
geometriesstringOpcionalpolylineFormato de geometría: geojson (objeto GeoJSON), polyline (cadena codificada).
profilestringObligatoriodrivingPerfil de transporte.
coordinatesstringObligatorio-Puntos a visitar. Formato: lon,lat;lon,lat...
sourcestringOpcionalanyEl punto desde el que puede empezar la ruta (any o el primer punto).
destinationstringOpcionalanyEl punto donde termina la ruta (any o el último punto).
roundtripbooleanOpcionaltrueVolver al punto de partida. Para false, usa source=first y destination=last.

Ejemplo de solicitud

Sustituye YOUR_KEY por tu clave API. Las solicitudes consumen créditos; copiar el ejemplo no envía ninguna solicitud.

Trip API (TSP)
curl "https://osrmroute.com/api/v1/osrm/trip/v1/driving/49.85,40.37;49.86,40.40;49.83,40.39?source=first&geometries=geojson" -H "Authorization: Bearer YOUR_KEY"

Límites y coordenadas

Coste en créditos: 5 credits

Ruta OSRM: lon,lat; GeoJSON: [lon,lat].

  • points ≥ 2; points ≤ plan.maxRoutePoints
  • credits = 5

Los perfiles de coche, a pie y bicicleta son mundiales. Los puntos deben conectarse por vías permitidas. El VRP es heurístico y las isócronas aproximadas; no se promete un óptimo global ni tráfico en directo.

Planes y precios actualesCobertura por servicio

Ejemplo de respuesta JSON

JSON ilustrativo y abreviado. Los valores, campos opcionales y datos cartográficos pueden variar. Las distancias están en metros y las duraciones de ruta en segundos, salvo indicación contraria.

HTTP 200 · application/json
{
  "code": "Ok",
  "trips": [
    {
      "distance": 3200,
      "duration": 420,
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            49.8516,
            40.3777
          ],
          [
            49.86,
            40.4
          ]
        ]
      },
      "legs": [
        {
          "distance": 3200,
          "duration": 420,
          "steps": []
        }
      ]
    }
  ],
  "waypoints": [
    {
      "name": "Example road",
      "location": [
        49.8516,
        40.3777
      ],
      "distance": 4.2,
      "trips_index": 0,
      "waypoint_index": 0
    }
  ]
}
Errores del servicio

Corrige los parámetros ausentes o inválidos.

HTTP 400
{
  "code": "InvalidQuery",
  "error": "Coordinates must be finite longitude,latitude pairs."
}

Elige un perfil compatible. No se cambia automáticamente a coche.

HTTP 422
{
  "code": "ProfileNotAvailable",
  "error": "This travel profile is not available at one or more coordinates. No driving fallback was used."
}

La API no pudo procesar todos los puntos en una misma red vial para el perfil elegido. Envía los tramos conectados por separado.

HTTP 422
{
  "code": "CrossRegionNotSupported",
  "error": "These coordinates are not served by one routing graph. Split the request by region."
}

Comprueba que los puntos estén cerca de vías accesibles y que estas estén conectadas para el perfil elegido.

HTTP 422
{
  "code": "NoNearbyRoad",
  "error": "No connected route within 2000 metres of the requested coordinates."
}

El servicio o su fuente no están disponibles. Reintenta con cautela y esperas crecientes.

HTTP 504
{
  "code": "RoutingTimeout",
  "error": "The routing service did not respond within the request deadline. Retry later."
}

Explicación de la estructura de la respuesta

trips[]: distance — distancia (m), duration — duración (s), geometry — geometría; waypoints[]: trips_index, waypoint_index — índices de orden, location [lon,lat] — coordenadas.

Directions API

#

Devuelve navegación paso a paso entre dos o más puntos con una lista de instrucciones limpia (texto, distancia, duración, tipo de maniobra y ubicación). Admite coche, bici y a pie, además de hasta 3 rutas alternativas en una sola llamada.

GET
/api/1/directions

Parámetros (Query Params)

ParámetroTipoEstadoPredeterminadoDescripción
pointstringObligatoriolat,lngPunto como lat,lng. Repite el parámetro por cada parada (mínimo 2).
profilestringOpcionaldrivingModo de transporte: driving, cycling o walking.
alternativesintegerOpcional0Número de rutas alternativas adicionales a devolver (0–3).
langstringOpcionalenCódigo de idioma para el texto de las instrucciones.

Ejemplo de solicitud

Sustituye YOUR_KEY por tu clave API. Las solicitudes consumen créditos; copiar el ejemplo no envía ninguna solicitud.

Directions API
curl "https://osrmroute.com/api/1/directions?point=40.3777,49.8516&point=40.40,49.86&profile=driving" -H "Authorization: Bearer YOUR_KEY"
Alternative Routes API
curl "https://osrmroute.com/api/1/directions?point=40.3777,49.8516&point=40.40,49.86&alternatives=2" -H "Authorization: Bearer YOUR_KEY"

Límites y coordenadas

Coste en créditos: 1 crédito por cada bloque iniciado de 10 puntos de entrada, incluidos origen y destino.

Route, Directions y Truck Routing: una solicitud procesada sin carretera accesible cercana o sin ruta conectada cuesta una sola vez 0,5 créditos en todos los planes aptos, incluido PAYG. No se cobran entradas inválidas, rechazos de acceso/plan o cobertura del grafo ni errores del servidor. Primero se reserva el precio de una solicitud correcta y se devuelve el resto.

Entrada point=lat,lng. Instrucciones y puntos de paso: [lat,lng]; GeoJSON: [lon,lat].

  • point: repeat ≥ 2; count ≤ plan.maxRoutePoints
  • alternatives: 0–3

Los perfiles de coche, a pie y bicicleta son mundiales. Los puntos deben conectarse por vías permitidas. El VRP es heurístico y las isócronas aproximadas; no se promete un óptimo global ni tráfico en directo.

Planes y precios actualesCobertura por servicio

Ejemplo de respuesta JSON

JSON ilustrativo y abreviado. Los valores, campos opcionales y datos cartográficos pueden variar. Las distancias están en metros y las duraciones de ruta en segundos, salvo indicación contraria.

HTTP 200 · application/json
{
  "code": "Ok",
  "profile": "driving",
  "routes": [
    {
      "distance": 3200,
      "duration": 420,
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            49.8516,
            40.3777
          ],
          [
            49.86,
            40.4
          ]
        ]
      },
      "instructions": [
        {
          "text": "Continue on Example road",
          "type": "continue",
          "modifier": "straight",
          "distance": 300,
          "duration": 40,
          "name": "Example road",
          "bearing_after": 90,
          "location": [
            40.3777,
            49.8516
          ]
        }
      ]
    }
  ],
  "waypoints": [
    {
      "name": "Example road",
      "location": [
        40.3777,
        49.8516
      ]
    }
  ]
}
Errores del servicio

Corrige los parámetros ausentes o inválidos.

HTTP 400
{
  "error": "At least two points must be provided (point=lat,lng repeated)."
}

Elige un perfil compatible. No se cambia automáticamente a coche.

HTTP 422
{
  "code": "ProfileNotAvailable",
  "error": "This travel profile is not available at one or more coordinates. No driving fallback was used."
}

La API no pudo procesar todos los puntos en una misma red vial para el perfil elegido. Envía los tramos conectados por separado.

HTTP 422
{
  "code": "CrossRegionNotSupported",
  "error": "These coordinates are not served by one routing graph. Split the request by region."
}

Comprueba que los puntos estén cerca de vías accesibles y que estas estén conectadas para el perfil elegido.

HTTP 422
{
  "code": "NoNearbyRoad",
  "error": "No connected route within 2000 metres of the requested coordinates."
}

El servicio o su fuente no están disponibles. Reintenta con cautela y esperas crecientes.

HTTP 504
{
  "code": "RoutingTimeout",
  "error": "The routing service did not respond within the request deadline. Retry later."
}

Explicación de la estructura de la respuesta

Devuelve { code, profile, routes[], waypoints[] }. Cada ruta tiene distance (m), duration (s), una geometría GeoJSON y un array instructions[]; cada instrucción incluye text, type, modifier, distance, duration, name y location [lat,lng].

Snap to Road API

#

Ajusta puntos GPS crudos e imprecisos a la posición más cercana de la red vial. Repite el parámetro point por cada coordenada (hasta 100).

GET
/api/1/snap

Parámetros (Query Params)

ParámetroTipoEstadoPredeterminadoDescripción
pointstringObligatoriolat,lngPunto GPS como lat,lng. Repite el parámetro por cada punto (máximo 100).
profilestringOpcionaldrivingRed vial a la que ajustar: driving, cycling o walking.

Ejemplo de solicitud

Sustituye YOUR_KEY por tu clave API. Las solicitudes consumen créditos; copiar el ejemplo no envía ninguna solicitud.

Snap to Road API
curl "https://osrmroute.com/api/1/snap?point=40.3778,49.8517&point=40.3801,49.8600" -H "Authorization: Bearer YOUR_KEY"

Límites y coordenadas

Coste en créditos: 1 credit

point=lat,lng; puntos JSON: [lat,lng]. Geometría GeoJSON: [lon,lat].

  • point: repeat 1–100

Los perfiles de coche, a pie y bicicleta son mundiales. Los puntos deben conectarse por vías permitidas. El VRP es heurístico y las isócronas aproximadas; no se promete un óptimo global ni tráfico en directo.

Planes y precios actualesCobertura por servicio

Ejemplo de respuesta JSON

JSON ilustrativo y abreviado. Los valores, campos opcionales y datos cartográficos pueden variar. Las distancias están en metros y las duraciones de ruta en segundos, salvo indicación contraria.

HTTP 200 · application/json
{
  "code": "Ok",
  "profile": "driving",
  "snapped": [
    {
      "input": [
        40.3777,
        49.8516
      ],
      "snapped": [
        40.3778,
        49.8517
      ],
      "distance": 14,
      "name": "Example road"
    }
  ]
}
Errores del servicio

Corrige los parámetros ausentes o inválidos.

HTTP 400
{
  "error": "At least one point must be provided (point=lat,lng repeated)."
}

Elige un perfil compatible. No se cambia automáticamente a coche.

HTTP 422
{
  "code": "ProfileNotAvailable",
  "error": "This travel profile is not available at one or more coordinates. No driving fallback was used."
}

Comprueba que los puntos estén cerca de vías accesibles y que estas estén conectadas para el perfil elegido.

HTTP 422
{
  "code": "NoNearbyRoad",
  "error": "No connected route within 2000 metres of the requested coordinates."
}

El servicio o su fuente no están disponibles. Reintenta con cautela y esperas crecientes.

HTTP 504
{
  "code": "RoutingTimeout",
  "error": "The routing service did not respond within the request deadline. Retry later."
}

Explicación de la estructura de la respuesta

Devuelve { code, profile, snapped[] }. Cada elemento incluye el input original [lat,lng], la posición ajustada [lat,lng], la distancia de ajuste en metros y el nombre de la vía.

Geocoding API

#

Convierte un texto de búsqueda en coordenadas geográficas (directa) o coordenadas en una dirección (inversa). Autocompletado rápido y tolerante a errores tipográficos que cubre calles, direcciones y puntos de interés (cafés, tiendas, hoteles, oficinas). Ideal para buscar mientras se escribe.

GET
/api/1/geocode

Parámetros (Query Params)

ParámetroTipoEstadoPredeterminadoDescripción
qstringOpcional-La dirección a buscar (p. ej.: «Calle Nizami, Bakú»).
reversebooleanOpcionalfalseDebe ser true para realizar geocodificación inversa (búsqueda de coordenada a dirección).
pointstringOpcionallat,lngCoordenada (lat,lng) para geocodificación inversa a una dirección. Obligatorio cuando reverse=true.
limitintegerOpcional5Número máximo de resultados a devolver (1–20, por defecto 5).
langstringOpcionalenIdioma preferido para los nombres de resultados (p. ej. en, az, ru). Por defecto en.
latnumberOpcional-Latitud para sesgar los resultados (los cercanos primero). Junto con lon.
lonnumberOpcional-Longitud para sesgar los resultados. Junto con lat.
bboxstringOpcional-Limitar resultados a un cuadro: minLon,minLat,maxLon,maxLat.
osm_tagstringOpcional-Filtrar por etiqueta OSM, p. ej. place (localidades) o amenity:cafe. Prefijo ! para excluir.
countrystringOpcional-Código de país ISO 3166-1 alpha-2, por ejemplo AZ. Solo resultados de ese país.
citystringOpcional-Filtro estricto de ciudad, por ejemplo Baku. Requiere exactamente un código country.
elasticbooleanOpcionaltrueBúsqueda elástica (difusa, alta cobertura) — true por defecto. Tolera erratas, falta de diacríticos (ə↔e), orden de palabras, palabras genéricas (metro, rayonu) y números de casa. false para coincidencia estricta.

Filtros de país y ciudad

Sin country, la búsqueda es global. country=AZ limita los resultados a Azerbaiyán; country=AZ&city=Bakı a Bakú en Azerbaiyán. Sin coincidencias se devuelve HTTP 200 con una lista vacía, sin ampliar la zona. Una ciudad sin país o un código de país inválido devuelve HTTP 400 InvalidGeocodeFilter. lat/lon solo afectan al orden por proximidad. Se excluyen los registros sin ciudad confirmada cuando se filtra por ciudad.

Ejemplos
GET /api/1/geocode?q=Nizami&country=AZ
GET /api/1/geocode?q=Nizami&country=AZ&city=Bak%C4%B1

HTTP 200: { "hits": [], "took": 12 }
HTTP 400: { "code": "InvalidGeocodeFilter", "error": "city requires exactly one country, for example country=AZ&city=Bakı." }

Ejemplos

Ejemplos
# Sesgar a una ubicación, solo localidades
GET /api/1/geocode?q=qala&lat=40.41&lon=49.87&osm_tag=place

# Solo el país y la ciudad seleccionados
GET /api/1/geocode?q=market&country=AZ&city=Bak%C4%B1

# Geocodificación inversa (coordenadas a dirección)
GET /api/1/geocode?reverse=true&point=40.409,49.867

Para una búsqueda exacta, indica la calle y el número en q. locality y postcode requieren un único país. unit selecciona una unidad exacta de la fuente y activa address_mode=units. El modo buildings predeterminado agrupa los registros de unidades que comparten ubicación.

GET
/api/1/geocode?q=101+Main+Street&country=US&locality=Boston&postcode=02129&unit=2&address_mode=units

Ejemplo de solicitud

Sustituye YOUR_KEY por tu clave API. Las solicitudes consumen créditos; copiar el ejemplo no envía ninguna solicitud.

Geocoding API
curl "https://osrmroute.com/api/1/geocode?q=Nizami&country=AZ&city=Bak%C4%B1&lang=az" -H "Authorization: Bearer YOUR_KEY"

Límites y coordenadas

Coste en créditos: 1 credit

point=lat,lng; puntos JSON: [lat,lng]. Geometría GeoJSON: [lon,lat].

  • limit: 1–20
  • reverse: max_distance_m = 1000
  • city: exactly 1 country

Una respuesta correcta sin coincidencias puede incluir una lista vacía. Los filtros de país/ciudad no se amplían. El detalle de direcciones depende del índice.

Planes y precios actualesCobertura por servicio

Ejemplo de respuesta JSON

JSON ilustrativo y abreviado. Los valores, campos opcionales y datos cartográficos pueden variar. Las distancias están en metros y las duraciones de ruta en segundos, salvo indicación contraria.

HTTP 200 · application/json
{
  "hits": [
    {
      "name": "Nizami Street",
      "city": "Baku",
      "country": "Azerbaijan",
      "countrycode": "AZ",
      "point": {
        "lat": 40.3777,
        "lng": 49.8516
      }
    }
  ],
  "took": 12
}
Errores del servicio

Corrige los parámetros ausentes o inválidos.

HTTP 400
{
  "error": "The \"q\" parameter (search text) is required."
}

Corrige los parámetros ausentes o inválidos.

HTTP 400
{
  "code": "InvalidGeocodeFilter",
  "error": "city requires exactly one country, for example country=AZ&city=Bakı."
}

No hay dirección o lugar indexado en el radio de búsqueda inversa.

HTTP 422
{
  "code": "NoNearbyAddress",
  "error": "No indexed address or place within 1 km."
}

Explicación de la estructura de la respuesta

hits[]: name, city, country, countrycode — lugar y país, point (lat,lng) — coordenadas; took — tiempo (ms). reverse=true: source — fuente, accuracy — precisión, distance_m — distancia.

Lugares (POI cercanos)

#

Encuentra puntos de interés cerca de una ubicación — cafés, tiendas, hoteles, cajeros, farmacias y más — filtrados por categoría y radio, ordenados por distancia.

GET
/api/1/places

Parámetros (Query Params)

ParámetroTipoEstadoPredeterminadoDescripción
pointstringObligatoriolat,lngCoordenada central lat,lng para buscar (obligatorio).
radiusnumberOpcional1Radio de búsqueda en kilómetros (0.05–20, por defecto 1).
categorystringOpcional-Filtro por etiqueta OSM, p. ej. amenity:cafe, shop, tourism:hotel. Prefijo ! para excluir. Vacío = todos los POI.
limitintegerOpcional10Máx. resultados (1–50, por defecto 10).
langstringOpcionalenIdioma preferido para los nombres (p. ej. en, az, ru).

Ejemplo de solicitud

Sustituye YOUR_KEY por tu clave API. Las solicitudes consumen créditos; copiar el ejemplo no envía ninguna solicitud.

Places API
curl "https://osrmroute.com/api/1/places?point=40.371,49.845&radius=1&category=amenity:cafe" -H "Authorization: Bearer YOUR_KEY"

Límites y coordenadas

Coste en créditos: 1 credit

point=lat,lng; puntos JSON: [lat,lng]. Geometría GeoJSON: [lon,lat].

  • radius: 0.05–20 km
  • limit: 1–50

Una respuesta correcta sin coincidencias puede incluir una lista vacía. Los filtros de país/ciudad no se amplían. El detalle de direcciones depende del índice.

Planes y precios actualesCobertura por servicio

Ejemplo de respuesta JSON

JSON ilustrativo y abreviado. Los valores, campos opcionales y datos cartográficos pueden variar. Las distancias están en metros y las duraciones de ruta en segundos, salvo indicación contraria.

HTTP 200 · application/json
{
  "places": [
    {
      "name": "Example cafe",
      "category": "amenity",
      "type": "cafe",
      "distance_m": 85,
      "point": {
        "lat": 40.3777,
        "lng": 49.8516
      }
    }
  ],
  "took": 12
}
Errores del servicio

Corrige los parámetros ausentes o inválidos.

HTTP 400
{
  "error": "The \"point\" parameter (lat,lng) is required."
}

El servicio o su fuente no están disponibles. Reintenta con cautela y esperas crecientes.

HTTP 502
{
  "error": "Places service unavailable."
}

Explicación de la estructura de la respuesta

places[]: name, category, type — datos del lugar, distance_m — distancia, point (lat,lng) — coordenadas; took — tiempo (ms).

Autocomplete API

#

Sugerencias de lugares rápidas y tolerantes a errores mientras el usuario escribe, con sesgo por ubicación.

GET
/api/1/autocomplete

Parámetros (Query Params)

ParámetroTipoEstadoPredeterminadoDescripción
qstringObligatorio-Texto de búsqueda — se admite entrada parcial.
limitintegerOpcional8Número máximo de sugerencias (1–15).
langstringOpcionalenCódigo de idioma para las etiquetas.
latnumberOpcional-Latitud para sesgar resultados (opcional).
lonnumberOpcional-Longitud para sesgar resultados (opcional).
countrystringOpcional-Código de país ISO 3166-1 alpha-2, por ejemplo AZ. Solo resultados de ese país.
citystringOpcional-Filtro estricto de ciudad, por ejemplo Baku. Requiere exactamente un código country.
osm_tagstringOpcional-Filtra las sugerencias por tipo OSM, p. ej. place:city.

Filtros de país y ciudad

Sin country, la búsqueda es global. country=AZ limita los resultados a Azerbaiyán; country=AZ&city=Bakı a Bakú en Azerbaiyán. Sin coincidencias se devuelve HTTP 200 con una lista vacía, sin ampliar la zona. Una ciudad sin país o un código de país inválido devuelve HTTP 400 InvalidGeocodeFilter. lat/lon solo afectan al orden por proximidad. Se excluyen los registros sin ciudad confirmada cuando se filtra por ciudad.

Ejemplos
GET /api/1/autocomplete?q=Nizami&country=AZ
GET /api/1/autocomplete?q=Nizami&country=AZ&city=Bak%C4%B1

HTTP 200: { "suggestions": [], "took": 12 }
HTTP 400: { "code": "InvalidGeocodeFilter", "error": "city requires exactly one country, for example country=AZ&city=Bakı." }

Ejemplo de solicitud

Sustituye YOUR_KEY por tu clave API. Las solicitudes consumen créditos; copiar el ejemplo no envía ninguna solicitud.

Autocomplete API
curl "https://osrmroute.com/api/1/autocomplete?q=niz&lang=az&lat=40.40&lon=49.86" -H "Authorization: Bearer YOUR_KEY"

Límites y coordenadas

Coste en créditos: 1 credit

point=lat,lng; puntos JSON: [lat,lng]. Geometría GeoJSON: [lon,lat].

  • limit: 1–15
  • city: exactly 1 country

Una respuesta correcta sin coincidencias puede incluir una lista vacía. Los filtros de país/ciudad no se amplían. El detalle de direcciones depende del índice.

Planes y precios actualesCobertura por servicio

Ejemplo de respuesta JSON

JSON ilustrativo y abreviado. Los valores, campos opcionales y datos cartográficos pueden variar. Las distancias están en metros y las duraciones de ruta en segundos, salvo indicación contraria.

HTTP 200 · application/json
{
  "suggestions": [
    {
      "name": "Nizami Street",
      "city": "Baku",
      "country": "Azerbaijan",
      "countrycode": "AZ",
      "point": {
        "lat": 40.3777,
        "lng": 49.8516
      },
      "label": "Nizami Street, Baku, Azerbaijan"
    }
  ],
  "took": 12
}
Errores del servicio

Corrige los parámetros ausentes o inválidos.

HTTP 400
{
  "error": "The \"q\" parameter (search text) is required."
}

Corrige los parámetros ausentes o inválidos.

HTTP 400
{
  "code": "InvalidGeocodeFilter",
  "error": "city requires exactly one country, for example country=AZ&city=Bakı."
}

Explicación de la estructura de la respuesta

Devuelve { suggestions[], took }. Cada sugerencia tiene label, name, city, state, country, countrycode, type, osm_id y point {lat,lng}.

Batch Geocoding API

#

Geocodifica hasta 100 direcciones por solicitud. Los resultados siguen el orden de entrada y cada dirección cuesta un crédito.

POST
/api/1/geocode/batch

Parámetros (Query Params)

ParámetroTipoEstadoPredeterminadoDescripción
queriesarrayObligatorio[]Array de direcciones a geocodificar (máx. 100).
langstringOpcionalenCódigo de idioma para las etiquetas.
limitintegerOpcional1Coincidencias máximas por consulta (1–5).

Ejemplo de solicitud

Sustituye YOUR_KEY por tu clave API. Las solicitudes consumen créditos; copiar el ejemplo no envía ninguna solicitud.

Batch Geocoding API
curl -X POST "https://osrmroute.com/api/1/geocode/batch" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"queries":["Nizami küçəsi 10","28 May, Bakı"],"lang":"az"}'

Límites y coordenadas

Coste en créditos: 1 credit / query

Consulta los campos JSON; esta solicitud no requiere un par de coordenadas.

  • queries: 1–100
  • limit: 1–5 / query
  • credits = queries.length

Una respuesta correcta sin coincidencias puede incluir una lista vacía. Los filtros de país/ciudad no se amplían. El detalle de direcciones depende del índice.

Planes y precios actualesCobertura por servicio

Ejemplo de respuesta JSON

JSON ilustrativo y abreviado. Los valores, campos opcionales y datos cartográficos pueden variar. Las distancias están en metros y las duraciones de ruta en segundos, salvo indicación contraria.

HTTP 200 · application/json
{
  "results": [
    {
      "query": "Baku",
      "hits": [
        {
          "name": "Nizami Street",
          "city": "Baku",
          "country": "Azerbaijan",
          "countrycode": "AZ",
          "point": {
            "lat": 40.3777,
            "lng": 49.8516
          }
        }
      ]
    }
  ],
  "count": 1,
  "took": 12
}
Errores del servicio

Corrige los parámetros ausentes o inválidos.

HTTP 400
{
  "error": "Body must include a non-empty \"queries\" array of address strings."
}

Corrige los parámetros ausentes o inválidos.

HTTP 400
{
  "error": "A maximum of 100 queries can be geocoded per batch request."
}

Explicación de la estructura de la respuesta

Devuelve { results[], count, took }. Cada resultado empareja la consulta de entrada con un array hits[]; cada coincidencia incluye label, city, country y point {lat,lng}. Se conserva el orden de entrada.

Timezone API

#

Zona horaria IANA, desfase UTC actual, estado del horario de verano y hora local para cualquier coordenada.

GET
/api/1/timezone

Parámetros (Query Params)

ParámetroTipoEstadoPredeterminadoDescripción
pointstringOpcional-Envía point=lat,lng o ambos parámetros lat y lon.
latnumberOpcional-Latitud (alternativa a point).
lonnumberOpcional-Longitud (alternativa a point).
timestampstringOpcionalnowHora Unix (segundos) o fecha ISO para resolver el desfase; por defecto ahora.

Ejemplo de solicitud

Sustituye YOUR_KEY por tu clave API. Las solicitudes consumen créditos; copiar el ejemplo no envía ninguna solicitud.

Timezone API
curl "https://osrmroute.com/api/1/timezone?point=40.4093,49.8671" -H "Authorization: Bearer YOUR_KEY"

Límites y coordenadas

Coste en créditos: 1 credit

point=lat,lng; puntos JSON: [lat,lng]. Geometría GeoJSON: [lon,lat].

  • timestamp: Unix seconds | ISO 8601; default = now
  • utc_offset_seconds: seconds

Valida el formato de entrada y las unidades indicadas.

Planes y precios actualesCobertura por servicio

Ejemplo de respuesta JSON

JSON ilustrativo y abreviado. Los valores, campos opcionales y datos cartográficos pueden variar. Las distancias están en metros y las duraciones de ruta en segundos, salvo indicación contraria.

HTTP 200 · application/json
{
  "timezone": "Asia/Baku",
  "point": {
    "lat": 40.3777,
    "lng": 49.8516
  },
  "utc_offset": "+04:00",
  "utc_offset_seconds": 14400,
  "dst": false,
  "abbreviation": "GMT+4",
  "local_time": "2026-01-01T16:00:00",
  "utc_time": "2026-01-01T12:00:00.000Z"
}
Errores del servicio

Corrige los parámetros ausentes o inválidos.

HTTP 400
{
  "error": "Provide a valid coordinate via point=lat,lng or lat= & lon=."
}

Explicación de la estructura de la respuesta

Devuelve { timezone, point, utc_offset, utc_offset_seconds, dst, abbreviation, local_time, utc_time }. utc_offset es una cadena +HH:MM, dst es true cuando rige el horario de verano y local_time es una marca ISO con el desfase de la zona.

Elevation API

#

Altura sobre el nivel del mar, en metros, para cualquier coordenada — un punto o el perfil de toda una ruta.

GET
/api/1/elevation

Parámetros (Query Params)

ParámetroTipoEstadoPredeterminadoDescripción
pointstringObligatoriolat,lngCoordenada como lat,lng. Repite por cada punto (hasta 100 en GET).

Ejemplo de solicitud

Sustituye YOUR_KEY por tu clave API. Las solicitudes consumen créditos; copiar el ejemplo no envía ninguna solicitud.

Elevation API
curl "https://osrmroute.com/api/1/elevation?point=40.4093,49.8671&point=41.30,48.50" -H "Authorization: Bearer YOUR_KEY"

Límites y coordenadas

Coste en créditos: 1 credit / 10 points

point=lat,lng; puntos JSON: [lat,lng]. Geometría GeoJSON: [lon,lat].

  • GET: point count = 1–100
  • POST: points count = 1–1000
  • credits = max(1, ceil(points / 10))
  • elevation: number | null
  • GET with 1 point: elevation alias

La elevación puede ser null si no hay datos. No sustituyas datos desconocidos por cero.

Planes y precios actualesCobertura por servicio

Ejemplo de respuesta JSON

JSON ilustrativo y abreviado. Los valores, campos opcionales y datos cartográficos pueden variar. Las distancias están en metros y las duraciones de ruta en segundos, salvo indicación contraria.

HTTP 200 · application/json
{
  "results": [
    {
      "point": {
        "lat": 40.3777,
        "lng": 49.8516
      },
      "elevation": null
    }
  ],
  "unit": "meters"
}
Errores del servicio

Corrige los parámetros ausentes o inválidos.

HTTP 400
{
  "error": "Provide at least one point=lat,lng (repeatable)."
}

Corrige los parámetros ausentes o inválidos.

HTTP 400
{
  "error": "A maximum of 100 points can be queried per GET request; use POST for larger batches."
}

Explicación de la estructura de la respuesta

Devuelve { results[], unit:"meters" }, donde cada resultado es { point:{lat,lng}, elevation }. elevation son metros sobre el nivel del mar (null si se desconoce, 0 sobre el mar). Para un solo punto también se incluye elevation en el nivel superior. Para lotes grandes, POST { points:[[lat,lng],...] } (hasta 1000).

Boundary Lookup API

#

Averigua en qué país, estado, ciudad y distrito cae una coordenada — con el polígono de límite si se solicita.

GET
/api/1/boundary

Parámetros (Query Params)

ParámetroTipoEstadoPredeterminadoDescripción
pointstringObligatoriolat,lngCoordenada como lat,lng.
polygonbooleanOpcionalfalsetrue para devolver también el límite como GeoJSON.
langstringOpcionalenCódigo de idioma para los nombres.

Ejemplo de solicitud

Sustituye YOUR_KEY por tu clave API. Las solicitudes consumen créditos; copiar el ejemplo no envía ninguna solicitud.

Boundary Lookup API
curl "https://osrmroute.com/api/1/boundary?point=40.4093,49.8671" -H "Authorization: Bearer YOUR_KEY"

Límites y coordenadas

Coste en créditos: 1 credit

point=lat,lng; puntos JSON: [lat,lng]. Geometría GeoJSON: [lon,lat].

  • polygon: true | false
  • HTTP 422: BoundaryCoverageUnavailable

Los límites detallados solo existen en conjuntos regionales aceptados. Otros puntos devuelven BoundaryCoverageUnavailable.

Planes y precios actualesCobertura por servicio

Ejemplo de respuesta JSON

JSON ilustrativo y abreviado. Los valores, campos opcionales y datos cartográficos pueden variar. Las distancias están en metros y las duraciones de ruta en segundos, salvo indicación contraria.

HTTP 200 · application/json
{
  "point": {
    "lat": 40.3777,
    "lng": 49.8516
  },
  "display_name": "Baku, Azerbaijan",
  "boundary_scope": "city",
  "country": "Azerbaijan",
  "countrycode": "AZ",
  "city": "Baku",
  "boundary": {
    "type": "Polygon",
    "coordinates": [
      [
        [
          49.84,
          40.37
        ],
        [
          49.87,
          40.37
        ],
        [
          49.87,
          40.4
        ],
        [
          49.84,
          40.37
        ]
      ]
    ]
  }
}
Errores del servicio

Corrige los parámetros ausentes o inválidos.

HTTP 400
{
  "error": "Provide a valid coordinate via point=lat,lng or lat= & lon=."
}

No hay datos administrativos detallados aquí. Consulta la cobertura.

HTTP 422
{
  "code": "BoundaryCoverageUnavailable",
  "error": "Detailed administrative boundary data is not available at this coordinate."
}

Explicación de la estructura de la respuesta

Devuelve { point, display_name, country, countrycode, state, county, city, district, postcode, osm_id, osm_type } y, con polygon=true, una geometría de límite GeoJSON.

Geofencing API

#

Comprueba en una llamada en cuáles de tus zonas cae cada punto — vallas poligonales o circulares.

POST
/api/1/geofence

Parámetros (Query Params)

ParámetroTipoEstadoPredeterminadoDescripción
fencesarrayObligatorio[]Array de vallas: { id?, polygon:[[lat,lng],...] } o { id?, center:[lat,lng], radius_m }. Hasta 100.
pointsarrayObligatorio[]Array de puntos [lat,lng] a comprobar (hasta 1000).

Ejemplo de solicitud

Sustituye YOUR_KEY por tu clave API. Las solicitudes consumen créditos; copiar el ejemplo no envía ninguna solicitud.

Geofencing API
curl -X POST "https://osrmroute.com/api/1/geofence" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fences":[{"id":"zone1","polygon":[[40.40,49.85],[40.43,49.85],[40.43,49.90],[40.40,49.90]]}],"points":[[40.41,49.87],[40.50,50.10]]}'

Límites y coordenadas

Coste en créditos: 1 credit / 100 points

point=lat,lng; puntos JSON: [lat,lng]. Geometría GeoJSON: [lon,lat].

  • fences: 1–100
  • points: 1–1000
  • credits = max(1, ceil(points / 100))

Valida el formato de entrada y las unidades indicadas.

Planes y precios actualesCobertura por servicio

Ejemplo de respuesta JSON

JSON ilustrativo y abreviado. Los valores, campos opcionales y datos cartográficos pueden variar. Las distancias están en metros y las duraciones de ruta en segundos, salvo indicación contraria.

HTTP 200 · application/json
{
  "results": [
    {
      "point": {
        "lat": 40.3777,
        "lng": 49.8516
      },
      "inside": [
        "depot"
      ]
    }
  ],
  "count": 1,
  "took": 1
}
Errores del servicio

Corrige los parámetros ausentes o inválidos.

HTTP 400
{
  "error": "Body must include non-empty \"fences\" and \"points\" arrays."
}

Corrige los parámetros ausentes o inválidos.

HTTP 400
{
  "error": "Limits: up to 100 fences and 1000 points per request."
}

Explicación de la estructura de la respuesta

Devuelve { results[], count }. Cada resultado es { point:{lat,lng}, inside:[fenceId,...] } con todas las vallas en las que cae el punto (vacío si ninguna).

Elevation Profile API

#

Altitud en cada punto de una ruta más ascenso, descenso y distancia totales — un perfil completo.

POST
/api/1/elevation/profile

Parámetros (Query Params)

ParámetroTipoEstadoPredeterminadoDescripción
pointsarrayOpcional[]Array de puntos [lat,lng] de la ruta (>=2, hasta 2000).
polylinestringOpcional-Polyline codificada como alternativa a points.

Ejemplo de solicitud

Sustituye YOUR_KEY por tu clave API. Las solicitudes consumen créditos; copiar el ejemplo no envía ninguna solicitud.

Elevation Profile API
curl -X POST "https://osrmroute.com/api/1/elevation/profile" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"points":[[40.37,49.85],[40.80,48.90],[41.30,48.05]]}'

Límites y coordenadas

Coste en créditos: 1 credit / 10 points

point=lat,lng; puntos JSON: [lat,lng]. Geometría GeoJSON: [lon,lat].

  • points: 2–2000
  • credits = max(1, ceil(points / 10))
  • elevation: number | null

La elevación puede ser null si no hay datos. No sustituyas datos desconocidos por cero.

Planes y precios actualesCobertura por servicio

Ejemplo de respuesta JSON

JSON ilustrativo y abreviado. Los valores, campos opcionales y datos cartográficos pueden variar. Las distancias están en metros y las duraciones de ruta en segundos, salvo indicación contraria.

HTTP 200 · application/json
{
  "profile": [
    {
      "point": {
        "lat": 40.3777,
        "lng": 49.8516
      },
      "elevation": null,
      "distance": 0
    },
    {
      "point": {
        "lat": 40.4,
        "lng": 49.86
      },
      "elevation": null,
      "distance": 2590
    }
  ],
  "total_ascent": 0,
  "total_descent": 0,
  "min_elevation": null,
  "max_elevation": null,
  "distance": 2590,
  "unit": "meters",
  "took": 12
}
Errores del servicio

Corrige los parámetros ausentes o inválidos.

HTTP 400
{
  "error": "Provide a \"points\" array (>=2 [lat,lng]) or an encoded \"polyline\"."
}

Corrige los parámetros ausentes o inválidos.

HTTP 400
{
  "error": "A maximum of 2000 points is allowed per request."
}

Explicación de la estructura de la respuesta

Devuelve { profile[], total_ascent, total_descent, min_elevation, max_elevation, distance, unit }. Cada elemento { point, elevation, distance } (metros).

Solar API

#

Amanecer, atardecer, crepúsculo, mediodía solar y duración del día para cualquier coordenada y fecha.

GET
/api/1/solar

Parámetros (Query Params)

ParámetroTipoEstadoPredeterminadoDescripción
pointstringObligatoriolat,lngCoordenada como lat,lng.
datestringOpcionaltodayFecha (YYYY-MM-DD) a calcular; por defecto hoy.

Ejemplo de solicitud

Sustituye YOUR_KEY por tu clave API. Las solicitudes consumen créditos; copiar el ejemplo no envía ninguna solicitud.

Solar API
curl "https://osrmroute.com/api/1/solar?point=40.4093,49.8671&date=2026-07-07" -H "Authorization: Bearer YOUR_KEY"

Límites y coordenadas

Coste en créditos: 1 credit

point=lat,lng; puntos JSON: [lat,lng]. Geometría GeoJSON: [lon,lat].

  • date: YYYY-MM-DD; default = today
  • times: UTC ISO 8601 | null

Las horas solares pueden ser null durante el día o la noche polar. Las horas están en UTC.

Planes y precios actualesCobertura por servicio

Ejemplo de respuesta JSON

JSON ilustrativo y abreviado. Los valores, campos opcionales y datos cartográficos pueden variar. Las distancias están en metros y las duraciones de ruta en segundos, salvo indicación contraria.

HTTP 200 · application/json
{
  "point": {
    "lat": 40.3777,
    "lng": 49.8516
  },
  "date": "2026-01-01",
  "sunrise": "2026-01-01T04:00:00.000Z",
  "sunset": "2026-01-01T13:00:00.000Z",
  "solar_noon": "2026-01-01T08:30:00.000Z",
  "day_length_seconds": 32400
}
Errores del servicio

Corrige los parámetros ausentes o inválidos.

HTTP 400
{
  "error": "Provide a valid coordinate via point=lat,lng or lat= & lon=."
}

Explicación de la estructura de la respuesta

Devuelve { point, date, sunrise, sunset, solar_noon, dawn, dusk, golden_hour, night_start, night_end, day_length_seconds }. Horas en UTC ISO; null en día/noche polar.

Geometry Utilities API

#

Distancia, rumbo, área, centroide, simplificación y polyline encode/decode — matemática espacial como servicio.

POST
/api/1/geometry

Parámetros (Query Params)

ParámetroTipoEstadoPredeterminadoDescripción
opstringObligatoriodistanceOperación: distance, bearing, destination, midpoint, length, area, centroid, simplify, polyline_encode o polyline_decode.
fromarrayOpcional[lat,lng]Punto inicial [lat,lng].
toarrayOpcional[lat,lng]Punto final [lat,lng].
patharrayOpcional[]Array de [lat,lng] (length/simplify/polyline_encode).
polygonarrayOpcional[]Anillo [lat,lng] (area).
op → JSON
distance, bearing, midpoint → from, to
destination → from, bearing (°), distance_m
length → path (≥ 2)
area → polygon (≥ 3)
centroid → points (≥ 1)
simplify → path (2–2000), tolerance_m (10)
polyline_encode → path (≥ 1), precision (5)
polyline_decode → polyline, precision (5)

Ejemplo de solicitud

Sustituye YOUR_KEY por tu clave API. Las solicitudes consumen créditos; copiar el ejemplo no envía ninguna solicitud.

Geometry Utilities API
curl -X POST "https://osrmroute.com/api/1/geometry" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"op":"distance","from":[40.37,49.85],"to":[40.40,49.86]}'

Límites y coordenadas

Coste en créditos: 1 credit

point=lat,lng; puntos JSON: [lat,lng]. Geometría GeoJSON: [lon,lat].

  • op: distance | bearing | destination | midpoint | length | area | centroid | simplify | polyline_encode | polyline_decode

Valida el formato de entrada y las unidades indicadas.

Planes y precios actualesCobertura por servicio

Ejemplo de respuesta JSON

JSON ilustrativo y abreviado. Los valores, campos opcionales y datos cartográficos pueden variar. Las distancias están en metros y las duraciones de ruta en segundos, salvo indicación contraria.

HTTP 200 · application/json
{
  "op": "distance",
  "distance": 2590.25,
  "unit": "meters"
}
Errores del servicio

Corrige los parámetros ausentes o inválidos.

HTTP 400
{
  "error": "Invalid geometry input for the requested op."
}

Explicación de la estructura de la respuesta

Devuelve { op, ... } con el resultado de la operación, p. ej. { distance, unit }, { bearing_deg }, { point }, { area, unit }, { path } o { polyline }.

Coordinate Conversion API

#

Convierte latitud/longitud a y desde referencias de cuadrícula UTM y MGRS.

GET
/api/1/convert

Parámetros (Query Params)

ParámetroTipoEstadoPredeterminadoDescripción
pointstringOpcionallat,lngCoordenada lat,lng para convertir a UTM/MGRS.
mgrsstringOpcional-Cadena MGRS para convertir de vuelta a coordenada.

Envía point=lat,lng, ambos parámetros lat y lon, o mgrs. Un mgrs no vacío tiene prioridad. La conversión inversa devuelve el centro de la celda MGRS y omite utm.

Ejemplo de solicitud

Sustituye YOUR_KEY por tu clave API. Las solicitudes consumen créditos; copiar el ejemplo no envía ninguna solicitud.

Coordinate Conversion API
curl "https://osrmroute.com/api/1/convert?point=40.3755,49.8516" -H "Authorization: Bearer YOUR_KEY"

Límites y coordenadas

Coste en créditos: 1 credit

point=lat,lng; puntos JSON: [lat,lng]. Geometría GeoJSON: [lon,lat].

  • point=lat,lng OR (lat=... AND lon=...) OR mgrs=...

Valida el formato de entrada y las unidades indicadas.

Planes y precios actualesCobertura por servicio

Ejemplo de respuesta JSON

JSON ilustrativo y abreviado. Los valores, campos opcionales y datos cartográficos pueden variar. Las distancias están en metros y las duraciones de ruta en segundos, salvo indicación contraria.

HTTP 200 · application/json
{
  "point": {
    "lat": 40.3755,
    "lng": 49.8516
  },
  "mgrs": "39TVE0251070068",
  "utm": {
    "zone": 39,
    "band": "T",
    "easting": 402511,
    "northing": 4470068,
    "hemisphere": "N"
  }
}
Errores del servicio

Corrige los parámetros ausentes o inválidos.

HTTP 400
{
  "error": "Provide point=lat,lng (or lat= & lon=), or mgrs= to reverse-convert."
}

Explicación de la estructura de la respuesta

Devuelve { point, mgrs, utm:{ zone, band, easting, northing, hemisphere } }. Con mgrs= devuelve { mgrs, point }.

Country Info API

#

Moneda, código telefónico, idiomas, capital y bandera de cualquier país por código ISO o nombre.

GET
/api/1/country

Parámetros (Query Params)

ParámetroTipoEstadoPredeterminadoDescripción
codestringOpcionalAZCódigo de país ISO 3166 alfa-2 o alfa-3 (p. ej. AZ o AZE).
namestringOpcional-Nombre del país como alternativa al código.

Ejemplo de solicitud

Sustituye YOUR_KEY por tu clave API. Las solicitudes consumen créditos; copiar el ejemplo no envía ninguna solicitud.

Country Info API
curl "https://osrmroute.com/api/1/country?code=AZ" -H "Authorization: Bearer YOUR_KEY"

Límites y coordenadas

Coste en créditos: 1 credit

Consulta los campos JSON; esta solicitud no requiere un par de coordenadas.

  • code=ISO2/ISO3 OR name=...

Valida el formato de entrada y las unidades indicadas.

Planes y precios actualesCobertura por servicio

Ejemplo de respuesta JSON

JSON ilustrativo y abreviado. Los valores, campos opcionales y datos cartográficos pueden variar. Las distancias están en metros y las duraciones de ruta en segundos, salvo indicación contraria.

HTTP 200 · application/json
{
  "name": "Azerbaijan",
  "official_name": "Republic of Azerbaijan",
  "cca2": "AZ",
  "cca3": "AZE",
  "capital": "Baku",
  "region": "Asia",
  "subregion": "Western Asia",
  "currency": {
    "code": "AZN",
    "name": "Azerbaijani manat",
    "symbol": "₼"
  },
  "calling_code": "+994",
  "languages": [
    "Azerbaijani"
  ],
  "flag": "🇦🇿",
  "latlng": [
    40.5,
    47.5
  ]
}
Errores del servicio

Corrige los parámetros ausentes o inválidos.

HTTP 400
{
  "error": "Provide code=ISO2/ISO3 or name=CountryName."
}

Usa un código válido o el nombre exacto del país.

HTTP 404
{
  "error": "Country not found."
}

Explicación de la estructura de la respuesta

Devuelve { name, official_name, cca2, cca3, capital, region, subregion, currency:{code,name,symbol}, calling_code, languages[], flag, latlng }.

Isochrone API

#

Estima la accesibilidad a partir de tiempos de viaje a puntos de muestra. Si cada dirección tiene un punto alcanzable, quality.status es estimated; en caso contrario es insufficient_data y polygons está vacío. Un resultado vacío no demuestra que no haya vías alcanzables. El límite es aproximado; solo se admiten límites de tiempo.

GET
/api/1/isochrone

Parámetros (Query Params)

ParámetroTipoEstadoPredeterminadoDescripción
pointstringObligatorio-Punto central. Formato: lat,lon.
time_limitintegerOpcional600Límite de tiempo de viaje (en segundos).

Ejemplo de solicitud

Sustituye YOUR_KEY por tu clave API. Las solicitudes consumen créditos; copiar el ejemplo no envía ninguna solicitud.

Isochrones API
curl "https://osrmroute.com/api/1/isochrone?point=40.4093,49.8671&time_limit=600" -H "Authorization: Bearer YOUR_KEY"

Límites y coordenadas

Coste en créditos: 2 credits / minute; minimum 10

point=lat,lng; puntos JSON: [lat,lng]. Geometría GeoJSON: [lon,lat].

  • time_limit: min = 60 s
  • time_limit ≤ plan.maxIsochroneMinutes × 60
  • quality.status = estimated | insufficient_data; polygons = [] when any bearing lacks a reachable sample
  • Sampled OSRM estimate, not an exact reachable-area boundary; an empty polygon does not prove no reachable roads
  • credits = max(10, ceil(time_limit_seconds / 30))

Los perfiles de coche, a pie y bicicleta son mundiales. Los puntos deben conectarse por vías permitidas. El VRP es heurístico y las isócronas aproximadas; no se promete un óptimo global ni tráfico en directo.

Planes y precios actualesCobertura por servicio

Ejemplo de respuesta JSON

JSON ilustrativo y abreviado. Los valores, campos opcionales y datos cartográficos pueden variar. Las distancias están en metros y las duraciones de ruta en segundos, salvo indicación contraria.

HTTP 200 · application/json
{
  "quality": {
    "status": "estimated",
    "method": "sampled_osrm",
    "sampled_points": 80,
    "reachable_points": 48,
    "covered_bearings": 16,
    "total_bearings": 16,
    "unknown_points": 0
  },
  "polygons": [
    {
      "type": "Feature",
      "properties": {
        "bucket": 0,
        "time_limit": 600
      },
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              49.84,
              40.37
            ],
            [
              49.87,
              40.37
            ],
            [
              49.87,
              40.4
            ],
            [
              49.84,
              40.37
            ]
          ]
        ]
      }
    }
  ]
}
Errores del servicio

Corrige los parámetros ausentes o inválidos.

HTTP 400
{
  "error": "point parameter is required"
}

Comprueba los límites de complejidad y las restricciones de la clave.

HTTP 403
{
  "error": "The Isochrone API is not available on your plan. Upgrade your plan to use it."
}

Elige un perfil compatible. No se cambia automáticamente a coche.

HTTP 422
{
  "code": "ProfileNotAvailable",
  "error": "This travel profile is not available at one or more coordinates. No driving fallback was used."
}

El servicio o su fuente no están disponibles. Reintenta con cautela y esperas crecientes.

HTTP 504
{
  "code": "RoutingTimeout",
  "error": "The routing service did not respond within the request deadline. Retry later."
}

Explicación de la estructura de la respuesta

polygons[] — GeoJSON Feature; geometry — Polygon [lon,lat]; properties.time_limit — límite temporal (s).

Route Optimization API

#

Planifica rutas con restricciones de capacidad, ventanas horarias, habilidades y recogidas/entregas vinculadas. Una heurística con tiempo limitado reduce el viaje sin garantizar un óptimo global. Las tareas no asignadas permanecen en solution.unassigned; las entradas no válidas se rechazan por completo.

POST
/api/1/vrp

Parámetros (Query Params)

ParámetroTipoEstadoPredeterminadoDescripción
vehiclesarrayOpcionalone default vehicleLa lista de vehículos — cada uno con un id, capacidad opcional y una ubicación de inicio como un array [lon, lat] (longitud primero).
servicesarrayOpcional[]Las paradas a atender — cada una con un id, una ubicación como un array [lon, lat] (longitud primero) y un tiempo de servicio opcional.
shipmentsarrayOpcional[]Tareas vinculadas de recogida y entrega con amount y skills. Indique services, shipments o ambos; máximo 250 puntos de tarea.
profilestringOpcionaldrivingPerfil común: driving, cycling o walking, incluidos los nombres alternativos documentados.

Ejemplo de solicitud

Sustituye YOUR_KEY por tu clave API. Las solicitudes consumen créditos; copiar el ejemplo no envía ninguna solicitud.

Route Optimization API
curl -X POST "https://osrmroute.com/api/1/vrp" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"vehicles":[{"vehicle_id":"v1","start":[49.85,40.37]}],"services":[{"id":10,"location":[49.86,40.40]}]}'

Límites y coordenadas

Coste en créditos: max(10, ceil(vehicles * task_points * 13 / 15)) credits

Matrices VRP start/location: [lon,lat]; objetos: lat y lng/lon. Tiempo en segundos.

  • vehicles.length ≤ plan.maxVehicles
  • vehicles defaults to one vehicle when omitted
  • services.length + 2 × shipments.length ≤ 250; vehicles.length ≤ 100
  • task_points = services.length + 2 × shipments.length
  • credits = max(10, ceil(vehicles * task_points * 13 / 15)); invalid inputs are refunded
  • Capacity arrays, time_windows, skills and paired shipments are enforced; unsupported options return 400
  • solution.unassigned lists tasks not assigned by the bounded heuristic; this is not proof of infeasibility
  • transport_time is travel only; service_time, waiting_time and elapsed time are separate; costs is travel seconds

Los perfiles de coche, a pie y bicicleta son mundiales. Los puntos deben conectarse por vías permitidas. El VRP es heurístico y las isócronas aproximadas; no se promete un óptimo global ni tráfico en directo.

Planes y precios actualesCobertura por servicio

Ejemplo de respuesta JSON

JSON ilustrativo y abreviado. Los valores, campos opcionales y datos cartográficos pueden variar. Las distancias están en metros y las duraciones de ruta en segundos, salvo indicación contraria.

HTTP 200 · application/json
{
  "status": "finished",
  "job_id": "opt-1234567890",
  "processing_time": 0,
  "solution": {
    "unassigned": [],
    "quality": {
      "solver": "vroom",
      "version": "1.15.0",
      "constraints_verified": true,
      "optimality_proven": false
    },
    "costs": 420,
    "distance": 3200,
    "time": 420,
    "no_vehicles": 1,
    "no_unassigned": 0,
    "routes": [
      {
        "vehicle_id": "v1",
        "distance": 3200,
        "transport_time": 420,
        "activities": [
          {
            "type": "start",
            "location_id": "depot",
            "end_time": 0
          },
          {
            "type": "service",
            "id": 10,
            "location_id": "stop_1",
            "arr_time": 200,
            "end_time": 200
          },
          {
            "type": "end",
            "location_id": "depot",
            "arr_time": 420
          }
        ]
      }
    ]
  }
}
Errores del servicio

Corrige los parámetros ausentes o inválidos.

HTTP 400
{
  "code": "InvalidOptimizationInput",
  "error": "At least one service with valid coordinates is required."
}

Comprueba los límites de complejidad y las restricciones de la clave.

HTTP 403
{
  "error": "Your plan allows up to 1 vehicles per request. Upgrade your plan for more."
}

Comprueba que los puntos estén cerca de vías accesibles y que estas estén conectadas para el perfil elegido.

HTTP 422
{
  "code": "NoNearbyRoad",
  "error": "No connected route within 2000 metres of the requested coordinates."
}

Explicación de la estructura de la respuesta

status → finished; job_id — ID del trabajo; solution: distance — distancia (m), time y costs — tiempo (s), no_vehicles, no_unassigned — cantidades, routes[] — rutas. routes[]: vehicle_id, distance (m), transport_time (s), activities[] — actividades.

Location Clustering API

#

Agrupa (agrupa en clústeres) las coordenadas dadas según su proximidad y densidad geográfica.

POST
/api/1/cluster

Parámetros (Query Params)

ParámetroTipoEstadoPredeterminadoDescripción
customersarrayObligatorio[]Coordenadas de clientes y pesos a agrupar en clústeres.

Ejemplo de solicitud

Sustituye YOUR_KEY por tu clave API. Las solicitudes consumen créditos; copiar el ejemplo no envía ninguna solicitud.

Agrupación de ubicaciones
curl -X POST "https://osrmroute.com/api/1/cluster" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"customers":[[49.85,40.37],[49.86,40.40],[49.83,40.39]],"clusters":2}'

Límites y coordenadas

Coste en créditos: 3 credits

Coordenadas de clientes de entrada: [lon,lat]; centro de salida: [lat,lon].

  • customers: valid coordinates ≥ 1
  • 1 ≤ clusters ≤ valid_customers.length

Valida el formato de entrada y las unidades indicadas.

Planes y precios actualesCobertura por servicio

Ejemplo de respuesta JSON

JSON ilustrativo y abreviado. Los valores, campos opcionales y datos cartográficos pueden variar. Las distancias están en metros y las duraciones de ruta en segundos, salvo indicación contraria.

HTTP 200 · application/json
{
  "status": "finished",
  "job_id": "cluster-1234567890",
  "processing_time": 0,
  "no_clusters": 1,
  "clusters": [
    {
      "ids": [
        "s1",
        "s2"
      ],
      "center": [
        40.385,
        49.855
      ],
      "size": 2
    }
  ]
}
Errores del servicio

Corrige los parámetros ausentes o inválidos.

HTTP 400
{
  "error": "Provide a \"customers\" array with valid coordinates."
}

Explicación de la estructura de la respuesta

status → finished; job_id — ID del trabajo; no_clusters — número de grupos; clusters[]: ids[] — elementos, center [lat,lon] — centro, size — tamaño.

Endpoints de compatibilidad

Antes de migrar una integración, verifica el orden de coordenadas y las unidades de respuesta.

La ruta abreviada tiene la misma entrada y salida que OSRM. Route antiguo recibe pares latitud,longitud repetidos. paths[].time está en milisegundos y paths[].distance en metros. Route info describe la cobertura configurada y cuesta un crédito.

HTTP
GET /api/v1/route/driving/49.8516,40.3755;49.8378,40.3892
GET /api/1/route?point=40.3755,49.8516&point=40.3892,49.8378
GET /api/1/route/info

Matrix antiguo acepta parámetros point repetidos o listas from_point y to_point. Con JSON envía from_points y to_points como pares latitud,longitud. Los tiempos están en milisegundos y las distancias en metros.

HTTP
GET /api/1/matrix?point=40.3755,49.8516&point=40.3892,49.8378
POST /api/1/matrix · POST /api/1/matrix/calculate
{"from_points":[[40.3755,49.8516]],"to_points":[[40.3892,49.8378]]}

Match antiguo acepta un recorrido GPS ordenado en pares [lon, lat]. Opcionalmente envía una marca temporal en segundos y un radio en metros por punto. La distancia está en metros y el tiempo en milisegundos. Elevation ([lat, lon]) por lotes acepta hasta 1.000 pares y devuelve metros o null.

POST /api/1/match
{"points":[[49.8516,40.3755],[49.8378,40.3892]],"timestamps":[1760000000,1760000120],"radiuses":[20,20]}
POST /api/1/elevation
{"points":[[40.3755,49.8516],[40.3892,49.8378]]}

optimize y vrp/optimize usan el formato de VRP. Los alias de agrupación y geocodificación masiva usan el cuerpo canónico. VRP y agrupación devuelven el resultado directamente.

Playground del mapa

SDK oficiales

Kotlin para Android/JVM y Swift para iOS. Modelos tipados y solicitudes asíncronas para las API geográficas de OSRMRoute.

JavaScript / TypeScriptPythonKotlin / AndroidSwift / iOSVer los SDK

Soporte OSRMRoute

Escriba directamente a nuestro equipo

ESTAMOS PARA AYUDAR

¿Cómo podemos ayudarle?

Envía un mensaje. Las respuestas a los tickets también se envían a tu correo verificado.

Tus chats

Tus chats aparecerán aquí.