La petición
{
"profile": "road-bike", "lengthKm": 86.458, "ascentM": 1083, "durationS": 20880,
"geometry": { "type": "LineString", "coordinates": [[lon, lat, ele], ...] }
}
- points
- De 2 a 50 puntos como [lon, lat]: salida, puntos intermedios, meta
- profile
bike(por defecto),city,road-bike,quiet-road-bike,gravel,mtb,hiking,car,shortest- alternative
- De 0 a 3: la mejor ruta o una de tres alternativas
- format
geojson(por defecto) ogpx
Cuánto tarda una ruta
El cálculo de rutas recorre la red viaria, así que el tiempo crece con la distancia. En nuestras pruebas un recorrido urbano de 13 km tardó uno o dos segundos, de 85 a 140 km de seis a diez segundos, y 530 km de 20 a 25 segundos. Una búsqueda que tardaría más de dos minutos se detiene con el estado 504; añade un punto intermedio o divide el viaje en tramos. Una salida en una zona peatonal o en un camino que el perfil no puede usar responde 404 con no_route.
Límites
Una ruta cuenta una vez por cada 100 km empezados de la ruta encontrada (50 km en el perfil MTB), tanto en tus peticiones como en tus rutas, así que una ruta de 250 km cuenta como tres, o cinco en MTB. Las rutas también tienen su propio límite de cuántas pueden ejecutarse a la vez.
| Plan | Rutas al día | Rutas simultáneas | Precio |
|---|---|---|---|
| Free | 20 | 1 | $0 |
| Developer | 1,000 | 2 | 14,99 $ al mes |
| Pro | 5,000 | 2 | 39,99 $ al mes |
Después de la ruta
Devuelve la línea para obtener lo que hay a lo largo de ella: el tiempo a la hora a la que llegas, el perfil de elevación, agua, comida y tiendas, estaciones de aforo de ríos, estaciones de calidad del aire, fronteras y zonas horarias. POST /v1/route/report devuelve varias de ellas en una sola petición.
Créditos: rutas sobre datos de mapas © colaboradores de OpenStreetMap, disponibles bajo la Open Database License.