Omówienie interfejsu Roads API

Roads API to usługa, która akceptuje żądania HTTPS ze współrzędnymi geograficznymi jednego lub większej liczby punktów na mapie. Na podstawie tych punktów usługa znajduje 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, szacowanych czasach przyjazdu i innych metadanych dotyczących dróg. Na podstawie tych metadanych możesz rozszerzyć swoje aplikacje do nawigacji o te funkcje:

  • Łączenie współrzędnych geograficznych z drogą lub drogami.
  • Znajdowanie najbliższej drogi dla zestawu współrzędnych.
  • Pobieranie ograniczeń prędkości na odcinkach dróg.

Co możesz zrobić dzięki Roads API

Dzięki Roads API możesz przypisywać współrzędne GPS do geometrii drogi i określać ograniczenie prędkości na odcinkach dróg.

  • Przyciąganie do dróg Ta usługa zwraca najbardziej prawdopodobne drogi, którymi podróżowano, 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 spowoduje utworzenie ścieżki, która płynnie podąża za geometrią drogi.
  • Najbliższe drogi Ta usługa zwraca najbliższy odcinek drogi dla punktu GPS. Możesz podać maksymalnie 100 punktów GPS. Podane punkty nie muszą być częścią ciągłej ścieżki.
  • Ograniczenia prędkości Ta usługa zwraca opublikowane ograniczenie prędkości na odcinku drogi. Usługa Ograniczenia prędkości jest dostępna dla wszystkich klientów z licencją na śledzenie zasobów. W przypadku klientów korzystających z planu Premium Google Maps Platform , którzy przeszli na płatność według wykorzystania, ta funkcja pozostaje aktywna.

Jak działa Roads API

Roads API korzysta z 3 punktów końcowych, które akceptują współrzędne geograficzne lub identyfikatory miejsc, aby udostępniać ścieżki, odcinki dróg lub dane o ograniczeniach prędkości. Poniższy przykład pokazuje żądanie 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 oraz zwracanych przez nie danych.

Zasoby danych Zwracane dane Format zwracanych danych
Przyciąganie do dróg

Zwraca tablicę zawierającą maksymalnie 100 punktów GPS z trasy. Zawiera współrzędne geograficzne przyciągnięte do drogi oraz identyfikatory miejsc. Szczegółowe informacje znajdziesz w sekcji Odpowiedzi w przewodniku Przyciąganie do dróg.
  • JSON
Najbliższe drogi

Tablica zawierająca maksymalnie 100 niezależnych współrzędnych geograficznych oraz identyfikatory miejsc najbliższej drogi dla każdego podanego 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ą podane 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ą przyciągania do dróg Kliknij wersję demonstracyjną, aby utworzyć ślad i zobaczyć, jak punkt końcowy przyciągania do dróg zapewnia płynne dane. Więcej informacji znajdziesz w sekcji Wersja demonstracyjna w przewodniku Przyciąganie do dróg. Nie potrzebujesz klucza interfejsu API.
2 Konfiguracja Zacznij od skonfigurowania projektu Google Cloud i wykonania kolejnych instrukcji 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 jest odpowiedni dla Twojego przypadku użycia.
4 Pobierz ograniczenia prędkości na ścieżce Używając tych samych danych ścieżki, które zostały podane w żądaniu przyciągania do dróg, wyślij zapytanie o ograniczenie prędkości. Więcej informacji znajdziesz w sekcji Przykładowe żądanie z użyciem ścieżki.
5 Dowiedz się, jak przetwarzać długie ścieżki Zapoznaj się z sekcjami dotyczącymi przetwarzania długich ścieżek w przewodniku Zaawansowane koncepcje.
6 Włącz dane o drogach w swojej aplikacji Aby zacząć tworzyć funkcję danych o drogach w swojej aplikacji, zapoznaj się ze szczegółowym przykładem kodu z wersji demonstracyjnej przyciągania do dróg.

Dostępne biblioteki klienta

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

Biblioteki Java Client, Python Client, Go Client i Node.js Client for Google Maps Services to biblioteki klienta obsługiwane przez społeczność, udostępniane na licencji Apache 2.0. Możesz je pobrać z GitHuba, gdzie znajdziesz też instrukcje instalacji i przykładowy kod.

Co dalej?