Dlaczego warto korzystać z interfejsu Roads API
Dzięki interfejsowi Roads API możesz uzyskać informacje o ograniczeniach prędkości, szacowanym czasie przyjazdu i innych metadanych. Dzięki metadanym dróg możesz wzbogacić aplikacje do jazdy samochodem za pomocą następujących funkcji:
- Połączenie współrzędnych szerokości i długości geograficznej z drogą lub drogami.
- Znajdź najbliższą drogę dla zestawu współrzędnych
- Otrzymywanie informacji o ograniczeniach prędkości na fragmentach drogi
Co można robić za pomocą interfejsu Roads API
Roads API umożliwia przyporządkowanie współrzędnych GPS do geometrii drogi oraz określenie ograniczeń prędkości na poszczególnych fragmentach drogi.
- Przyciągaj do dróg Ta usługa zwraca najbardziej prawdopodobne drogi pokonane na podstawie podanego zestawu współrzędnych GPS. Możesz określić maksymalnie 100 punktów GPS zebranych wzdłuż trasy. Opcjonalnie możesz też poprosić o interpolację dodatkowych punktów, aby ścieżka płynnie się poruszała po geometrii drogi.
- Najbliższe drogi – ta usługa zwraca najbliższy fragment drogi dla punktu GPS. Możesz określić do 100 punktów GPS. Wskazane 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 danym fragmencie drogi. Usługa ograniczenia 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 udostępnia 3 punkty końcowe, które akceptują współrzędne szerokości i długości geograficznej lub identyfikatory miejsc, aby udostępniać dane o ścieżkach, fragmentach lub ograniczeniach prędkości. Poniższy 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
W tabeli poniżej znajdziesz podsumowanie zasobów dostępnych za pośrednictwem interfejsu Roads API oraz zwróconych przez niego danych.
Zasoby danych | Zwrócone dane | Format zwracanych |
---|---|---|
Przyciągaj do dróg |
Zwraca tablicę maksymalnie 100 punktów GPS z trasy. Obejmuje długość i szerokość geograficzną przypisanych dróg oraz identyfikatory miejsc. Więcej informacji znajdziesz w sekcji Odpowiedzi w przewodniku Przyciągaj do dróg. |
|
Najbliższe drogi |
Tablica do 100 niezależnych współrzędnych szerokości i długości geograficznej wraz z identyfikatorami miejsc dla najbliższej drogi w każdym określonym punkcie. Punkty nie muszą być ciągłe. Więcej informacji znajdziesz w sekcji Odpowiedzi w przewodniku Najbliższe drogi. |
|
Ograniczenia prędkości |
Tablica zawierająca maksymalnie 100 elementów metadanych drogi. Obejmują one ograniczenia prędkości i identyfikatory miejsc podane w km/h lub milach/h. Więcej informacji znajdziesz w sekcji Odpowiedzi w przewodniku Ograniczenia prędkości. |
Jak korzystać z interfejsu Roads API
1 | Wypróbuj demonstrację przyciągania do dróg | Kliknij wersję demonstracyjną, aby utworzyć ścieżkę i sprawdzić, jak przyciąganie do punktu końcowego dróg zapewnia płynność danych. Zapoznaj się z sekcją Demonstracja w przewodniku Przyciągaj do dróg. Nie potrzebujesz klucza interfejsu API. |
2 | Konfiguracja | Zacznij od konfigurowania projektu Google Cloud i postępuj zgodnie z instrukcjami konfiguracji poniżej. Następnie dowiedz się, jak używać klucza interfejsu API. |
3 | Wypróbuj funkcję przyciągania do dróg | Użyj jednego z przykładów przyciągania do dróg i wypróbuj tę, która pasuje do Twojego zastosowania. |
4 | Sprawdzanie 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 ograniczenia prędkości. Zapoznaj się z przykładowym żądaniem przy użyciu ścieżki. |
5 | Dowiedz się, jak przetwarzać długie ścieżki | Wykonaj czynności opisane w sekcjach dotyczących przetwarzania 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 przyspieszonej demonstracji kodu drogowego, aby zacząć wbudować w swoją aplikację funkcję danych o drogach. |
Dostępne biblioteki klienta
Wywołaj ten interfejs API w wybranym języku za pomocą jednej z tych bibliotek klienckich:
- Klient Java 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, Python, Go i Node.js dla usług Map Google to obsługiwane przez społeczność biblioteki klienckie udostępniane na licencji open source na 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 wysyłać żądania do interfejsu Roads API – otwórz usługę, która Cię interesuje:
- Pojęcia zaawansowane: przejdź do sekcji Zaawansowane pojęcia.
- Zastosuj sprawdzone metody: zapoznaj się ze sprawdzonymi metodami dotyczącymi usług internetowych.