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. Wykorzystuje te punkty do znajdowania segmentów dróg 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

Za pomocą interfejsu Roads API możesz uzyskać informacje o ograniczeniach prędkości, szacowanym czasie przyjazdu i innych metadanych dróg. Dzięki tym metadanym o drogach możesz ulepszyć aplikacje dla kierowców przy użyciu tych funkcji:

  • Łączenie współrzędnych szerokości i długości geograficznej z drogą lub drogami.
  • Znajdź najbliższą drogę dla określonego zbioru współrzędnych
  • Pobieranie informacji o ograniczeniach prędkości dla fragmentów drogi

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

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

  • Przyciągaj do dróg Ta usługa zwraca najbardziej prawdopodobne przebyte drogi na podstawie podanego zestawu współrzędnych GPS. Możesz wskazać do 100 punktów GPS na trasie. Opcjonalnie możesz też poprosić, by usługa interpolowała dodatkowe punkty, tworząc ścieżkę, która płynnie przebiega zgodnie z geometrią drogi.
  • Najbliższe drogi – ta usługa zwraca najbliższy fragment drogi w przypadku punktu GPS. Możesz określić maksymalnie 100 punktów GPS. Wskazane punkty nie muszą należeć do ciągłej ścieżki.
  • Ograniczenia prędkości Ta usługa zwraca ograniczenie prędkości opublikowane na danym fragmencie drogi. Usługa Ograniczenie 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 używa 3 punktów końcowych, które akceptują współrzędne szerokości i długości geograficznej lub identyfikatory miejsc do podawania ścieżek, fragmentów lub danych o ograniczeniach prędkości. Poniższy przykład pokazuje żądanie udostępnienia najbliższych dróg na podstawie 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

Tabela poniżej zawiera podsumowanie zasobów dostępnych przez interfejs Roads API oraz zwracanych przez nie danych.

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

Zwraca tablicę zawierającą maksymalnie 100 punktów GPS z trasy. Obejmuje przypisane do dróg współrzędne długości i szerokości geograficznej wraz z identyfikatorami miejsc. Szczegółowe informacje znajdziesz w sekcji Odpowiedzi w przewodniku Przyciągaj do dróg.
  • JSON
Najbliższe drogi

Tablica z maksymalnie 100 niezależnymi współrzędnymi szerokości i długości geograficznej wraz z identyfikatorami miejsc najbliższej drogi w przypadku każdego wskazanego punktu. Punkty nie muszą być ciągłe. Szczegóły znajdziesz w sekcji Odpowiedzi w przewodniku Najbliższe drogi.
Ograniczenia prędkości

Tablica z maksymalnie 100 elementami metadanych drogi. Obejmują one ograniczenia prędkości i identyfikatory miejsc, podane w kilometrach na godzinę lub mi/h. Szczegółowe informacje znajdziesz w sekcji Odpowiedzi w przewodniku Ograniczenia prędkości.

Jak korzystać z interfejsu Roads API

1 Wypróbuj aplikację Przyciągnij do dróg Kliknij wersję demonstracyjną, aby utworzyć ścieżkę i sprawdź, jak przyciąganie do punktu końcowego dróg zapewnia płynne dane. Zobacz Demonstrację w przewodniku Przyciągaj do dróg. Nie potrzebujesz klucza interfejsu API.
2 Konfiguracja Zacznij od skonfigurowania projektu Google Cloud i wykonaj podane instrukcje konfiguracji, a potem 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 pasuje do Twojego zastosowania.
4 Sprawdzanie ograniczeń 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 ograniczenie prędkości. Zobacz przykładowe żądanie ze ścieżką.
5 Dowiedz się, jak przetwarzać długie ścieżki Wykonaj sekcje Przetwarzanie 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 demonstracji przyciągniętej drogi, aby zacząć tworzyć funkcję danych o drogach w swojej aplikacji.

Dostępne biblioteki klienta

Wywołaj ten interfejs API w wybranym języku, używając jednej z tych bibliotek klienta:

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

Co dalej