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.
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/infoTodos 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.
Authorization: Bearer YOUR_API_KEYCó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-AfterProporciona una clave API válida y comprueba su estado.
{
"error": "Invalid API Key"
}Recarga el saldo o elige un plan compatible.
{
"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.
{
"error": "This API Key is disabled"
}Respeta Retry-After y reduce la frecuencia de solicitudes.
{
"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.
{
"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.
/api/v1/osrm/route/v1/{profile}/{coordinates}Parámetros (Query Params)
| Parámetro | Tipo | Estado | Predeterminado | Descripción |
|---|---|---|---|---|
| profile | string | Obligatorio | driving | Perfil de modo de transporte. Valores admitidos: driving (coche), cycling (bici), walking (peatón). |
| coordinates | string | Obligatorio | - | Coordenadas de los puntos. Formato: lon,lat;lon,lat;lon,lat... (al menos 2 puntos). |
| overview | string | Opcional | simplified | Nivel de detalle de la geometría de ruta devuelta: simplified (simplificada), full (geometría completa), false (sin geometría). |
| geometries | string | Opcional | polyline | Formato de geometría: geojson (objeto GeoJSON), polyline (cadena codificada). |
| steps | boolean | Opcional | false | Si se devuelven instrucciones paso a paso para cada giro. |
| alternatives | integer | boolean | Opcional | false | Cantidad 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.
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 servicioEjemplo 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.
{
"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.
{
"code": "InvalidQuery",
"error": "Coordinates must be finite longitude,latitude pairs."
}Elige un perfil compatible. No se cambia automáticamente a coche.
{
"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.
{
"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.
{
"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.
{
"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.
/api/v1/osrm/table/v1/{profile}/{coordinates}Parámetros (Query Params)
| Parámetro | Tipo | Estado | Predeterminado | Descripción |
|---|---|---|---|---|
| profile | string | Obligatorio | driving | Perfil de transporte (driving, cycling, walking). |
| coordinates | string | Obligatorio | - | Puntos de la matriz. Formato: lon,lat;lon,lat;lon,lat... |
| annotations | string | Opcional | duration | Datos a calcular: duration (tiempo), distance (distancia) o ambos. |
| sources | string | Opcional | all | Índices de origen desde cero, separados por punto y coma, o all. |
| destinations | string | Opcional | all | Í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.
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 servicioEjemplo 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.
{
"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.
{
"code": "InvalidQuery",
"error": "Coordinates must be finite longitude,latitude pairs."
}Elige un perfil compatible. No se cambia automáticamente a coche.
{
"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.
{
"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.
{
"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.
{
"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.
/api/v1/osrm/match/v1/{profile}/{coordinates}Parámetros (Query Params)
| Parámetro | Tipo | Estado | Predeterminado | Descripción |
|---|---|---|---|---|
| geometries | string | Opcional | polyline | Formato de geometría: geojson (objeto GeoJSON), polyline (cadena codificada). |
| profile | string | Obligatorio | driving | Perfil de transporte. |
| coordinates | string | Obligatorio | - | La secuencia de coordenadas GPS a ajustar (lon,lat;lon,lat...) |
| overview | string | Opcional | simplified | Precisión de la geometría de la ruta ajustada. |
| timestamps | string | Opcional | - | Marcas Unix en segundos, en orden no decreciente, una por punto, separadas por punto y coma. |
| radiuses | string | Opcional | - | 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.
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 servicioEjemplo 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.
{
"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.
{
"code": "InvalidQuery",
"error": "Coordinates must be finite longitude,latitude pairs."
}Elige un perfil compatible. No se cambia automáticamente a coche.
{
"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.
{
"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.
{
"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.
{
"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.
/api/v1/osrm/nearest/v1/{profile}/{coordinates}Parámetros (Query Params)
| Parámetro | Tipo | Estado | Predeterminado | Descripción |
|---|---|---|---|---|
| profile | string | Obligatorio | driving | Perfil de transporte. |
| coordinates | string | Obligatorio | - | El punto cerca del cual buscar. Formato: lon,lat (un solo par). |
| number | integer | Opcional | 1 | El 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.
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 servicioEjemplo 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.
{
"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.
{
"code": "InvalidQuery",
"error": "Coordinates must be finite longitude,latitude pairs."
}Elige un perfil compatible. No se cambia automáticamente a coche.
{
"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.
{
"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.
{
"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.
/api/v1/osrm/trip/v1/{profile}/{coordinates}Parámetros (Query Params)
| Parámetro | Tipo | Estado | Predeterminado | Descripción |
|---|---|---|---|---|
| geometries | string | Opcional | polyline | Formato de geometría: geojson (objeto GeoJSON), polyline (cadena codificada). |
| profile | string | Obligatorio | driving | Perfil de transporte. |
| coordinates | string | Obligatorio | - | Puntos a visitar. Formato: lon,lat;lon,lat... |
| source | string | Opcional | any | El punto desde el que puede empezar la ruta (any o el primer punto). |
| destination | string | Opcional | any | El punto donde termina la ruta (any o el último punto). |
| roundtrip | boolean | Opcional | true | Volver 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.
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 servicioEjemplo 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.
{
"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.
{
"code": "InvalidQuery",
"error": "Coordinates must be finite longitude,latitude pairs."
}Elige un perfil compatible. No se cambia automáticamente a coche.
{
"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.
{
"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.
{
"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.
{
"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.
/api/1/directionsParámetros (Query Params)
| Parámetro | Tipo | Estado | Predeterminado | Descripción |
|---|---|---|---|---|
| point | string | Obligatorio | lat,lng | Punto como lat,lng. Repite el parámetro por cada parada (mínimo 2). |
| profile | string | Opcional | driving | Modo de transporte: driving, cycling o walking. |
| alternatives | integer | Opcional | 0 | Número de rutas alternativas adicionales a devolver (0–3). |
| lang | string | Opcional | en | Có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.
curl "https://osrmroute.com/api/1/directions?point=40.3777,49.8516&point=40.40,49.86&profile=driving" -H "Authorization: Bearer YOUR_KEY"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 servicioEjemplo 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.
{
"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.
{
"error": "At least two points must be provided (point=lat,lng repeated)."
}Elige un perfil compatible. No se cambia automáticamente a coche.
{
"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.
{
"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.
{
"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.
{
"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).
/api/1/snapParámetros (Query Params)
| Parámetro | Tipo | Estado | Predeterminado | Descripción |
|---|---|---|---|---|
| point | string | Obligatorio | lat,lng | Punto GPS como lat,lng. Repite el parámetro por cada punto (máximo 100). |
| profile | string | Opcional | driving | Red 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.
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 servicioEjemplo 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.
{
"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.
{
"error": "At least one point must be provided (point=lat,lng repeated)."
}Elige un perfil compatible. No se cambia automáticamente a coche.
{
"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.
{
"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.
{
"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.
/api/1/geocodeParámetros (Query Params)
| Parámetro | Tipo | Estado | Predeterminado | Descripción |
|---|---|---|---|---|
| q | string | Opcional | - | La dirección a buscar (p. ej.: «Calle Nizami, Bakú»). |
| reverse | boolean | Opcional | false | Debe ser true para realizar geocodificación inversa (búsqueda de coordenada a dirección). |
| point | string | Opcional | lat,lng | Coordenada (lat,lng) para geocodificación inversa a una dirección. Obligatorio cuando reverse=true. |
| limit | integer | Opcional | 5 | Número máximo de resultados a devolver (1–20, por defecto 5). |
| lang | string | Opcional | en | Idioma preferido para los nombres de resultados (p. ej. en, az, ru). Por defecto en. |
| lat | number | Opcional | - | Latitud para sesgar los resultados (los cercanos primero). Junto con lon. |
| lon | number | Opcional | - | Longitud para sesgar los resultados. Junto con lat. |
| bbox | string | Opcional | - | Limitar resultados a un cuadro: minLon,minLat,maxLon,maxLat. |
| osm_tag | string | Opcional | - | Filtrar por etiqueta OSM, p. ej. place (localidades) o amenity:cafe. Prefijo ! para excluir. |
| country | string | Opcional | - | Código de país ISO 3166-1 alpha-2, por ejemplo AZ. Solo resultados de ese país. |
| city | string | Opcional | - | Filtro estricto de ciudad, por ejemplo Baku. Requiere exactamente un código country. |
| elastic | boolean | Opcional | true | Bú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.
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
# 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.867Para 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.
/api/1/geocode?q=101+Main+Street&country=US&locality=Boston&postcode=02129&unit=2&address_mode=unitsEjemplo de solicitud
Sustituye YOUR_KEY por tu clave API. Las solicitudes consumen créditos; copiar el ejemplo no envía ninguna solicitud.
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 servicioEjemplo 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.
{
"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.
{
"error": "The \"q\" parameter (search text) is required."
}Corrige los parámetros ausentes o inválidos.
{
"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.
{
"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.
/api/1/placesParámetros (Query Params)
| Parámetro | Tipo | Estado | Predeterminado | Descripción |
|---|---|---|---|---|
| point | string | Obligatorio | lat,lng | Coordenada central lat,lng para buscar (obligatorio). |
| radius | number | Opcional | 1 | Radio de búsqueda en kilómetros (0.05–20, por defecto 1). |
| category | string | Opcional | - | Filtro por etiqueta OSM, p. ej. amenity:cafe, shop, tourism:hotel. Prefijo ! para excluir. Vacío = todos los POI. |
| limit | integer | Opcional | 10 | Máx. resultados (1–50, por defecto 10). |
| lang | string | Opcional | en | Idioma 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.
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 servicioEjemplo 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.
{
"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.
{
"error": "The \"point\" parameter (lat,lng) is required."
}El servicio o su fuente no están disponibles. Reintenta con cautela y esperas crecientes.
{
"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.
/api/1/autocompleteParámetros (Query Params)
| Parámetro | Tipo | Estado | Predeterminado | Descripción |
|---|---|---|---|---|
| q | string | Obligatorio | - | Texto de búsqueda — se admite entrada parcial. |
| limit | integer | Opcional | 8 | Número máximo de sugerencias (1–15). |
| lang | string | Opcional | en | Código de idioma para las etiquetas. |
| lat | number | Opcional | - | Latitud para sesgar resultados (opcional). |
| lon | number | Opcional | - | Longitud para sesgar resultados (opcional). |
| country | string | Opcional | - | Código de país ISO 3166-1 alpha-2, por ejemplo AZ. Solo resultados de ese país. |
| city | string | Opcional | - | Filtro estricto de ciudad, por ejemplo Baku. Requiere exactamente un código country. |
| osm_tag | string | Opcional | - | 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.
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.
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 servicioEjemplo 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.
{
"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.
{
"error": "The \"q\" parameter (search text) is required."
}Corrige los parámetros ausentes o inválidos.
{
"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.
/api/1/geocode/batchParámetros (Query Params)
| Parámetro | Tipo | Estado | Predeterminado | Descripción |
|---|---|---|---|---|
| queries | array | Obligatorio | [] | Array de direcciones a geocodificar (máx. 100). |
| lang | string | Opcional | en | Código de idioma para las etiquetas. |
| limit | integer | Opcional | 1 | Coincidencias 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.
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 servicioEjemplo 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.
{
"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.
{
"error": "Body must include a non-empty \"queries\" array of address strings."
}Corrige los parámetros ausentes o inválidos.
{
"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.
/api/1/timezoneParámetros (Query Params)
| Parámetro | Tipo | Estado | Predeterminado | Descripción |
|---|---|---|---|---|
| point | string | Opcional | - | Envía point=lat,lng o ambos parámetros lat y lon. |
| lat | number | Opcional | - | Latitud (alternativa a point). |
| lon | number | Opcional | - | Longitud (alternativa a point). |
| timestamp | string | Opcional | now | Hora 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.
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 servicioEjemplo 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.
{
"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.
{
"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.
/api/1/elevationParámetros (Query Params)
| Parámetro | Tipo | Estado | Predeterminado | Descripción |
|---|---|---|---|---|
| point | string | Obligatorio | lat,lng | Coordenada 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.
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 servicioEjemplo 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.
{
"results": [
{
"point": {
"lat": 40.3777,
"lng": 49.8516
},
"elevation": null
}
],
"unit": "meters"
}Errores del servicio
Corrige los parámetros ausentes o inválidos.
{
"error": "Provide at least one point=lat,lng (repeatable)."
}Corrige los parámetros ausentes o inválidos.
{
"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.
/api/1/boundaryParámetros (Query Params)
| Parámetro | Tipo | Estado | Predeterminado | Descripción |
|---|---|---|---|---|
| point | string | Obligatorio | lat,lng | Coordenada como lat,lng. |
| polygon | boolean | Opcional | false | true para devolver también el límite como GeoJSON. |
| lang | string | Opcional | en | Có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.
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 servicioEjemplo 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.
{
"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.
{
"error": "Provide a valid coordinate via point=lat,lng or lat= & lon=."
}No hay datos administrativos detallados aquí. Consulta la cobertura.
{
"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.
/api/1/geofenceParámetros (Query Params)
| Parámetro | Tipo | Estado | Predeterminado | Descripción |
|---|---|---|---|---|
| fences | array | Obligatorio | [] | Array de vallas: { id?, polygon:[[lat,lng],...] } o { id?, center:[lat,lng], radius_m }. Hasta 100. |
| points | array | Obligatorio | [] | 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.
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 servicioEjemplo 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.
{
"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.
{
"error": "Body must include non-empty \"fences\" and \"points\" arrays."
}Corrige los parámetros ausentes o inválidos.
{
"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.
/api/1/elevation/profileParámetros (Query Params)
| Parámetro | Tipo | Estado | Predeterminado | Descripción |
|---|---|---|---|---|
| points | array | Opcional | [] | Array de puntos [lat,lng] de la ruta (>=2, hasta 2000). |
| polyline | string | Opcional | - | 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.
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 servicioEjemplo 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.
{
"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.
{
"error": "Provide a \"points\" array (>=2 [lat,lng]) or an encoded \"polyline\"."
}Corrige los parámetros ausentes o inválidos.
{
"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.
/api/1/solarParámetros (Query Params)
| Parámetro | Tipo | Estado | Predeterminado | Descripción |
|---|---|---|---|---|
| point | string | Obligatorio | lat,lng | Coordenada como lat,lng. |
| date | string | Opcional | today | Fecha (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.
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 servicioEjemplo 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.
{
"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.
{
"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.
/api/1/geometryParámetros (Query Params)
| Parámetro | Tipo | Estado | Predeterminado | Descripción |
|---|---|---|---|---|
| op | string | Obligatorio | distance | Operación: distance, bearing, destination, midpoint, length, area, centroid, simplify, polyline_encode o polyline_decode. |
| from | array | Opcional | [lat,lng] | Punto inicial [lat,lng]. |
| to | array | Opcional | [lat,lng] | Punto final [lat,lng]. |
| path | array | Opcional | [] | Array de [lat,lng] (length/simplify/polyline_encode). |
| polygon | array | Opcional | [] | Anillo [lat,lng] (area). |
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.
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 servicioEjemplo 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.
{
"op": "distance",
"distance": 2590.25,
"unit": "meters"
}Errores del servicio
Corrige los parámetros ausentes o inválidos.
{
"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.
/api/1/convertParámetros (Query Params)
| Parámetro | Tipo | Estado | Predeterminado | Descripción |
|---|---|---|---|---|
| point | string | Opcional | lat,lng | Coordenada lat,lng para convertir a UTM/MGRS. |
| mgrs | string | Opcional | - | 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.
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 servicioEjemplo 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.
{
"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.
{
"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.
/api/1/countryParámetros (Query Params)
| Parámetro | Tipo | Estado | Predeterminado | Descripción |
|---|---|---|---|---|
| code | string | Opcional | AZ | Código de país ISO 3166 alfa-2 o alfa-3 (p. ej. AZ o AZE). |
| name | string | Opcional | - | 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.
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 servicioEjemplo 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.
{
"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.
{
"error": "Provide code=ISO2/ISO3 or name=CountryName."
}Usa un código válido o el nombre exacto del país.
{
"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.
/api/1/isochroneParámetros (Query Params)
| Parámetro | Tipo | Estado | Predeterminado | Descripción |
|---|---|---|---|---|
| point | string | Obligatorio | - | Punto central. Formato: lat,lon. |
| time_limit | integer | Opcional | 600 | Lí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.
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 servicioEjemplo 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.
{
"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.
{
"error": "point parameter is required"
}Comprueba los límites de complejidad y las restricciones de la clave.
{
"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.
{
"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.
{
"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.
/api/1/vrpParámetros (Query Params)
| Parámetro | Tipo | Estado | Predeterminado | Descripción |
|---|---|---|---|---|
| vehicles | array | Opcional | one default vehicle | La lista de vehículos — cada uno con un id, capacidad opcional y una ubicación de inicio como un array [lon, lat] (longitud primero). |
| services | array | Opcional | [] | 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. |
| shipments | array | Opcional | [] | Tareas vinculadas de recogida y entrega con amount y skills. Indique services, shipments o ambos; máximo 250 puntos de tarea. |
| profile | string | Opcional | driving | Perfil 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.
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 servicioEjemplo 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.
{
"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.
{
"code": "InvalidOptimizationInput",
"error": "At least one service with valid coordinates is required."
}Comprueba los límites de complejidad y las restricciones de la clave.
{
"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.
{
"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.
/api/1/clusterParámetros (Query Params)
| Parámetro | Tipo | Estado | Predeterminado | Descripción |
|---|---|---|---|---|
| customers | array | Obligatorio | [] | 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.
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 servicioEjemplo 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.
{
"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.
{
"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.
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/infoMatrix 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.
GET /api/1/matrix?point=40.3755,49.8516&point=40.3892,49.8378{"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.
{"points":[[49.8516,40.3755],[49.8378,40.3892]],"timestamps":[1760000000,1760000120],"radiuses":[20,20]}{"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.
POST /api/1/optimize·POST /api/1/vrp/optimize→ Route Optimization APIPOST /api/1/cluster/calculate→ Location Clustering APIPOST /api/1/batch-geocode→ Batch Geocoding API
SDK oficiales
Kotlin para Android/JVM y Swift para iOS. Modelos tipados y solicitudes asíncronas para las API geográficas de OSRMRoute.