Czym jest Overpass API?

OpenStreetMap to bezpłatna mapa świata tworzona przez wolontariuszy. Oprócz dróg i budynków zawiera miliony sklepów, kawiarni, ławek, defibrylatorów i fontann z wodą pitną, z których każdy opisany jest tagami, takimi jak amenity=cafe lub shop=bakery. Overpass API to usługa wyszukiwania tych danych działająca w trybie tylko do odczytu: prosisz o wszystkie obiekty z określonym tagiem na danym obszarze, a usługa zwraca pasujące miejsca wraz z ich nazwami, adresami i godzinami otwarcia.

Kilka grup udostępnia bezpłatne, publiczne serwery Overpass. Korzystają z nich wszyscy, więc w godzinach wzmożonego ruchu jeden z serwerów może działać wolno lub odrzucać zapytania, podczas gdy inny odpowiada od razu.

Opis narzędzia

Przesuń i przybliż mapę, aby wybrać obszar wyszukiwania, a następnie wskaż, czego szukać: kategorii, takiej jak apteki lub toalety publiczne, własnego tagu OSM albo dowolnego obiektu o podanej nazwie. Możesz też zawęzić wyniki dla dowolnej kategorii, podając nazwę, na przykład wyszukać supermarkety, których nazwa zawiera słowo Lidl. Kliknij „Szukaj na obszarze mapy”, aby przeszukać widoczny obszar. Przycisk pod przyciskami powiększania mapy przenosi widok do Twojej lokalizacji.

Miejsca są oznaczone kropkami na mapie i wyświetlane w tabeli pod ustawieniami wyszukiwania. Tabela zawiera nazwę, tag i adres każdego miejsca. Kliknij kropkę lub wiersz tabeli, aby zobaczyć również godziny otwarcia i stronę internetową miejsca, a także link do jego widoku w OpenStreetMap. Tabelę można sortować według dowolnej kolumny, a wyniki zapisać jako CSV lub JSON.

Domyślnie narzędzie samo wybiera serwer: w Europie korzysta z serwera zawierającego wyłącznie dane europejskie, który często jest mniej obciążony, a w pozostałych przypadkach przełącza się na kolejny serwer, gdy jeden jest zajęty. Próbuje też połączyć się z kolejnym serwerem, jeśli odpowiedź z bieżącego nadchodzi zbyt wolno. Możesz również wybrać serwer samodzielnie. W wierszu stanu znajdziesz informację, który serwer odpowiedział i jak aktualna jest jego kopia danych mapy.

Wyszukiwanie odbywa się bezpośrednio z Twojej przeglądarki na serwer Overpass: serwer otrzymuje informację o obszarze i wyszukiwanym obiekcie, a żadne dane nie przechodzą przez nasz serwer.

Funkcje

  • Wyszukiwanie na obszarze widocznym na mapie OpenStreetMap, z możliwością szybkiego przejścia do swojej lokalizacji
  • Popularne kategorie, dowolny tag OSM i wyszukiwanie według nazwy
  • Bezpłatne, publiczne serwery Overpass, niewymagające klucza API, z automatycznym przełączeniem na inny serwer, gdy jeden jest zajęty
  • Wyniki na mapie i w sortowalnej tabeli obok niej, wraz z nazwami, tagami i adresami
  • Okna podręczne z godzinami otwarcia, stroną internetową i linkiem do miejsca w OpenStreetMap
  • Eksport wyników jako CSV lub JSON

Wskazówki

  • Wyszukuj miejscowość lub dzielnicę zamiast całego regionu: mniejsze obszary są przeszukiwane szybciej i mieszczą się w limitach publicznych serwerów.
  • Aby wyszukać własny tag, sprawdź jego klucz i wartość na liście obiektów mapy w wiki OpenStreetMap. Sam klucz, na przykład wheelchair lub opening_hours, pozwala znaleźć wszystkie obiekty, które go mają, niezależnie od wartości.
  • Wyszukiwanie nazw nie uwzględnia wielkości liter i obejmuje dowolny fragment nazwy, więc bank znajdzie również „Swedbank” i „Bank of Ireland”.
  • Jeśli automatyczny wybór serwera ciągle kończy się niepowodzeniem, być może wszystkie serwery są jednocześnie zajęte. Poczekaj minutę i spróbuj ponownie albo wybierz serwer samodzielnie.
  • Nie można tu znaleźć miejsc, których nie ma w OpenStreetMap. Brakujący sklep lub ławkę możesz dodać samodzielnie na stronie openstreetmap.org.