Omówienie interfejsu Roads API

Roads API to usługa, która akceptuje żądania HTTPS z adresem szerokości i długości geograficznej jednego lub większej liczby punktów na mapie. Wykorzystuje te wskazuje fragmenty dróg w pobliżu i zwraca identyfikator miejsca wraz z metadanymi np. najbliższy fragment drogi czy ograniczenia prędkości.

Dlaczego warto korzystać z interfejsu Roads API

Dzięki interfejsowi Roads API możesz sprawdzać ograniczenia prędkości godzin przyjazdu lub innych metadanych dróg. Z tą drogą możesz zwiększyć skuteczność aplikacji samochodowych, korzystając z 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 umożliwia mapowanie współrzędnych GPS na geometrię drogi i określenie ograniczeń prędkości na tej drodze, segmentów niestandardowych.

  • Przyciągaj do dróg Ta usługa zwraca przebytych dróg na podstawie podanego zestawu współrzędnych GPS. Możesz określić maksymalnie 100 Punkty GPS zebrane na trasie. Opcjonalnie możesz też zażądać, aby usługa interpoluje dodatkowe punkty w celu uzyskania ścieżki, która płynnie przebiega geometrii drogi.
  • Najbliższe drogi – usługa zwraca najbliższą drogę segment dla 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 opublikowane ograniczenia 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 abonamentu premium na Google Maps Platform dla klientów, którzy przeszli na model płatności według wykorzystania, funkcja ta pozostaje aktywne.

Jak działa interfejs Roads API

Interfejs Roads API używa 3 punktów końcowych, które akceptują szerokość i długość geograficzną współrzędnych lub identyfikatorów miejsc, by dostarczać dane o ścieżkach dróg, segmentach lub ograniczeniach prędkości. Następujący przykład pokazuje żądanie udostępnienia 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 Roads API wraz z zwracanymi danymi.

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

Zwraca tablicę zawierającą maksymalnie 100 punktów GPS z trasy. Zawiera ciągnące się od drogi współrzędne długości i szerokości geograficznej z identyfikatorami miejsc. Zobacz szczegóły tutaj: Odpowiedzi w obszarze Przyciągaj do dróg Google.
  • JSON
Najbliższe drogi

Tablica ze 100 różnymi współrzędnymi szerokości i długości geograficznej wraz z identyfikatorami miejsc najbliższej drogi w każdym określonym punkcie. Punkty nie muszą być ciągłe. Zobacz szczegóły tutaj: Odpowiedzi na najbliższych drogach Google.
Ograniczenia prędkości

Tablica z maksymalnie 100 elementami metadanych drogi. Obejmują one: i granic miejsc, w jednostkach w kilometrach lub milach na godzinę. Zobacz szczegóły w sekcji Odpowiedzi w sekcji Ograniczenia prędkości Google.

Jak korzystać z interfejsu Roads API

1 Wypróbuj aplikację Przyciągnij do dróg Kliknij wersję demonstracyjną, aby utworzyć ścieżkę i zobaczyć, jak przyciąga ona do punktu końcowego dróg. zapewnia płynne dane. Zobacz Prezentacja 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. i ucz się jak używać klucza interfejsu API.
3 Wypróbuj prośbę o przyciągnięcie do dróg z przykładami dróg i wypróbuj jedną z nich, która 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, wysłać zapytanie dotyczące ograniczenia prędkości. Zobacz Przykładowe żądanie ze ścieżką.
5 Dowiedz się, jak przetwarzać długie ścieżki Obserwuj sekcje na Długie ścieżki przetwarzania w przewodniku Pojęcia zaawansowane.
6 Umieść dane o drogach we własnej aplikacji. Zobacz szczegółowy przykład kodu z wersji demonstracyjnej z przyciągnięciem drogi do rozpoczęcia dodawania funkcji związanych z danymi o drogach do własnych aplikacji.

Dostępne biblioteki klienta

Wywołaj ten interfejs API w języku możesz wybrać za pomocą jednej z tych bibliotek klienta:

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

Co dalej?