Dlaczego warto korzystać z interfejsu Roads API
Za pomocą interfejsu Roads API możesz uzyskać informacje o ograniczeniach prędkości, szacowanym czasie przyjazdu i innych metadanych dróg. Dzięki tym metadanym o drogach możesz ulepszyć aplikacje dla kierowców przy użyciu tych funkcji:
- Łączenie współrzędnych szerokości i długości geograficznej z drogą lub drogami.
- Znajdź najbliższą drogę dla określonego zbioru współrzędnych
- Pobieranie informacji o ograniczeniach prędkości dla fragmentów drogi
Co można zrobić za pomocą interfejsu Roads API
Roads API pozwala mapować współrzędne GPS na geometrię drogi i określać ograniczenia prędkości na jej fragmentach drogi.
- Przyciągaj do dróg Ta usługa zwraca najbardziej prawdopodobne przebyte drogi na podstawie podanego zestawu współrzędnych GPS. Możesz wskazać do 100 punktów GPS na trasie. Opcjonalnie możesz też poprosić, by usługa interpolowała dodatkowe punkty, tworząc ścieżkę, która płynnie przebiega zgodnie z geometrią drogi.
- Najbliższe drogi – ta usługa zwraca najbliższy fragment drogi w przypadku punktu GPS. Możesz określić maksymalnie 100 punktów GPS. Wskazane punkty nie muszą należeć do ciągłej ścieżki.
- Ograniczenia prędkości Ta usługa zwraca ograniczenie prędkości opublikowane na danym fragmencie drogi. Usługa Ograniczenie prędkości jest dostępna dla wszystkich klientów z licencją na śledzenie zasobów. W przypadku klientów abonamentu premium na Google Maps Platform, którzy przeszli na model płatności według wykorzystania, funkcja pozostaje aktywna.
Jak działa interfejs Roads API
Interfejs 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 do podawania ścieżek, fragmentów lub danych o ograniczeniach prędkości. Poniższy przykład pokazuje żądanie udostępnienia 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
Tabela poniżej zawiera podsumowanie zasobów dostępnych przez interfejs Roads API oraz zwracanych przez nie danych.
Zasoby danych | Zwrócone dane | Format zwrotu |
---|---|---|
Przyciąganie do dróg |
Zwraca tablicę zawierającą maksymalnie 100 punktów GPS z trasy. Obejmuje przypisane do dróg współrzędne długości i szerokości geograficznej wraz z identyfikatorami miejsc. Szczegółowe informacje znajdziesz w sekcji Odpowiedzi w przewodniku Przyciągaj do dróg. |
|
Najbliższe drogi |
Tablica z maksymalnie 100 niezależnymi współrzędnymi szerokości i długości geograficznej wraz z identyfikatorami miejsc najbliższej drogi w przypadku każdego wskazanego punktu. Punkty nie muszą być ciągłe. Szczegóły znajdziesz w sekcji Odpowiedzi w przewodniku Najbliższe drogi. |
|
Ograniczenia prędkości |
Tablica z maksymalnie 100 elementami metadanych drogi. Obejmują one ograniczenia prędkości i identyfikatory miejsc, podane w kilometrach na godzinę lub mi/h. Szczegółowe informacje znajdziesz w sekcji Odpowiedzi w przewodniku Ograniczenia prędkości. |
Jak korzystać z interfejsu Roads API
1 | Wypróbuj aplikację Przyciągnij do dróg | Kliknij wersję demonstracyjną, aby utworzyć ścieżkę i sprawdź, jak przyciąganie do punktu końcowego dróg zapewnia płynne dane. Zobacz Demonstrację w przewodniku Przyciągaj do dróg. Nie potrzebujesz klucza interfejsu API. |
2 | Konfiguracja | Zacznij od skonfigurowania projektu Google Cloud i wykonaj podane instrukcje konfiguracji, a potem dowiedz się, jak używać klucza interfejsu API. |
3 | Wypróbuj prośbę o przyciągnięcie do dróg | Użyj jednego z przykładów przyciągania do dróg i wypróbuj ten, który pasuje do Twojego zastosowania. |
4 | Sprawdzanie ograniczeń prędkości na trasie | Korzystając z tych samych danych o ścieżce, które zostały podane w żądaniu przyciągania do dróg, wyślij zapytanie o ograniczenie prędkości. Zobacz przykładowe żądanie ze ścieżką. |
5 | Dowiedz się, jak przetwarzać długie ścieżki | Wykonaj sekcje Przetwarzanie długich ścieżek w przewodniku Pojęcia zaawansowane. |
6 | Umieść dane o drogach we własnej aplikacji. | Zapoznaj się ze szczegółowym przykładem kodu z demonstracji przyciągniętej drogi, aby zacząć tworzyć funkcję danych o drogach w swojej aplikacji. |
Dostępne biblioteki klienta
Wywołaj ten interfejs API w wybranym języku, używając jednej z tych bibliotek klienta:
- Klient Java dla usług Map Google
- Klient Pythona dla usług Map Google
- Klient Go dla usług Map Google
- Klient Node.js dla usług Map Google
Klient Java, klient Python, klient Go i klient Node.js dla usług Map Google to obsługiwane przez społeczność biblioteki klienta udostępniane na zasadach open source licencji Apache 2.0. Pobierz je z GitHuba, gdzie znajdziesz też instrukcje instalacji i przykładowy kod.
Co dalej
- Wypróbuj interfejs Roads API: otwórz inspektora dróg.
- Dowiedz się, jak tworzyć żądania do interfejsu Roads API: przejdź do interesującej Cię usługi:
- Pojęcia zaawansowane: przejdź do sekcji Advanced Concepts.
- Stosowanie sprawdzonych metod: przejdź do sekcji Sprawdzone metody dotyczące usług internetowych.