Dlaczego warto korzystać z interfejsu Routes API
Za pomocą interfejsu Routes API możesz uzyskać dokładne informacje o trasach i przejazdach, korzystając ze szczegółów transportu, aktualnych informacji o natężeniu ruchu i warunkach na drodze oraz preferencji dotyczących tras:
Rodzaje i możliwości różnych środków transportu
W którym kierunku jedzie pojazd
po stronie drogi, po której na miejscu zatrzymują się i podwożenia;
Warunki na drogach i zamknięte drogi
kwestie dotyczące bezpieczeństwa, takie jak unikanie niebezpiecznych obszarów lub zapewnienie bezpiecznych obszarów odbioru.
Zoptymalizuj czas oczekiwania, jakość i koszty związane z trasą dzięki opcjonalnym funkcjom, takim jak opłaty drogowe i metadane podróży, takie jak czas, odległość czy oszczędność paliwa.
Możesz też określić najbardziej efektywne trasy do planowania wysyłki, takie jak:
Jak najlepiej przypisać zbiór instancji roboczych do odbioru serii pakietów
Ustalić najlepszy magazyn, z którego można wysłać paczki do miejsca docelowego.
Do czego służy interfejs Routes API?
Interfejs Routes API udostępnia 2 główne kategorie informacji o routingu:
trasy z lokalizacji do jednego lub wielu miejsc docelowych,
Tablica możliwych tras między wieloma lokalizacjami początkowymi i końcowymi.
Wyznaczaj trasy do jednego lub wielu miejsc docelowych
Za pomocą metody Compute Routes interfejsu Routes API możesz obliczać dane dla poszczególnych lokalizacji:
Wskazówki dojazdu do różnych sposobów podróży i do jednego lub wielu miejsc docelowych:
Środki transportu, w tym transport publiczny, jazda samochodem, pojazdy dwukołowe, spacery lub rowery.
Seria punktów pośrednich, które można zoptymalizować pod kątem maksymalnej kolejności ich poruszania się.
Wiele sposobów określania miejsc wylotu, miejsc docelowych i punktów pośrednich:
Ciągi tekstowe. Na przykład: „Gdańsk, Irlandia”, „Darwin, NT, Australia”, „Emilii Plater 23, Warszawa”.
Identyfikatory miejsc
Długość i szerokość geograficzna, opcjonalnie z kierowaniem pojazdu
Dostosuj opcje tras do swoich potrzeb i celów:
Wybierz trasy, które pozwalają oszczędzać paliwo lub energię w przypadku typu silnika: Olej napędowy, elektryczny, hybrydowy, benzynowy. Więcej informacji znajdziesz w artykule o wyznaczaniu tras ekologicznych.
Możesz ustawić szczegółowe opcje obliczania ruchu, aby podejmować decyzje na temat kompromisu między jakością a czasem oczekiwania. Więcej informacji znajdziesz w artykule Określanie, jak i czy chcesz uwzględniać dane o ruchu.
Ustaw informacje o nagłówku pojazdu (kierunku podróży) i informacjach o drogach, aby zwiększyć dokładność szacowanego czasu dotarcia na miejsce. Więcej informacji znajdziesz w artykule Określanie kierunku i strony drogi.
Określ lokalizacje przejścia lub terminala oraz bezpieczne lokalizacje międzylądowania. Więcej informacji znajdziesz w sekcjach Ustawianie przystanku na trasie i Ustawianie punktu trasy, przez którą przebiega trasa.
Poproś o informacje o numerze płatnym oraz informacje o odległości trasy i szacowanym czasie dotarcia na miejsce. Więcej informacji znajdziesz w artykule Obliczanie opłat za przejazd.
Kontroluj czas oczekiwania i jakość, żądając tylko tych danych, których potrzebujesz, za pomocą maski pola. Pozwala to uniknąć niepotrzebnego czasu przetwarzania i wyższych opłat za żądania. Szczegółowe informacje znajdziesz w sekcji Wybieranie informacji do zwrócenia.
Uzyskaj macierz możliwych tras
Metoda Compute Route Matrix interfejsu Routes API udostępnia macierz informacji o zalecanych trasach między wieloma punktami początkowymi i końcowymi, w tym odległość i szacowany czas przyjazdu. Ułatwia to wybranie najlepszych miejsc wylotu i miejsc docelowych na podstawie potrzeb biznesowych. Możesz prosić o te rodzaje danych o odległości:
Odległość w przypadku wybranego środka transportu
Odległość w kilometrach lub milach
Szacowany czas podróży przy dużym natężeniu ruchu
Dzięki danym o odległości możesz określić najskuteczniejszy sposób kierowania pasażerów, przesyłek i pracowników między różnymi miejscami wylotu i miejsc docelowych.
Możesz przesyłać strumieniowo elementy odpowiedzi, zanim cała matryca zostanie obliczona. Skraca to czas oczekiwania na odpowiedź.
W każdym żądaniu po stronie serwera możesz określić wiele punktów początkowych i miejsc docelowych, podając liczbę punktów początkowych pomnożoną przez liczbę miejsc docelowych do 625.
Jak działa interfejs Routes API
Interfejs Routes API udostępnia 2 metody: ComputeRoutes i ComputeRouteMatrix.
ComputeRoutes
Metoda ComputeRoutes interfejsu Routes API akceptuje żądanie HTTP POST z treścią żądania JSON, która zawiera szczegóły żądania. Wymagane są pola wylotu, miejsca docelowego, tryb podróży i maska pola, które określają, które pola zwracać.
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'
Następnie usługa oblicza żądaną trasę i zwraca żądane pola.
ComputeRouteMatrix
Interfejs Routes API ComputeRouteMatrix akceptuje żądanie HTTP POST z treścią żądania JSON, która zawiera szczegóły żądania. Wymagane są co najmniej 1 źródło, co najmniej 2 miejsca docelowe, TravelMode i maska pola do określania, które pola mają być zwracane.
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 połączenia wszystkich punktów początkowych i docelowych.
Zasoby
W tabeli poniżej znajdziesz podsumowanie zasobów dostępnych przez interfejs Routes API oraz zwracanych przez nie danych.
| Zasoby danych | Zwrócone dane | Format zwrotu |
|---|---|---|
| ComputeRoutes | Zwraca trasy, etapy i kroki trasy wraz z trasami alternatywnymi, jeśli są wymagane. | JSON |
| ComputeRouteMatrix | Zwraca tablicę tras z jednego punktu początkowego do jednego docelowego punktu. |
Jak korzystać z interfejsu Routes API
| 1 | Konfiguracja | Zacznij od skonfigurowania projektu Google Cloud i wykonaj podane niżej instrukcje konfiguracji. |
| 2 | Obliczanie trasy i sprawdzanie odpowiedzi | Więcej informacji znajdziesz w artykułach Wyznaczanie trasy i Przeglądanie odpowiedzi na pytania o trasę. |
| 3 | Obliczaj macierz tras i sprawdzaj odpowiedź | Więcej informacji znajdziesz w sekcjach Uzyskiwanie macierzy tras i Sprawdzanie odpowiedzi macierzy. |
Dostępne biblioteki klienta
Listę bibliotek klienta dostępnych dla interfejsu Routes API znajdziesz w artykule Biblioteki klienta.