Obliczanie tras – informacje ogólne

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Wprowadzenie

Compute Routes to metoda w usłudze Routes API, która akceptuje żądanie HTTPS i zwraca idealną 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 artykułem Omówienie macierzy tras.

Migracja Jeśli przechodzisz z interfejsu Distance Matrix API (starsza wersja), zapoznaj się z instrukcjami migracji, zaczynając od sekcji Dlaczego warto przejść na Routes API.

Dlaczego warto korzystać z wyznaczania tras

Dzięki Compute Routes i szerokiemu zakresowi szczegółów trasy możesz kierować pojazdy lub przesyłki zgodnie z preferencjami, optymalizując koszty i jakość.

Co można zrobić za pomocą funkcji wyznaczania tras?

Metoda Compute Routes interfejsu Routes API umożliwia:

  • Uzyskaj wskazówki dojazdu różnymi środkami transportu do jednego lub kilku miejsc docelowych:

    • środki transportu: transport publiczny, samochód, pojazdy jednośladowe, ciężarówki, pieszo lub rower;

    • Seria punktów pośrednich, które możesz zoptymalizować, aby uzyskać najbardziej efektywną kolejność ich odwiedzania.

  • Używaj różnych sposobów określania miejsc początkowych, 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 szerokości i długości geograficznej, opcjonalnie z kierunkiem pojazdu

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

  • Kontroluj czas oczekiwania i jakość, żądając tylko potrzebnych danych za pomocą maski pola, co pomoże Ci uniknąć niepotrzebnego czasu przetwarzania i wyższych stawek za żądania. Więcej informacji znajdziesz w artykule Wybieranie informacji do zwrócenia.

Jak działa Compute Routes

Metoda ComputeRoutes interfejsu Routes API akceptuje żądanie POST HTTP z treścią żądania JSON, która zawiera szczegóły żądania. Wymagane są miejsce początkowe, miejsce docelowe, travelMode i maska pola, aby określić, 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'

Następnie usługa oblicza żądaną trasę i zwraca żądane 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.

Zasoby danych Zwrócone dane Format zwrotu
ComputeRoutes Zwraca trasy, odcinki i kroki dla trasy, wraz z trasami alternatywnymi, jeśli są wymagane. JSON

Jak korzystać z wyznaczania tras

1 Konfiguracja Zacznij od sekcji Konfigurowanie projektu Google Cloud i wykonaj podane w niej instrukcje konfiguracji.
2 Jak rozliczane są opłaty za interfejs Routes API Więcej informacji znajdziesz w artykule Wykorzystanie i rozliczenia.
3 Obliczanie trasy i sprawdzanie odpowiedzi Więcej informacji znajdziesz w artykułach Wyznaczanie trasy i Sprawdzanie odpowiedzi dotyczących trasy.

Dostępne biblioteki klienta

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

Co dalej?