Una API de POI para lugares a lo largo de una ruta

Envía la ruta y recibe todas las paradas cercanas en el orden de la ruta: dónde llenar un bidón, comprar comida, encontrar un aseo o una tienda de bicicletas, cada una con la distancia recorrida hasta ella y lo lejos que queda de la ruta. La respuesta también marca los tramos de más de 40 km sin agua ni comida, para que una aplicación pueda avisar antes de que el ciclista llegue.

La petición

POST /v1/route-poi/corridor recibe la ruta como puntos con su distancia desde el inicio en metros, tal como ya los tiene un grabador de tracks o un planificador de rutas, y las categorías que quieres.

{
  "sections": [[
    { "lat": 46.204, "lon": 6.143, "d": 0 },
    ...
    { "lat": 45.924, "lon": 6.869, "d": 64484 }
  ]],
  "categories": ["water", "food", "bike"]
}
Ruta
Hasta 1000 km y 1000 puntos por petición, en hasta 64 secciones
Categorías
water, food, grocery, toilets, bike, fuel, y bajo petición sleep, sights, charging, bench, picnic
Distancia a la ruta
Por defecto, según la categoría: 150 m para agua y aseos, 200 m para comida, tiendas, talleres de bici y gasolineras, hasta 1 km para alojamiento y lugares de interés. maxDistanceM fija una distancia para todas las categorías y distancesM una para cada una, hasta 5 km. Con 2 km de anchura la ruta puede medir hasta 1000 km; con 5 km, hasta 400 km.

La respuesta

{
  "routeLengthKm": 64.484,
  "totals": { "water": 40, "food": 117, "bike": 4, "grocery": 0, "fuel": 0, "toilets": 0 },
  "pois": [
    { "id": "node/1379366890", "category": "water", "subtype": "drinking_water", "name": null,
      "lat": 46.2047788, "lon": 6.1417476, "flags": { "hasWater": true },
      "tags": { "amenity": "fountain", "drinking_water": "yes" },
      "distanceAlongRouteKm": 0, "offsetFromRouteM": 130 },
    ...
  ],
  "gaps": []
}

Cada parada conserva sus etiquetas de OpenStreetMap, así que el horario, la marca y los datos de pago están ahí cuando los mapeadores los añadieron. Las tiendas de cadena y las gasolineras pueden mostrarse con los logotipos de su marca, servidos desde la misma API. Un recorrido de Ginebra a Chamonix, de 64 km, devolvió 161 paradas.

Para una consulta corta, o tus propias etiquetas

El endpoint de Overpass admite around con una línea, para cualquier etiqueta que necesites, y los ejemplos muestran una unión de aseos y agua potable a lo largo de un recorrido.

Quién la usa

Aplicaciones para rutas largas, carreras de bikepacking, ultras y viajes por carretera, donde el siguiente punto de agua o la última tienda antes de una etapa nocturna importan más que un mapa lleno de marcadores. La misma clave da el tiempo a lo largo de la ruta, su perfil de elevación y las rutas.

Créditos: datos de mapas © colaboradores de OpenStreetMap, disponibles bajo la Open Database License.

El plan gratuito incluye 500 solicitudes al día, también para apps comerciales. Crea una cuenta con Google o con tu correo y genera tus claves al instante.