Omówienie interfejsu Roads API

Roads API to usługa, która akceptuje żądania HTTPS z współrzędnymi geograficznymi (długości i szerokości geograficznej) co najmniej 1 punktu na mapie. Korzysta on z tych punktów 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 używać interfejsu Roads API

Dzięki interfejsowi Roads API możesz uzyskiwać informacje o ograniczeniach prędkości, szacowanych 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żna zrobić za pomocą interfejsu 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 podać maksymalnie 100 punktów danych GPS zebranych wzdłuż trasy. Opcjonalnie możesz też poprosić, aby usługa interpolowała dodatkowe punkty, co spowoduje, że ścieżka będzie płynnie podążać za geometrią drogi.
  • Najbliższe drogi – ta usługa zwraca najbliższy odcinek drogi dla podanego 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 interfejs Roads API

Interfejs Roads API korzysta z 3 punktów końcowych, które przyjmują współrzędne geograficzne lub identyfikatory miejsc, aby dostarczać dane o drogach, ich odcinkach lub ograniczeniach prędkości. Ten 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 za pomocą interfejsu Roads API wraz z zwracanymi przez niego danymi.

Zasoby danych Zwrócone dane Format zwracania
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 zmapowane na drogę oraz identyfikatory miejsc. Szczegółowe informacje znajdziesz w sekcji Odpowiedzi w przewodniku Dopasowywanie do dróg.
  • JSON
Najbliższe drogi

Tablica zawierająca maksymalnie 100 niezależnych współrzędnych szerokości i długości geograficznej 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 jednostkach km/h lub mil/h. Szczegółowe informacje znajdziesz w odpowiedziach w przewodniku Ograniczenia prędkości.

Jak korzystać z interfejsu Roads API

1 Wypróbuj demonstrację funkcji dopasowywania do dróg Kliknij demonstrację, aby utworzyć ścieżkę i zobaczyć, jak punkt końcowy dopasowywania do dróg zapewnia płynne dane. Zapoznaj się z przykładem w przewodniku Przyciąganie do dróg. Nie potrzebujesz klucza API.
2 Konfiguracja Zacznij od konfiguracji 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ęć i wypróbuj 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 Przeczytaj sekcje dotyczące 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 obsługi Usług Map Google są wspierane przez społeczność i udostępnione na licencji Apache 2.0. Pobierz je z GitHuba, gdzie znajdziesz też instrukcje instalacji i przykładowy kod.

Co dalej?