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 kilku punktów na mapie. Punkty służą do znajdowania fragmentów drogi w pobliżu i zwraca identyfikator miejsca wraz z metadanymi, takimi jak najbliższy fragment drogi czy 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 metadanym dróg możesz wzbogacić aplikacje do jazdy samochodem za pomocą następujących funkcji:

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

Co można robić za pomocą interfejsu Roads API

Roads API umożliwia przyporządkowanie współrzędnych GPS do geometrii drogi oraz określenie ograniczeń 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ć maksymalnie 100 punktów GPS zebranych wzdłuż trasy. Opcjonalnie możesz też poprosić o interpolację dodatkowych punktów, aby ścieżka płynnie się poruszała po geometrii drogi.
  • Najbliższe drogi – ta usługa zwraca najbliższy fragment 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 abonamentu premium na Google Maps Platform, którzy przeszli na model płatności według wykorzystania, funkcja pozostaje aktywna.

Jak działa interfejs Roads API

Interfejs Roads API udostępnia 3 punkty końcowe, które akceptują współrzędne szerokości i długości geograficznej lub identyfikatory miejsc, aby udostępniać dane o ścieżkach, fragmentach lub ograniczeniach prędkości. Poniższy przykład pokazuje żądanie dotyczące 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 za pośrednictwem interfejsu Roads API oraz zwróconych przez niego danych.

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

Zwraca tablicę maksymalnie 100 punktów GPS z trasy. Obejmuje długość i szerokość geograficzną przypisanych dróg oraz identyfikatory miejsc. Więcej informacji znajdziesz w sekcji Odpowiedzi w przewodniku Przyciągaj do dróg.

  • JSON
Najbliższe drogi

Tablica do 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. Więcej informacji znajdziesz w sekcji Odpowiedzi w przewodniku Ograniczenia prędkości.

Jak korzystać z interfejsu Roads API

1 Wypróbuj demonstrację przyciągania do dróg Kliknij wersję demonstracyjną, aby utworzyć ścieżkę i sprawdzić, jak przyciąganie do punktu końcowego dróg zapewnia płynność danych. Zapoznaj się z sekcją Demonstracja w przewodniku Przyciągaj do dróg. Nie potrzebujesz klucza interfejsu API.
2 Konfiguracja Zacznij od konfigurowania projektu Google Cloud i postępuj zgodnie z instrukcjami konfiguracji poniżej. Następnie dowiedz się, jak używać klucza interfejsu API.
3 Wypróbuj funkcję przyciągania do dróg Użyj jednego z przykładów przyciągania do dróg i wypróbuj tę, która pasuje do Twojego zastosowania.
4 Sprawdzanie prędkości na trasie Korzystając z tych samych danych o ścieżce, które zostały podane w żądaniu przyciągania do dróg, wyślij zapytanie o ograniczenia prędkości. Zapoznaj się z przykładowym żądaniem przy użyciu ś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 Pojęcia zaawansowane.
6 Umieść dane o drogach we własnej aplikacji. Zapoznaj się ze szczegółowym przykładem kodu z przyspieszonej demonstracji kodu drogowego, aby zacząć wbudować w swoją aplikację funkcję danych o drogach.

Dostępne biblioteki klienta

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

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

Co dalej?