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:
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
obawy związane z bezpieczeństwem, takie jak unikanie niebezpiecznych miejsc lub zapewnienie bezpiecznego odbioru do odbioru; obszary
Zoptymalizuj czas oczekiwania, jakość i koszty związane z routingiem za pomocą opcjonalnych opcji dane takie jak metadane dotyczące opłat i podróży, takie jak czas i odległość oraz paliwo efektywność
Możesz też określić najbardziej efektywne trasy do planowania wysyłki, takie jak jako:
Jak najlepiej przypisać zbiór instancji roboczych do odbioru serii pakietów
Określanie najlepszego magazynu, z którego można wysłać paczki do ich ostatecznego miejsca przeznaczenia
Do czego służy interfejs Routes API?
Dzięki interfejsowi Routes API możesz uzyskać 2 główne kategorie routingu informacje:
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żna obliczyć dla różnych lokalizacji:
Wyznacz trasę dojazdu różnymi środkami transportu w przypadku pojedynczej podróży lub wielu środków transportu miejsca docelowe:
Środki transportu, w tym transport publiczny, pojazdy, pojazdy dwukołowe, pieszo lub rowerem.
Seria punktów pośrednich, które można zoptymalizować pod kątem maksymalnej podróżnych.
Wiele sposobów określania miejsc wylotu, miejsc docelowych i punktów pośrednich:
Ciągi tekstowe. Na przykład: „Gdańsk, mazowieckie”, „Darwin, Terytorium Stołeczne, Polska”, „1800 Amphitheatre Parkway, Mountain View, CA 94043, USA” lub „CWF6+FWX Mountain” View, Kalifornia”
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: Diesel, elektryczny, hybrydowy, benzynowy. Więcej informacji: Wybierz ekologiczną trasę.
Ustaw szczegółowe opcje obliczania ruchu, aby poprawić jakość i decyzja dotycząca kompromisu między opóźnieniami. Więcej informacji: Określ, czy i w jaki sposób chcesz uwzględniać dane o ruchu.
Ustaw informacje o kierunku pojazdu (kierunku jazdy) i informacjami o ulicy dla punkty pośrednie zwiększające dokładność szacowanego czasu dotarcia na miejsce. Więcej informacji: Określ nagłówek i stronę drogi.
Określ lokalizacje przejścia lub terminala oraz bezpieczne lokalizacje międzylądowania. Dla: szczegóły, patrz Ustaw przystanek na trasie. Wyznacz punkt trasy, przez którą chcesz przejść.
Poproś o informacje o numerze płatnym oraz informacje o odległości trasy i szacowanym czasie dotarcia na miejsce. Więcej informacji: Więcej informacji znajdziesz w artykule Obliczanie opłat drogowych.
kontrolować czas oczekiwania i jakość, żądając tylko tych danych, których potrzebujesz, maską pola, która pomaga uniknąć niepotrzebnego czasu przetwarzania i zwiększyć i pytania o stawki. 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 punktem początkowym i końcowym
punktów, w tym odległość i szacowany czas przyjazdu, aby łatwiej wybrać
najlepsze miejsca wylotu i przylotu na podstawie
do 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
Dane o dystansie pozwolą Ci wyznaczyć najbardziej efektywny sposób pasażerów, przesyłek i pracowników między różnymi możliwymi punktami początkowymi miejsca docelowe.
Możesz przesyłać strumieniowo elementy odpowiedzi, zanim cała tablica zostanie utworzona obliczając to rozwiązanie, zmniejszając czas oczekiwania na odpowiedź.
W każdym żądaniu po stronie serwera możesz określić wiele punktów początkowych i miejsc docelowych za pomocą liczba miejsc wylotu pomnożona 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ść żądania JSON, która zawiera szczegóły żądania; Wymagane jest źródło,
miejsce docelowe, tryb podróży i maska pola, które określają, które pola zwrócić.
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 wówczas żądaną trasę i zwraca pola poproszono o dostęp.
ComputeRouteMatrix
Interfejs Routes API ComputeRouteMatrix
akceptuje żądanie HTTP POST z
treść żądania JSON, która zawiera szczegóły żądania; Wymagane jest co najmniej 1
origin, co najmniej dwa miejsca docelowe, travelMode i maską pola, aby określić,
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 dla połączenia wszystkich źródeł oraz punkty pośrednie na trasie.
Zasoby
W tabeli poniżej znajdziesz podsumowanie zasobów dostępnych w Interfejs Routes API wraz z zwracanymi danymi.
Zasoby danych | Zwrócone dane | Format zwrotu |
---|---|---|
ComputeRoutes | Zwraca trasy, nogi i kroki trasy wraz z trasami alternatywnymi, w razie potrzeby. | JSON |
ComputeRouteMatrix | Zwraca tablicę tras z jednego punktu początkowego do jednego miejsca docelowego na trasie. |
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 artykule o wyznaczaniu tras. i Sprawdź odpowiedź macierzy tras. |
Dostępne biblioteki klienta
Listę bibliotek klienta dostępnych dla interfejsu Routes API znajdziesz w artykule Biblioteki klienta.