Dlaczego warto korzystać z interfejsu Routes API
Dzięki interfejsowi Routes API możesz uzyskiwać dokładne informacje o trasach i podróży, korzystając z szczegółowych danych o transporcie, aktualnych informacji o naruszeniach w ruchu i preferencjach dotyczących tras:
Typy i możliwości różnych środków transportu
Kierunek, w którym jedzie pojazd
Strona drogi, po której pasażerowie wsiadają do pojazdu lub z niego wysiadają
warunki na drodze i zamknięcia dróg;
kwestie bezpieczeństwa, takie jak unikanie niebezpiecznych obszarów lub zapewnienie bezpiecznych miejsc odbioru;
Uzyskaj równowagę między opóźnieniem, jakością i kosztem w przypadku różnych potrzeb związanych z kierowaniem, korzystając z opcjonalnych funkcji, takich jak opłaty drogowe i metadane dotyczące podróży, w tym czasu i odległości oraz efektywności zużycia paliwa.
Możesz też określić najbardziej wydajne trasy do planowania wysyłki, takie jak:
Jak najlepiej przypisać grupę pracowników do odbioru serii paczek
Określanie najlepszego magazynu, z którego można wysłać paczki do ich ostatecznego miejsca przeznaczenia
Co można robić za pomocą interfejsu Routes API?
Interfejs Routes API umożliwia uzyskanie 2 głównych kategorii informacji o kierowaniu:
Trasy z lokalizacji do jednego lub wielu miejsc docelowych
Tablica możliwych tras między wieloma punktami początkowymi i końcowymi.
Wyznaczanie tras do jednego lub wielu miejsc docelowych
Za pomocą metody Compute Routes interfejsu API Tras możesz obliczyć odległość między lokalizacjami:
Uzyskaj wskazówki dojazdu na różne sposoby do jednego lub wielu miejsc docelowych:
środki transportu, w tym transport publiczny, samochody, pojazdy dwukołowe, chodzenie pieszo lub jazda na rowerze;
Seria punktów pośrednich, które możesz zoptymalizować pod kątem najbardziej efektywnej kolejności ich przejazdu.
Kilka sposobów na określenie miejsc odjazdu, miejsc docelowych i punktów pośrednich:
ciągi tekstowe, np. „Chicago, IL”, „Darwin, NT, Australia”, „1800 Amphitheatre Parkway, Mountain View, CA 94043” lub „CWF6+FWX Mountain View, California”.
Identyfikatory miejsc
współrzędne geograficzne, opcjonalnie z kierunkiem pojazdu;
Dostosuj opcje trasy do swoich potrzeb i celów:
Wybierz trasy z najniższym spalaniem paliwa lub energii dla typu silnika pojazdu: Diesla, elektrycznego, hybrydowego lub benzynowego. Więcej informacji znajdziesz w artykule Wyznaczanie trasy przyjaznej dla środowiska.
Ustawianie szczegółowych opcji obliczenia ruchu, które umożliwiają podejmowanie decyzji dotyczących kompromisu między jakością a opóźnieniem. Więcej informacji znajdziesz w artykule Określanie sposobu i czasu uwzględniania danych o ruchu.
Aby zwiększyć dokładność szacowanego czasu dotarcia, ustaw kierunek jazdy (kierunek podróży) i informacje o stronie drogi dla punktów orientacyjnych. Szczegółowe informacje znajdziesz w artykule Określanie kierunku jazdy i strony drogi.
Określ lokalizacje przesiadkowe i lokalizacje bezpiecznych miejsc przesiadkowych. Szczegółowe informacje znajdziesz w artykułach Ustawianie przystanku na trasie i Ustawianie punktu przelotu na trasie.
Poproś o informacje o opłatach drogowych, odległości dojazdu i szacowanym czasie dotarcia. Więcej informacji znajdziesz w artykule Obliczanie opłat za przejazd autostradą na danej trasie.
Zarządzaj opóźnieniem i jakością, prosząc o tylko te dane, których potrzebujesz, za pomocą maski pola. Pomoże Ci to uniknąć niepotrzebnego czasu przetwarzania i wyższych stawek rozliczeniowych za żądania. Szczegółowe informacje znajdziesz w artykule Wybieranie informacji do zwrócenia.
Pobieranie macierzy możliwych tras
Metoda interfejsu Routes API Compute Route Matrix udostępnia tablicę informacji o zalecanych trasach między wieloma punktami początkowymi i końcowymi, w tym odległość i szacowany czas przybycia, aby ułatwić wybór najlepszego miejsca początkowego i docelowego na podstawie potrzeb biznesowych. Możesz poprosić o te rodzaje danych o odległości:
Odległość dla wybranego środka transportu
Dystans w kilometrach lub milach
Szacowany czas podróży w korku
Dzięki danym o odległości możesz określić najskuteczniejszy sposób kierowania pasażerów, przesyłek lub pracowników między wieloma możliwymi punktami początkowymi i docelowymi.
Możesz przesyłać elementy odpowiedzi strumieniowo, zanim zostanie obliczona cała tablica, co zmniejsza opóźnienie odpowiedzi.
Możesz określić wiele źródeł i miejsc docelowych na żądanie po stronie serwera, podając liczbę źródeł razy liczbę miejsc docelowych do 625.
Jak działa interfejs Routes API
Interfejs API Routes ma 2 metody: ComputeRoutes i ComputeRouteMatrix.
ComputeRoutes
Metoda ComputeRoutes interfejsu Routes API przyjmuje żądanie HTTP POST z treścią żądania w formacie JSON, która zawiera szczegóły żądania. Wymagane są parametry origin, destination, travelMode i maska pola, która określa, które pola mają zostać zwrócone.
Przykład
curl -X POST -d '{
"origin": {
"address": "1800 Amphitheatre Parkway, Mountain View, CA 94043"
},
"destination": {
"address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132"
},
"travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \
'https://routes.googleapis.com/directions/v2:computeRoutes'
Usługa oblicza następnie żądaną trasę i zwraca pola, które zostały zażądane.
ComputeRouteMatrix
Interfejs Routes API ComputeRouteMatrix przyjmuje żądanie HTTP POST z treścią żądania w formacie JSON zawierającą szczegóły żądania. Wymagane są co najmniej 1 pochodzenie, co najmniej 2 miejsca docelowe, tryb podróży i maska pól, która określa, które pola mają zostać zwrócone.
Przykład
curl -X POST -d '{
"origins": [
{
"waypoint": {
"location": {
"latLng": {
"latitude": 37.420761,
"longitude": -122.081356
}
}
}
},
{
"waypoint": {
"location": {
"latLng": {
"latitude": 37.403184,
"longitude": -122.097371
}
}
}
}
],
"destinations": [
{
"waypoint": {
"location": {
"latLng": {
"latitude": 37.420999,
"longitude": -122.086894
}
}
}
},
{
"waypoint": {
"location": {
"latLng": {
"latitude": 37.383047,
"longitude": -122.044651
}
}
}
}
],
"travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \
'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'
Odpowiedź zawiera możliwe trasy dla kombinacji wszystkich punktów pośrednich źródła i celu.
Zasoby
Tabela poniżej zawiera podsumowanie zasobów dostępnych za pomocą interfejsu Routes API wraz z zwracanymi przez niego danymi.
| Zasoby danych | Zwrócone dane | Format zwracania |
|---|---|---|
| ComputeRoutes | Zwraca trasy, odcinki i kroki na trasie, w tym alternatywne trasy, jeśli są dostępne. | JSON |
| ComputeRouteMatrix | Zwraca tablicę dróg od jednego punktu początkowego do jednego punktu docelowego. |
Jak korzystać z interfejsu Routes API
| 1 | Konfiguracja | Zacznij od konfigurowania projektu Google Cloud i wykonaj podane niżej instrukcje konfiguracji. |
| 2 | Obliczanie trasy i sprawdzanie odpowiedzi | Więcej informacji znajdziesz w artykułach Pobieranie trasy i Sprawdzanie odpowiedzi na pytania dotyczące trasy. |
| 3 | Obliczanie macierzy tras i sprawdzanie odpowiedzi | Więcej informacji znajdziesz w artykułach Pobieranie macierzy tras i Sprawdzanie odpowiedzi z macierzy tras. |
Dostępne biblioteki klienta
Listę dostępnych bibliotek klienta interfejsu Routes API znajdziesz w sekcji Biblioteki klienta.