Zasięg i ograniczenia

Co obejmuje każda część API i czego nie obejmuje, żebyś mógł to sprawdzić, zanim zaczniesz na nim budować. Źródła i licencje są na stronie Źródła danych.

Dane map

OpenStreetMap dla całego świata. Każdy budynek i każdy adres są zachowane w Europie, Stanach Zjednoczonych, Kanadzie i Meksyku. Gdzie indziej budynek lub adres jest zachowany tylko wtedy, gdy jest też czymś innym, co API przechowuje, na przykład sklepem, kawiarnią lub kościołem.

Obiekty są zachowane, gdy mają jeden z tych kluczy: aerialway, amenity, craft, drinking_water, highway, historic, landuse, leisure, man_made, mountain_pass, natural, office, piste:type, place, service:bicycle:repair, shop, sport, tourism, water, waterway, wetland. Zachowane są także granice administracyjne, obszary chronione oraz relacje tras pieszych, rowerowych, biegowych i narciarskich.

Wszystko inne nie ma się w danych, nawet jeśli OpenStreetMap to zawiera: na przykład linie i stacje kolejowe, linie energetyczne, bariery i bramy, przystanki oznaczone wyłącznie public_transport, tereny wojskowe i maszty telekomunikacyjne. Metadane edycji (wersje, użytkownicy, changesety) również nie są uwzględnione.

Każdy region jest ładowany ze świeżego wycinka Geofabrik i od czasu do czasu odświeżany; zmiany wprowadzone w OpenStreetMap po tym czasie pojawią się przy następnym odświeżeniu. Data danych jest w osm3s.timestamp_osm_base każdej odpowiedzi Overpass.

Znajduje miasta, miasteczka, wsie, dzielnice, osady i nazwane miejscowości, w żądanym języku, jeśli mapa ma w nim nazwę. Nie znajduje ulic, adresów ani miejsc takich jak sklepy, stacje czy atrakcje.

Zapytania Overpass

Typowe skrypty Overpass QL działają tak, jak pokazano w przykładach Overpass QL; rekursja (>, <) i zapytania bez bbox, around, poly, area lub identyfikatora nie. Zapytanie jest zatrzymywane po 30 sekundach. Zapytanie area po dużym mieście o popularny tag może dobić do tego limitu; bbox lub kilka mniejszych obszarów odpowiada szybciej.

open_at zachowuje miejsca otwarte o lokalnej godzinie, odczytując ich tag opening_hours. Miejsca bez tagu lub z takim, którego nie da się odczytać, są pomijane i zliczane; święta nie są uwzględniane.

Pogoda

Godzinowe prognozy na maksymalnie 14 dni w dowolnym miejscu. Nad Europą pierwsze dni pochodzą z DWD ICON-EU (około 7 km), nad Stanami Zjednoczonymi z NOAA HRRR i NBM (2,5 do 3 km), a nad Kanadą i północnymi Stanami z ECCC HRDPS i RDPS; gdzie indziej i po zakończeniu tych modeli z NOAA GFS 0,11° i ECMWF IFS 0,25°.

API nie zawiera historii pogody, tylko prognozy.

Jakość powietrza i pyłki

Prognozy jakości powietrza obejmują cały świat; pyłki tylko Europę, a poza nią ich wartości są null. Wartości zmierzone pochodzą z obywatelskich czujników Sensor.Community, czujników Syngeos w Polsce i stacji oficjalnych w Albanii, Andorze, Austrii, Belgii, Bośni i Hercegowinie, Bułgarii, Chorwacji, na Cyprze, w Czechach, Danii, Estonii, Finlandii, Francji, Niemczech, Grecji, na Węgrzech, Islandii, w Irlandii, Włoszech, na Łotwie, w Luksemburgu, na Malcie, w Czarnogórze, Holandii, Macedonii Północnej, Norwegii, Polsce, Portugalii, Rumunii, Serbii, na Słowacji, w Słowenii, Szwecji, Szwajcarii i Wielkiej Brytanii. Inne kraje, wśród nich Hiszpania i Litwa, nie mają w API oficjalnych stacji z bieżącymi odczytami. Większość stacji oficjalnych raportuje przez European Environment Agency, której odczyty docierają dwie do sześciu godzin po pomiarze; GIOŚ (Polska) i ČHMÚ (Czechy) raportują w ciągu godziny.

Poziomy rzek

Wodowskazy w Niemczech (drogi wodne federalne i Nadrenia Północna-Westfalia), Francji, Anglii, Szkocji, Holandii, Flandrii, Luksemburgu, Czechach, Irlandii, Szwajcarii, Szwecji, Finlandii, Stanach Zjednoczonych i Kanadzie. W Hiszpanii wodowskazy mają tylko Katalonia i część dorzecza Gwadalkiwiru; reszta Hiszpanii (dorzecza Ebro, Tagu, Duero, Júcar, Segury i Gwadiany, dorzecza północne, Galicja, Kraj Basków, Nawarra i śródziemnomorskie wybrzeże Andaluzji) ich nie ma. We Włoszech wodowskazy mają tylko Lombardia, Wenecja Euganejska, Emilia-Romania i Tyrol Południowy, a poziomy z Lombardii docierają z około pięciogodzinnym opóźnieniem. Wodowskazy w Finlandii raportują wartości dobowe. Inne kraje, wśród nich Polska, nie mają w API wodowskazów.

Wysokości i kafelki terenu

Wysokości i kafelki terenu obejmują cały ląd: kafelki 256 px do zoomu 13, kafelki 512 px do zoomu 12.

Trasy

Routing obejmuje cały świat. Wyszukiwanie trasy, które trwałoby dłużej niż dwie minuty, kończy się statusem 504; gdy wszystkie wątki routingu pozostają zajęte przez 20 sekund, żądanie dostaje status 503.

Czego nie ma w API

Wyszukiwanie adresów i geokodowanie, kafelki mapy podkładowej, style i fonty, modele 3D budynków, izochrony i historia pogody.

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.