Obliczanie tras – informacje ogólne

Wprowadzenie

Compute Routes to metoda w usłudze Routes API, która akceptuje żądanie HTTPS i zwraca optymalną trasę między 2 lokalizacjami. Wyznaczaj trasy między wieloma lokalizacjami z uwzględnieniem informacji o ruchu w czasie rzeczywistym dla pieszych, transportu publicznego, rowerów, samochodów i silnikowych pojazdów jednośladowych.

Potrzebujesz macierzy tras? Jeśli interesuje Cię macierz tras, zapoznaj się z omówieniem macierzy wyznaczania tras.

Przeprowadzasz migrację? Jeśli przeprowadzasz migrację z interfejsu Distance Matrix API (starszego), zapoznaj się z instrukcjami migracji, zaczynając od sekcji Dlaczego warto przejść na interfejs Routes API.

Dlaczego warto korzystać z usługi Compute Routes

Dzięki Compute Routes możesz wyznaczać trasy dla pojazdów lub przesyłek zgodnie z własnymi preferencjami, optymalizując koszty i jakość, a także korzystać z szerokiego zakresu szczegółów trasy.

Co można robić za pomocą interfejsu Compute Routes?

Za pomocą metody Compute Routes interfejsu Routes API możesz:

• Wyświetlanie wskazówek dojazdu dla różnych środków transportu oraz dla jednego lub wielu miejsc docelowych:

  • Środki transportu: transport publiczny, samochód, pojazdy dwukołowe, pieszo lub rowerem.

  • Seria punktów, które możesz zoptymalizować pod kątem najbardziej efektywnej kolejności odwiedzania.

• Używaj różnych sposobów określania miejsc odjazdu, miejsc docelowych i punktów pośrednich:

  • ciągi tekstowe, Na przykład: „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 jazdy pojazdu

• Dostosuj opcje trasy do swoich potrzeb i celów:

  • Wybieraj trasy z najniższym spalaniem lub zużyciem energii dopasowane do typu silnika Twojego pojazdu: Diesel, Elektryczny, Hybrydowy, Benzynowy. Więcej informacji znajdziesz w artykule Wyznaczanie trasy przyjaznej dla środowiska.

  • Ustawiaj szczegółowe opcje obliczania ruchu, aby podejmować decyzje dotyczące kompromisu między jakością a opóźnieniem. Więcej informacji znajdziesz w artykule Określanie, jak i czy uwzględniać dane o ruchu.

  • Ustaw kierunek jazdy i informacje o stronie drogi dla punktów pośrednich, aby zwiększyć dokładność szacowanego czasu dotarcia na miejsce. Szczegółowe informacje znajdziesz w artykule Określanie kierunku jazdy pojazdu i strony drogi.

  • Określ lokalizacje przejazdowe i końcowe oraz bezpieczne miejsca postoju. Szczegółowe informacje znajdziesz w sekcjach Ustawianie przystanku na trasie i Ustawianie punktu, przez który ma przebiegać trasa.

  • Poproś o informacje o opłatach za przejazd, a także o długość trasy i szacowany czas dotarcia na miejsce. Więcej informacji znajdziesz w artykule Obliczanie opłat za przejazd na trasie.

• Kontroluj opóźnienia i jakość, wysyłając żądania tylko tych danych, których potrzebujesz, za pomocą maski pola. Pozwala to uniknąć niepotrzebnego czasu przetwarzania i wyższych stawek za żądania. Więcej informacji znajdziesz w sekcji Wybieranie informacji do zwrócenia.

Jak działa usługa Compute Routes

Metoda interfejsu Routes API ComputeRoutes akceptuje żądanie HTTP POST z treścią żądania w formacie JSON, która zawiera szczegóły żądania. Wymagane są punkt początkowy, punkt docelowy, travelMode i maska pola, która określa, które pola mają zostać zwrócone.

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 wybrane przez Ciebie pola.

Zasoby

W tabeli poniżej znajdziesz podsumowanie zasobów dostępnych za pomocą metody Compute Routes interfejsu Routes API oraz zwracanych przez nią danych.

Jak korzystać z usługi Compute Routes

Dostępne biblioteki klienta

Listę dostępnych bibliotek klienta dla Compute Routes znajdziesz w sekcji Biblioteki klienta.

Co dalej?

• Wyznaczanie trasy
• Dostępne opcje trasy
• Wybieranie informacji do zwrócenia
• Migracja ze starszej wersji interfejsu Directions API
• Migracja z wersji podglądowej interfejsu Routes API do wersji ogólnodostępnej