Omówienie interfejsu Roads API

Roads API to usługa, która akceptuje żądania HTTPS ze współrzędnymi szerokości i długości geograficznej 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, szacowanym czasie przyjazdu lub inne metadane dotyczące dróg. Dzięki tym metadanym dróg możesz ulepszyć swoje aplikacje do jazdy, dodając do nich te funkcje:

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

Co możesz zrobić za pomocą Roads API

Roads API umożliwia mapowanie współrzędnych GPS na geometrię drogi i określanie ograniczenia prędkości na jej 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. Wskazane punkty nie muszą być częścią ciągłej ścieżki.
  • Limity prędkości Ta usługa zwraca opublikowany limit prędkości dla odcinka drogi. Usługa ograniczenia prędkości jest dostępna dla wszystkich klientów z licencją na śledzenie zasobów. W przypadku klientów korzystających z Google Maps Platform Premium Plan, którzy przeszli na model płatności według wykorzystania, ta funkcja pozostaje aktywna.

Jak działa Roads API?

Roads API używa 3 punktów końcowych, które akceptują współrzędne szerokości i długości geograficznej lub identyfikatory miejsc, aby dostarczać dane o trasach, odcinkach lub ograniczeniach prędkości. W przykładzie poniżej pokazujemy żą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 usługi Roads API wraz z danymi, które zwracają.

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

Zwraca tablicę zawierającą maksymalnie 100 punktów GPS z trasy. Obejmuje współrzędne długości i szerokości geograficznej dopasowane 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 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/h. Szczegółowe informacje znajdziesz w sekcji Odpowiedzi w przewodniku Ograniczenia prędkości.

Jak korzystać z Roads API

1 Wypróbuj wersję demonstracyjną przyciągania do dróg Kliknij wersję demonstracyjną, aby utworzyć ścieżkę i zobaczyć, jak punkt końcowy przyciągania do dróg dostarcza płynne dane. Zobacz wersję demonstracyjną w przewodniku Przyciągaj do dróg. Nie potrzebujesz klucza interfejsu API.
2 Konfiguracja Zacznij od skonfigurowania projektu Google Cloud i wykonaj instrukcje konfiguracji, a następnie dowiedz się, jak używać klucza interfejsu API.
3 Wypróbuj prośbę o przyciągnięcie do dróg Użyj jednego z przykładów 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żyj tych samych danych ścieżki, które zostały podane w żądaniu przyciągania do dróg, i 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 Postępuj zgodnie z instrukcjami w sekcjach Przetwarzanie długich ścieżek w przewodniku Pojęcia zaawansowane.
6 Wprowadź dane o drogach do własnej aplikacji! Zapoznaj się ze szczegółowym przykładem kodu z demonstracji przyciągania do drogi, aby zacząć tworzyć funkcje danych drogowych we własnej aplikacji.

Dostępne biblioteki klienta

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

Biblioteki klienta Java, Python, Go i Node.js do usług Google Maps to biblioteki klienta obsługiwane przez społeczność, udostępniane na licencji Apache 2.0. Pobierz je z GitHuba, gdzie znajdziesz też instrukcje instalacji i przykładowy kod.

Co dalej?