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. Wykorzystuje te punkty do znajdowania pobliskich odcinków dróg i zwraca identyfikator miejsca wraz z metadanymi, takimi jak najbliższy odcinek drogi i ograniczenia prędkości.

Dlaczego warto korzystać z Roads API

Dzięki Roads API możesz uzyskać informacje o ograniczeniach prędkości, szacowanym czasie przybycia i 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 szerokości i długości geograficznej z drogą lub drogami.
  • Znajdowanie najbliższej drogi dla zestawu współrzędnych
  • Uzyskiwanie informacji o ograniczeniach prędkości na odcinkach dróg

Co możesz zrobić za pomocą Roads API

Za pomocą Roads API możesz mapować współrzędne GPS na geometrię drogi i określać ograniczenia prędkości na jej odcinkach.

  • Snap to Roads Ta usługa zwraca najbardziej prawdopodobne drogi, którymi poruszał się pojazd, na podstawie podanego zestawu współrzędnych GPS. Możesz podać maksymalnie 100 punktów GPS zebranych na trasie. Opcjonalnie możesz też poprosić usługę o interpolację dodatkowych punktów, co pozwoli uzyskać ścieżkę, która płynnie podąża za geometrią drogi.
  • Nearest Roads Ta usługa zwraca najbliższy segment 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.
  • Ograniczenia prędkości Ta usługa zwraca opublikowane ograniczenie prędkości dla danego segmentu drogi. Usługa Speed Limit jest dostępna dla wszystkich klientów z licencją na śledzenie zasobów. W przypadku klientów korzystających z abonamentu Premium Google Maps Platform, którzy przeszli na płatność według wykorzystania, 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. Poniższy przykład pokazuje żą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

Tabela poniżej zawiera podsumowanie zasobów dostępnych w Roads API oraz zwracane przez nie dane.

Zasoby danych Zwrócone dane Format zwrotu
Snap to Roads

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 po usłudze Snap to Roads.
  • JSON
Najbliższe drogi

Tablica zawierająca maksymalnie 100 niezależnych współrzędnych geograficznych (szerokość i długość geograficzna) wraz z identyfikatorami miejsc dla 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ą podawane 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ą usługi Snap to Roads Kliknij wersję demonstracyjną, aby utworzyć ścieżkę i zobaczyć, jak punkt końcowy Snap to Roads dostarcza płynne dane. Zobacz wersję demonstracyjną w przewodniku po usłudze Snap to Roads. 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 żądanie przyciągania do dróg Użyj jednego z przykładów przyciągania do dróg i wypróbuj ten, który pasuje do Twojego przypadku użycia.
4 Uzyskiwanie ograniczeń prędkości na trasie Użyj tych samych danych ścieżki, które zostały podane w żądaniu Snap to Roads, 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 podanymi w sekcjach dotyczących przetwarzania długich ścieżek w przewodniku Zaawansowane pojęcia.
6 Uwzględnij dane o drogach we własnej aplikacji Aby zacząć tworzyć funkcje danych o drogach we własnej aplikacji, zapoznaj się ze szczegółowym przykładem kodu z wersji demonstracyjnej przyciągania do drogi.

Dostępne biblioteki klienta

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

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

Co dalej?