Omówienie interfejsu Roads API

Roads API to usługa, która akceptuje żądania HTTPS z współrzędnymi szerokości i długości geograficznej co najmniej 1 punktu na mapie. Korzystając z tych punktów, wykrywa pobliskie odcinki 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, szacunkowych czasach dotarcia lub innych metadanych dotyczących dróg. Dzięki tym metadanym możesz ulepszać aplikacje do nawigacji, dodając im te funkcje:

  • Połącz współrzędne szerokości i długości geograficznej z drogą lub drogami.
  • Znajdowanie najbliższej drogi na podstawie zestawu współrzędnych
  • wyświetlanie ograniczeń prędkości na odcinkach dróg.

Co możesz zrobić w Roads API

Dzięki Roads API możesz mapować współrzędne GPS na geometrię drogi i określać limit prędkości na poszczególnych odcinkach drogi.

  • Dopasowanie do dróg Ta usługa zwraca najbardziej prawdopodobne drogi na podstawie dostarczonego zbioru współrzędnych GPS. Możesz określić maksymalnie 100 punktów GPS zebranych na trasie. Opcjonalnie możesz poprosić, aby usługa interpolowała dodatkowe punkty, dzięki czemu ścieżka będzie płynnie podążać za geometrią drogi.
  • Najbliższe drogi Ta usługa zwraca najbliższy odcinek drogi dla punktu GPS. Możesz określić maksymalnie 100 punktów GPS. Podane punkty nie muszą znajdować się na ciągłej ścieżce.
  • Ograniczenia prędkości Ta usługa zwraca obowiązujące ograniczenie prędkości na danym odcinku drogi. Usługa Limit prędkości jest dostępna dla wszystkich klientów z licencją na śledzenie zasobów. W przypadku klientów korzystających z abonamentu premium na Mapach Google, którzy przeszli na płatność „za użycie”, ta funkcja pozostaje aktywna.

Jak działa Roads API

Interfejs Roads API używa 3 punkty końcowe, które akceptują współrzędne geograficzne lub identyfikatory miejsc, aby udostępniać ścieżki, segmenty lub dane o ograniczeniach prędkości. Ten 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

Tabela poniżej zawiera podsumowanie zasobów dostępnych w ramach interfejsu Roads API oraz danych, które zwracają.

Zasoby danych Zwrócone dane Format zwracanej wartości
Przyciąganie do dróg

Zwraca tablicę zawierającą do 100 punktów GPS z trasy. Zawiera współrzędne długości i szerokości geograficzne z drogi oraz identyfikatory miejsc. Szczegółowe informacje znajdziesz w odpowiedziach w przewodniku Dopasowywanie do dróg.
  • JSON
Najbliższe drogi

Tablica zawierająca maksymalnie 100 niezależnych współrzędnych geograficznych oraz identyfikatory miejsc dla najbliższej drogi w przypadku 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 dróg. Zawierają one limity prędkości i identyfikatory miejsc w kilometrach lub milach na godzinę. Szczegółowe informacje znajdziesz w sekcji Odpowiedzi w przewodniku Ograniczenia prędkości.

Jak korzystać z Roads API

1 Wypróbuj demonstrację funkcji dopasowywania do dróg Kliknij demonstrację, aby utworzyć ścieżkę i sprawdzić, jak punkt końcowy dopasowywania do dróg zapewnia płynne dane. Obejrzyj prezentację w przewodniku Przyciąganie do dróg. Nie potrzebujesz klucza API.
2 Konfiguracja Zacznij od skonfigurowania projektu Google Cloud i wykonaj podane niżej instrukcje konfiguracji, a następnie dowiedz się, jak używać klucza API.
3 Wypróbuj prośbę o dopasowanie do dróg Użyj jednego z przykładów skanowania zdjęć na potrzeby tworzenia map i wybierz ten, który jest odpowiedni do Twojego przypadku użycia.
4 Uzyskiwanie informacji o ograniczeniach prędkości na trasie Korzystając z tych samych danych ścieżki, które zostały podane w prośbie o dopasowanie do dróg, prześlij zapytanie o ograniczenie prędkości. Zobacz przykład żądania z ścieżką.
5 Dowiedz się, jak przetwarzać długie ścieżki Zapoznaj się z sekcjami dotyczącymi przetwarzania długich ścieżek w przewodniku Pojęcia zaawansowane.
6 Włącz dane drogowe do własnej aplikacji Zapoznaj się z szczegółowym przykładem kodu z prezentacji dotyczącej tworzenia mapy drogowej, aby zacząć tworzyć w swojej aplikacji funkcję danych drogowych.

Dostępne biblioteki klienta

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

Biblioteki klienta Java, Python, Go i Node.js do usług Map Google są obsługiwane przez społeczność i udostępniane na licencji Apache 2.0. Pobierz je z GitHuba, gdzie znajdziesz też instrukcje instalacji i przykładowy kod.

Co dalej?