Punkty POI wzdłuż śladu GPX z Overpass API

Overpass umie szukać wokół linii, nie tylko wokół punktu, więc woda pitna, kawiarnie i toalety wzdłuż śladu GPX mieszczą się w jednym zapytaniu. Ten poradnik buduje takie zapytanie w Pythonie z pliku GPX, dodaje kilometr każdego miejsca i pokazuje, kiedy publiczny serwer przestaje wystarczać.

Szukanie wokół linii

Od wersji 0.7.55 filtr around przyjmuje listę punktów: (around:promień,lat1,lon1,lat2,lon2,…) znajduje to, co leży w promieniu, w metrach, od linii przez te punkty. Szerokość geograficzna idzie pierwsza.

[out:json][timeout:25];
node["amenity"="drinking_water"](around:150,46.2044,6.1432,46.1990,6.1500,46.1900,6.1520);
out;

To zapytanie szuka wody pitnej w promieniu 150 m od linii z trzech punktów przez Genewę. Nasz endpoint odpowiedział 14 punktami z wodą w 0,3 sekundy.

Od pliku GPX do listy z kilometrami

Ślad GPX ma punkt co kilka metrów, a zapytanie z tysiącami współrzędnych jest długie i wolne. Skrypt zostawia punkt co 250 m, wysyła jedno zapytanie i daje każdemu miejscu kilometr najbliższego zostawionego punktu. Potrzebuje pip install requests gpxpy.

import math
import sys

import gpxpy
import requests

OVERPASS_URL = "https://overpass-api.de/api/interpreter"
HEADERS = {"User-Agent": "my-ride-planner/1.0"}


def track_points(path):
    """Every point of every track in a GPX file, as (lat, lon)."""
    with open(path) as f:
        gpx = gpxpy.parse(f)
    return [(p.latitude, p.longitude)
            for track in gpx.tracks for segment in track.segments for p in segment.points]


def metres(a, b):
    """Distance between two (lat, lon) points in metres."""
    lat1, lon1, lat2, lon2 = map(math.radians, (*a, *b))
    h = math.sin((lat2 - lat1) / 2) ** 2 + math.cos(lat1) * math.cos(lat2) * math.sin((lon2 - lon1) / 2) ** 2
    return 2 * 6371000 * math.asin(math.sqrt(h))


def thin(points, step_m):
    """Keep a point every step_m metres, with the distance from the start of each."""
    kept, along, last = [(points[0], 0.0)], 0.0, points[0]
    for p in points[1:]:
        along += metres(last, p)
        last = p
        if along - kept[-1][1] >= step_m:
            kept.append((p, along))
    if kept[-1][0] != points[-1]:
        kept.append((points[-1], along))
    return kept


def overpass_query(line, radius_m):
    coords = ",".join(f"{lat:.5f},{lon:.5f}" for (lat, lon), _ in line)
    return f"""[out:json][timeout:90];
(
  nwr["amenity"="drinking_water"](around:{radius_m},{coords});
  nwr["drinking_water"="yes"](around:{radius_m},{coords});
);
out center;"""


def water_along(path, radius_m=100, step_m=250):
    line = thin(track_points(path), step_m)
    response = requests.post(OVERPASS_URL, data={"data": overpass_query(line, radius_m)}, headers=HEADERS, timeout=120)
    response.raise_for_status()
    places = []
    for element in response.json()["elements"]:
        where = (element["lat"], element["lon"]) if "lat" in element else (element["center"]["lat"], element["center"]["lon"])
        # The nearest kept point gives the kilometre, to within half a step.
        (_, km) = min(((metres(where, p), along) for p, along in line))
        places.append((km / 1000, element["tags"].get("name", ""), element["type"], element["id"]))
    return sorted(places)


if __name__ == "__main__":
    for km, name, kind, osm_id in water_along(sys.argv[1]):
        print(f"{km:6.1f} km  {kind}/{osm_id}  {name}")

Na 42-kilometrowej trasie rowerowej z Genewy do Annecy, wysłanej do naszego endpointu (przyjmuje to samo zapytanie), znalazł 23 miejsca z wodą pitną:

