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 centerdaje 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:
| Co | Tagi |
|---|---|
| Woda pitna | amenity=drinking_water oraz drinking_water=yes na fontannach i kranach |
| Jedzenie | amenity=cafe, restaurant, fast_food; shop=bakery |
| Zakupy spożywcze | shop=supermarket, convenience |
| Toalety | amenity=toilets |
| Naprawa roweru | shop=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.