Omówienie interfejsu Roads API

Roads API to usługa, która akceptuje żądania HTTPS ze współrzędnymi geograficznymi (szerokością i długością geograficzną) co najmniej 1 punktu na mapie. Na podstawie tych punktów wyszukuje pobliskie segmenty dróg i zwraca identyfikator miejsca wraz z metadanymi, takimi jak najbliższy segment drogi i ograniczenia prędkości.

Dlaczego warto korzystać z Roads API

Za pomocą Roads API możesz uzyskać informacje o ograniczeniach prędkości, szacowanych czasach dotarcia do celu lub inne metadane dotyczące dróg. Dzięki tym metadanym dróg możesz wzbogacić swoje aplikacje do nawigacji o te funkcje:

  • Połącz współrzędne geograficzne z drogą lub drogami.
  • Znajdowanie najbliższej drogi dla zestawu współrzędnych
  • Wyświetlanie ograniczeń prędkości na odcinkach dróg

Co możesz zrobić w Roads API

Za pomocą Roads API możesz przypisywać współrzędne GPS do geometrii drogi i określać ograniczenie prędkości na poszczególnych odcinkach.

  • Przyciąganie do dróg Ta usługa zwraca najbardziej prawdopodobne drogi, po których poruszał się użytkownik, na podstawie podanego zestawu współrzędnych GPS. Możesz określić maksymalnie 100 punktów GPS zebranych na trasie. Opcjonalnie możesz też poprosić usługę o interpolację dodatkowych punktów, co spowoduje, że ścieżka będzie płynnie przebiegać wzdłuż geometrii drogi.
  • Najbliższe drogi – ta usługa zwraca najbliższy odcinek drogi dla punktu GPS. Możesz określić maksymalnie 100 punktów GPS. Określone punkty nie muszą być częścią ciągłej ścieżki.
  • Ograniczenia prędkości Ta usługa zwraca opublikowane ograniczenie prędkości na danym odcinku drogi. Usługa ograniczenia prędkości jest dostępna dla wszystkich klientów, którzy mają licencję na śledzenie zasobów. W przypadku klientów korzystających z abonamentu premium na platformę Mapy Google, którzy przeszli na płatność za wykorzystanie, ta funkcja pozostaje aktywna.

Jak działa Roads API

Roads API korzysta z 3 punktów końcowych, które akceptują współrzędne geograficzne lub identyfikatory miejsc, aby dostarczać dane o drogach, odcinkach lub ograniczeniach prędkości. Poniższy przykład pokazuje żądanie dotyczące najbliższych dróg na podstawie zestawu współrzędnych geograficznych:

https://roads.googleapis.com/v1/nearestRoads
  ?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796
  &key=YOUR_API_KEY

Zasoby

W tabeli poniżej znajdziesz podsumowanie zasobów dostępnych w ramach interfejsu Roads API oraz zwracanych przez nie danych.

Zasoby danych Zwrócone dane Format zwrotu
Przyciągaj do dróg

Zwraca tablicę zawierającą maksymalnie 100 punktów GPS z trasy. Zawiera współrzędne długości i szerokości geograficznej przyciągnięte do drogi oraz identyfikatory miejsc. Szczegółowe informacje znajdziesz w sekcji Odpowiedzi w przewodniku Przyciąganie do dróg.
  • JSON
Najbliższe drogi

Tablica zawierająca maksymalnie 100 niezależnych współrzędnych geograficznych (szerokość i długość geograficzna) oraz identyfikatory miejsc najbliższej drogi dla każdego określonego punktu. Punkty nie muszą być ciągłe. Szczegółowe informacje znajdziesz w sekcji Odpowiedzi w przewodniku Najbliższe drogi.
Ograniczenia prędkości

Tablica zawierająca maksymalnie 100 elementów metadanych drogi. Zawierają one ograniczenia prędkości i identyfikatory miejsc, a jednostki są podane w km/h lub milach na godzinę. Szczegółowe informacje znajdziesz w sekcji Odpowiedzi w przewodniku Ograniczenia prędkości.

Jak używać Roads API

1 Wypróbuj wersję demonstracyjną przyciągania do dróg Kliknij wersję demonstracyjną, aby utworzyć ślad i zobaczyć, jak punkt końcowy przyciągania do dróg zapewnia płynne dane. Zobacz demo w przewodniku Przyciąganie do dróg. Nie potrzebujesz klucza interfejsu API.
2 Konfiguracja Zacznij od skonfigurowania projektu Google Cloud i wykonaj kolejne instrukcje konfiguracji, a potem dowiedz się, jak używać klucza interfejsu API.
3 Wypróbuj prośbę o przyciągnięcie do dróg Skorzystaj z jednego z przykładów dotyczących przyciągania do dróg i wypróbuj ten, który jest odpowiedni w Twoim przypadku.
4 Wyświetlanie ograniczeń prędkości na trasie Używając tych samych danych ścieżki, które zostały podane w żądaniu przyciągania do dróg, wyślij zapytanie o ograniczenie prędkości. Zobacz przykładowe żądanie z użyciem ścieżki.
5 Dowiedz się, jak przetwarzać długie ścieżki Zapoznaj się z sekcjami Przetwarzanie długich ścieżek w przewodniku Zaawansowane koncepcje.
6 Wprowadź dane o drogach do własnej aplikacji! Zapoznaj się ze szczegółowym przykładem kodu z demonstracji dotyczącej przyciągania do drogi, aby zacząć wdrażać w swojej aplikacji funkcje związane z danymi o drogach.

Dostępne biblioteki klienta

Wywołaj ten interfejs API w wybranym języku za pomocą jednej z tych bibliotek klienta:

Klient Java, klient Python, klient Go i klient Node.js dla usług Map Google to biblioteki klientów obsługiwane przez społeczność, udostępniane na licencji Apache 2.0. Możesz je pobrać z GitHuba, gdzie znajdziesz też instrukcje instalacji i przykładowy kod.

Co dalej?