Dlaczego warto korzystać z interfejsu Routes API
Dzięki interfejsowi Routes API możesz uzyskiwać dokładne trasy i informacje o podróży na podstawie szczegółów transportu, aktualnych informacji o natężeniu ruchu i warunkach na drodze oraz preferencji dotyczących trasy:
Rodzaj i możliwości różnych środków transportu
W którym kierunku zmierza pojazd.
Pobocze drogi do odbioru lub dostawy
warunki drogowe i zamknięte drogi,
Kwestie bezpieczeństwa, takie jak unikanie niebezpiecznych miejsc lub zapewnianie bezpiecznych obszarów odbioru
Znajdź równowagę między czasem oczekiwania, jakością i kosztami na potrzeby tras dzięki funkcjom opcjonalnym, takim jak opłaty i metadane podróży, takie jak czas i odległość oraz efektywność paliwa.
Możesz też określić najlepsze trasy do planowania wysyłki, na przykład:
Jak najlepiej przypisać zbiór instancji roboczych do odbierania serii pakietów
Wybierz najlepszy magazyn, z którego należy wysłać paczki do miejsca przeznaczenia.
Do czego służy interfejs Routes API?
Interfejs Routes API udostępnia 2 główne kategorie informacji o routingu:
Trasy z danej lokalizacji do jednego lub wielu miejsc docelowych
Tablica możliwych tras między wieloma lokalizacjami początkowymi i końcowymi.
Wyznaczanie tras do jednego lub wielu miejsc docelowych
Za pomocą metody Compute Routes
interfejsu Routes API możesz obliczać dane między lokalizacjami:
Wyznacz trasę dojazdu na różne sposoby oraz w przypadku jednego lub wielu miejsc docelowych:
Środki transportu, w tym transport publiczny, samochód, pojazd dwukołowy, pieszy lub rower.
Szereg punktów na trasie, które można zoptymalizować, aby zapewnić jak najefektywniejszą trasę dojazdu.
Wiele sposobów określania miejsc wylotu, miejsc docelowych i punktów na trasie:
Ciągi tekstowe. Na przykład: „Chicago, Illinois”, „Darwin, NT, Australia”, „1800 Amphitheatre Parkway, Mountain View, CA 94043” lub „CWF6+FWX Mountain View, California”.
Identyfikatory miejsc
Długość i szerokość geograficzna, opcjonalnie z kierunkiem pojazdu
Dostosowywanie opcji trasy do swoich potrzeb i celów:
Wybierz trasy z najniższym spalaniem lub energią w zależności od typu silnika: diesel, elektryczny, hybrydowy, gaz. Więcej informacji znajdziesz w artykule o trasie przyjaznej dla środowiska.
Możesz skonfigurować szczegółowe opcje obliczania ruchu, co pozwoli Ci podejmować decyzje dotyczące jakości i opóźnienia. Więcej informacji znajdziesz w sekcji Określanie, czy i w jaki sposób uwzględniać dane o ruchu.
Aby zwiększyć dokładność szacowanego czasu dotarcia, ustaw informacje o kierunku pojazdu (kierunku podróży) i stronach drogi dla punktów pośrednich. Więcej informacji znajdziesz w sekcji Określanie kierunku pojazdu i boku drogi.
Określ lokalizacje przelotów i terminali oraz bezpieczne miejsca docelowe. Więcej informacji znajdziesz w sekcjach Ustawianie przystanku na trasie i Ustawianie punktu drogi przez trasę.
Poproś o informacje o opłatach, odległość i szacowany czas dotarcia na miejsce. Więcej informacji znajdziesz w sekcji Obliczanie opłat za przejazd na trasie.
Kontroluj czas oczekiwania i jakość, wysyłając żądania tylko tych danych, których potrzebujesz, za pomocą maski pola. Pomoże Ci to uniknąć niepotrzebnego czasu przetwarzania i wyższych stawek za żądania. Szczegółowe informacje znajdziesz w sekcji Wybieranie informacji do zwrócenia.
Pobierz zestaw 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, aby ułatwić Ci wybór najlepszych miejsc wylotu i miejsc docelowych w zależności od potrzeb biznesowych. Możesz prosić o tego rodzaju dane o odległości:
Odległość dla wybranego środka transportu
Dystans w kilometrach lub milach
Szacowany czas podróży przy obecnym natężeniu ruchu
Dzięki danym o odległości możesz określić najefektywniejszy sposób kierowania pasażerów, przesyłek lub pracowników między wieloma możliwymi miejscami wylotu i docelowych.
Elementy odpowiedzi możesz przesyłać strumieniowo, zanim cała macierz zostanie obliczona, co zmniejszy czas oczekiwania na odpowiedź.
W ramach jednego żądania 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 nie większą niż 625.
Jak działa interfejs Routes API
Interfejs Routes API ma 2 metody: ComputeRoute
i ComputeRouteMatrix
.
ComputeRoute
Metoda ComputeRoute
interfejsu Routes API akceptuje żądanie HTTP POST z treścią żądania JSON, która zawiera szczegóły żądania. Wymagane są: punkt początkowy, miejsce docelowe, tryb podróży i maska pola do określenia, 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 żą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, która określa pola do zwrócenia.
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 na trasie wylotu i docelowego.
Zasoby
W tabeli poniżej znajdziesz listę zasobów dostępnych za pomocą interfejsu Routes API oraz zwróconych przez nie danych.
Zasoby danych | Zwrócone dane | Format zwracanych |
---|---|---|
ComputeRoute | Zwraca trasy, etapy i kroki dla trasy z alternatywnymi trasami, jeśli o to poprosisz. | JSON |
ComputeRouteMatrix | Zwraca tablicę tras z jednego punktu początkowego do jednego docelowego. |
Jak korzystać z interfejsu Routes API
1 | Konfiguracja | Zacznij od konfigurowania projektu Google Cloud i postępuj zgodnie z podanymi niżej instrukcjami konfiguracji. |
2 | Obliczanie trasy i sprawdzanie odpowiedzi | Więcej informacji znajdziesz w artykułach Wyznaczanie trasy i Sprawdzanie odpowiedzi na pytania dotyczące trasy. |
3 | Obliczanie macierzy tras i sprawdzanie odpowiedzi | Więcej informacji znajdziesz w sekcjach Uzyskiwanie macierzy tras i Sprawdzanie odpowiedzi macierzy tras. |
Dostępne biblioteki klienta
Listę bibliotek klienta dostępnych dla interfejsu Routes API znajdziesz w artykule Biblioteki klienta.