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 jednego lub większej liczby punktów na mapie. Funkcja ta używa tych punktów do znajdowania pobliskich fragmentów drogi i zwraca identyfikator miejsca wraz z metadanymi takimi jak najbliższy segment drogi i ograniczenia prędkości.

Dlaczego warto korzystać z interfejsu Roads API

Dzięki interfejsowi Roads API możesz uzyskać informacje o ograniczeniach prędkości, szacowanym czasie przyjazdu i innych metadanych. Dzięki tym metadanym drogowe możesz wzbogacić aplikacje samochodowe o takie możliwości:

  • Połącz współrzędne szerokości i długości geograficznej z drogą lub drogami.
  • Znajdź najbliższą drogę dla zestawu współrzędnych
  • Uzyskiwanie informacji o ograniczeniach prędkości na fragmentach drogi

Co można zrobić przy użyciu interfejsu Roads API

Roads API pozwala mapować współrzędne GPS na geometrię drogi oraz określać ograniczenia prędkości na poszczególnych fragmentach drogi.

  • Przyciągaj do dróg Ta usługa zwraca najbardziej prawdopodobne drogi pokonane na podstawie podanego zestawu współrzędnych GPS. Możesz określić do 100 punktów GPS zbieranych na trasie. Opcjonalnie możesz też poprosić, by usługa interpolowała dodatkowe punkty, czego wynikiem jest ścieżka, która płynnie dostosowuje się do geometrii drogi.
  • Najbliższe drogi: ta usługa zwraca najbliższy segment drogi dla punktu GPS. Możesz określić do 100 punktów GPS. Wskazane 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 fragmencie drogi. Usługa ograniczenia prędkości jest dostępna dla wszystkich klientów z licencją na śledzenie zasobów. W przypadku klientów, którzy korzystają z abonamentu Premium Google Maps Platform, i przeszli na model płatności według wykorzystania, ta funkcja jest nadal aktywna.

Jak działa interfejs Roads API

Interfejs 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 ścieżkach dróg, segmentach lub ograniczeniach prędkości. Poniższy przykład przedstawia żądanie najbliższych dróg na podstawie zestawu współrzędnych szerokości i długości geograficznej:

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 interfejsie Road API wraz z danymi zwróconymi przez nie.

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

Zwraca tablicę maksymalnie 100 punktów GPS z trasy. Obejmuje współrzędne długości i szerokości geograficznej nałożonych na drogi, a także identyfikatory miejsc. Szczegółowe informacje znajdziesz w przewodniku Odpowiedzi w przewodniku Przyciągaj do dróg.
  • JSON
Najbliższe drogi

Tablica maksymalnie 100 niezależnych współrzędnych szerokości i długości geograficznej wraz z identyfikatorami miejsc dla najbliższej drogi w każdym określonym punkcie. Punkty nie muszą być ciągłe. Więcej informacji znajdziesz w sekcji Odpowiedzi w przewodniku Najbliższe drogi.
Ograniczenia prędkości

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

Jak korzystać z interfejsu Roads API

1 Wypróbuj funkcję Przyciąganie do dróg Kliknij wersję demonstracyjną, aby utworzyć ścieżkę i sprawdzić, jak przyciąganie do punktu końcowego dróg zapewnia płynne działanie. Zapoznaj się z sekcją Prezentacja w przewodniku Przyciągaj do dróg. Nie potrzebujesz klucza interfejsu API.
2 Skonfiguruj Zacznij od sekcji Skonfiguruj projekt Google Cloud i postępuj zgodnie z poniższymi instrukcjami, a potem dowiedz się, jak używać klucza interfejsu API.
3 Wyślij prośbę o przyciąganie do drogi Użyj jednego z przykładów przyciągania do dróg i wypróbuj taki, który pasuje do Twojego zastosowania.
4 Sprawdzanie limitów prędkości na danej trasie Korzystając z tych samych danych o ścieżce, które zostały podane w żądaniu przyciągania do drogi, wyślij zapytanie o ograniczenia prędkości. Zapoznaj się z sekcją Przykładowe żądanie za pomocą ścieżki.
5 Dowiedz się, jak przetwarzać długie ścieżki Wykonaj czynności opisane w sekcjach dotyczących przetwarzania długich ścieżek w przewodniku Zaawansowane pojęcia.
6 Umieść dane o drogach w swojej aplikacji. Zapoznaj się ze szczegółowym przykładem kodu z przesłanej demonstracji z drogą, aby rozpocząć tworzenie funkcji danych o drogach we własnej aplikacji.

Dostępne biblioteki klienta

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

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

Co dalej?