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 dla co najmniej 1 punktu na mapie. Na podstawie tych punktów znajduje się fragmenty dróg w pobliżu i zwraca identyfikator miejsca wraz z metadanymi, takimi jak najbliższy fragment i ograniczenia prędkości.

Dlaczego warto korzystać z interfejsu Roads API

Korzystając z interfejsu Roads API, możesz poznać ograniczenia prędkości, szacowany czas przyjazdu oraz inne metadane. Dzięki tym metadanym możesz ulepszyć swoje aplikacje samochodowe:

  • Połącz współrzędne geograficzne z drogą lub drogami.
  • Znajdź najbliższą drogę ze współrzędnymi
  • Ograniczenia prędkości na fragmentach dróg

Co można zrobić przy użyciu interfejsu Roads API

Roads API pozwala zmapować współrzędne GPS na geometrię drogi i określić ograniczenie prędkości na fragmentach drogi.

  • Przyciągnij do dróg Ta usługa zwraca najpopularniejsze trasy na podstawie podanego zestawu współrzędnych GPS. Możesz wyznaczyć do 100 punktów GPS na trasie. Opcjonalnie możesz też poprosić, aby usługa interpolowała dodatkowe punkty, co prowadzi do płynnej ścieżki geometrycznej drogi.
  • Najbliższe drogi Ta usługa zwraca najbliższy fragment drogi dla punktu GPS. Możesz określić do 100 punktów GPS. Wybrane przez Ciebie punkty nie muszą należeć do ścieżki ciągłej.
  • Ograniczenia prędkości – ta usługa zwraca opublikowane ograniczenie prędkości w przypadku danego fragmentu 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 na Google Maps Platform funkcja ta pozostaje aktywna.

Jak działa interfejs Roads API

Interfejs API Roads API udostępnia 3 punkty końcowe, które akceptują współrzędne geograficzne lub identyfikatory miejsc, aby udostępniać dane o ścieżkach, segmentach lub danych o ograniczeniach prędkości. Poniższy przykład pokazuje żądanie dotyczące 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

Poniższa tabela zawiera podsumowanie zasobów dostępnych przez interfejs API Roads wraz z zwróconymi danymi.

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

Zwraca tablicę do 100 punktów GPS z trasy. Zawiera uwzględnione w drodze współrzędne geograficzne i identyfikatory miejsc. Szczegóły znajdziesz w sekcji Odpowiedzi w przewodniku Przyciąganie do dróg.
  • JSON
Najbliższe drogi

Tablica ze 100 niezależnymi współrzędnymi szerokości i długości geograficznej oraz identyfikatory miejsc dotyczące najbliższej drogi dla każdego określonego punktu. Punkty nie muszą być ciągłe. Szczegóły znajdziesz w sekcji Odpowiedzi w przewodniku po najbliższych drogach.
Ograniczenia prędkości

Tablica zawierająca do 100 elementów metadanych drogi. Zawierają ograniczenia prędkości i identyfikatory miejsc, a ich jednostki to KPH lub MPH. Szczegółowe informacje znajdziesz w sekcji Odpowiedzi w przewodniku Ograniczenia prędkości.

Jak korzystać z interfejsu Roads API

1 Wypróbuj wersję demonstracyjną funkcji „Przyciągaj drogi” Kliknij wersję demonstracyjną, aby utworzyć ścieżkę, i zobacz, jak punkt końcowy przyciągania do dróg zapewnia płynne dane. Zobacz Demonstrację w przewodniku Przyciąganie do dróg. Nie potrzebujesz klucza interfejsu API.
2 Konfiguracja Zacznij od stworzenia projektu Google Cloud. Postępuj zgodnie z instrukcjami konfiguracji poniżej, 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 , a potem wybierz typ odpowiedni dla Twojego przypadku użycia.
4 Wyznaczanie limitów prędkości na trasie Korzystanie z tych samych danych o ścieżce, które zostały podane w przypadku żądania przyciągania do dróg wywołujących ograniczenia prędkości. Zobacz Przykładowe żądanie na podstawie ścieżki.
5 Dowiedz się, jak przetwarzać długie ścieżki Wykonaj czynności opisane w sekcji Przetwarzanie długich ścieżek w przewodniku Pojęcia zaawansowane.
6 Włącz dane o drodze do swojej aplikacji. Zapoznaj się ze szczegółowym przykładem kodu z przyciętej demonstracji, aby zacząć dodawać funkcje danych o drogach do własnej aplikacji.

Dostępne biblioteki klienta

Wywołaj ten interfejs API w wybranym przez siebie języku za pomocą jednej z tych bibliotek klientów:

Java Client, Python Client, Go Client i Node.js Client for Mapy Google to obsługiwane przez społeczność biblioteki klienta utworzone na licencji Apache 2.0. Pobierz je z GitHuba, gdzie znajdziesz również instrukcje instalacji i przykładowy kod.

Co dalej