python water_along_track.py ride.gpx
   0.0 km  node/6597445539
   1.9 km  node/4426603391  rue des Allobroges
  25.5 km  node/11059601131
  36.3 km  node/8291624277
  ...
  • Kilometr to kilometr najbliższego zostawionego punktu, więc może się różnić o pół kroku, tu o 125 m. Dla dokładnych kilometrów rzutuj każde miejsce na pełny ślad.
  • Na krętych drogach krok 250 m ścina serpentyny. Zostaw więcej punktów (mniejsze step_m) albo użyj większego promienia.
  • out center daje drogom i relacjom jeden punkt, więc fontanna zmapowana jako obszar też dostaje kilometr.

O jakie tagi pytać

Zamień dwie linie w nawiasach zapytania na tagi tego, czego potrzebujesz. To typowe tagi w OpenStreetMap:

CoTagi
Woda pitnaamenity=drinking_water oraz drinking_water=yes na fontannach i kranach
Jedzenieamenity=cafe, restaurant, fast_food; shop=bakery
Zakupy spożywczeshop=supermarket, convenience
Toaletyamenity=toilets
Naprawa rowerushop=bicycle, amenity=bicycle_repair_station

Długie ślady a publiczny serwer

Długi ślad to długie zapytanie i długie wykonanie. Na overpass-api.de zapytanie, które deklaruje więcej czasu, niż serwer ma wolnego, dostaje 504, a wszystkie żądania z jednego adresu IP dzielą kilka slotów. Podziel długi ślad na odcinki po około 50 km i wysyłaj je jeden po drugim, nie naraz.

Od kwietnia 2026 publiczny serwer odrzuca też część żądań od razu z 406, na przykład te z domyślnym User-Agentem pythonowego requests; dlatego skrypt ustawia własny. Poradnik o błędach Overpass wyjaśnia 429, 406 i 504 i co zmienić.

To samo jednym żądaniem w naszym API

POST /v1/route-poi/corridor przyjmuje ślad jako punkty z odległością od startu i odpowiada kilometrem każdego miejsca i jego odległością od trasy, a do tego odcinkami dłuższymi niż 40 km bez wody i jedzenia. Kod korzysta z track_points i thin ze skryptu powyżej:

import os
import sys

import requests

from water_along_track import thin, track_points

KEY = os.environ["RUNNING_CAT_KEY"]

points = thin(track_points(sys.argv[1]), step_m=100)
if len(points) > 1000:
    points = thin(track_points(sys.argv[1]), step_m=points[-1][1] / 999)
body = {
    "points": [{"lat": lat, "lon": lon, "d": round(d)} for (lat, lon), d in points],
    "categories": ["water", "food", "toilets"],
}
response = requests.post("https://geo.runningcat.dev/v1/route-poi/corridor", json=body,
                         headers={"Authorization": f"Bearer {KEY}"}, timeout=60)
response.raise_for_status()
answer = response.json()
for poi in answer["pois"]:
    print(f'{poi["distanceAlongRouteKm"]:6.1f} km  {poi["category"]:8} {poi["subtype"]:16} {poi["name"] or ""}  ({poi["offsetFromRouteM"]} m off)')
for gap in answer["gaps"]:
    print("No water or food:", gap)

Przyjmuje do 1000 punktów, więc skrypt odchudza długi ślad, żeby się zmieścił. Kategorie to woda, jedzenie, zakupy, toalety, sklepy rowerowe, stacje paliw i kilka innych, każda z własną odległością od trasy, do 5 km. Szczegóły są na stronie POI wzdłuż trasy; darmowy plan daje 500 żądań dziennie.

Źródła: Overpass QL na wiki OpenStreetMap, filtr around, czytane 16 listopada 2026. Przykłady uruchomiono na geo.runningcat.dev tego samego dnia.

Plan darmowy daje 500 zapytań dziennie, także w aplikacjach komercyjnych. Załóż konto przez Google lub e-mail i od razu utwórz swoje klucze.