Obliczanie tras – informacje ogólne

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Wprowadzenie

Oblicz trasy to metoda w usłudze Routes API, która akceptuje żądanie HTTPS i zwraca idealną trasę między 2 miejscami. 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 wyznaczania tras? Jeśli interesuje Cię macierz wyznaczania tras, zapoznaj się z artykułem Obliczanie macierzy wyznaczania tras – omówienie.

Przenoszenie danych? Jeśli migrujesz z interfejsu Distance Matrix API (starszej wersji), zapoznaj się z instrukcjami migracji, zaczynając od sekcji Dlaczego warto przejść na interfejs Routes API.

Dlaczego warto korzystać z wyznaczania tras

Dzięki funkcji obliczania tras możesz wyznaczać trasy pojazdów lub przesyłek zgodnie ze swoimi preferencjami, jednocześnie optymalizując koszty i jakość.

Co można zrobić za pomocą funkcji Oblicz trasy?

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

  • Uzyskiwanie wskazówek dojazdu na różne sposoby oraz do jednego lub wielu miejsc docelowych:

    • Środki transportu: transport publiczny, samochody, pojazdy dwukołowe, piesi lub rowery.

    • Seria punktów pośrednich, które możesz zoptymalizować pod kątem najbardziej efektywnego porządku ich odwiedzania.

  • Możesz określić punkty początkowe, docelowe i przelotne na różne sposoby:

    • 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 pojazdu;

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

  • Zarządzaj opóźnieniem i jakością, prosząc o tylko te dane, których potrzebujesz, za pomocą maski pola. Pomoże Ci to uniknąć niepotrzebnego czasu przetwarzania i wyższych stawek rozliczeniowych za żądania. Szczegółowe informacje znajdziesz w artykule Wybieranie informacji do zwrócenia.

Jak działa narzędzie Wyznaczanie tras

Metoda ComputeRoutes interfejsu Routes API przyjmuje żądanie HTTP POST z treścią żądania w formacie JSON, która zawiera szczegóły żądania. Wymagane są parametry origin, destination, travelMode oraz maska pola, która określa, 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 pola, które zostały przez Ciebie zażądane.

Zasoby

W tabeli poniżej znajdziesz podsumowanie zasobów dostępnych za pomocą metody Compute Routes interfejsu Routes API oraz danych, które zwraca.

Zasoby danych Zwrócone dane Format zwracanej wartości
ComputeRoutes Zwraca trasy, odcinki i kroki na trasie, w tym alternatywne trasy, jeśli są dostępne. JSON

Jak korzystać z funkcji wyznaczania tras

1 Konfiguracja Zacznij od skonfigurowania projektu Google Cloud, a następnie wykonaj instrukcje konfiguracji.
2 Informacje o sposobie rozliczania interfejsu Routes API Więcej informacji znajdziesz w artykule Wykorzystanie i rozliczenia.
3 Obliczanie trasy i sprawdzanie odpowiedzi Więcej informacji znajdziesz w artykułach Pozyskiwanie trasy i Sprawdzanie odpowiedzi na zapytanie o trasę.

Dostępne biblioteki klienta

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

Co dalej?