Omówienie interfejsu Routes API

Interfejs Routes API to usługa, która akceptuje żądanie HTTPS i zwraca idealną trasę między 2 lokalizacjami lub odległości i czasy podróży w przypadku macierzy tras między różnymi lokalizacjami początkowymi i docelowymi.

Dlaczego warto korzystać z interfejsu Routes API

Dzięki interfejsowi Routes API możesz uzyskiwać dokładne trasy i informacje o podróżach na podstawie szczegółów transportu, aktualnych informacji o natężeniu ruchu i warunkach na drodze oraz ustawień trasy:

  • Rodzaj i możliwości różnych środków transportu

  • Kierunek, w którym zmierza pojazd

  • Pobocze drogi do tego celu

  • Warunki drogowe i zamknięte drogi

  • kwestie bezpieczeństwa, takie jak unikanie niebezpiecznych obszarów lub zapewnianie bezpiecznych obszarów odbioru;

  • Zrównoważ czas oczekiwania, jakość i koszty w przypadku różnych tras, korzystając z opcjonalnych funkcji, takich jak opłaty za przejazd i metadane podróży, np. czas i odległość oraz spalanie

Możesz też wyznaczać najbardziej efektywne trasy na potrzeby planowania wysyłki, na przykład:

  • Jak najlepiej przypisać zbiór instancji roboczych do odbierania serii pakietów

  • Ustal najlepszy magazyn, z którego chcesz wysłać paczki do miejsca docelowego.

Do czego służy interfejs Routes API?

Interfejs Routes API udostępnia 2 główne kategorie informacji o routingu:

  • 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

Metoda Compute Routes interfejsu Routes API pozwala 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, samochodem, pojazdami dwukołowymi, pieszo lub rowerem.

    • Szereg punktów pośrednich, które można zoptymalizować pod kątem najefektywniejszego sposobu ich dotarcia.

  • Wiele sposobów określania punktu początkowego, docelowego 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

    • Długość i szerokość geograficzna, opcjonalnie z kierunkiem pojazdu

  • Dostosowywanie opcji tras do swoich potrzeb i celów:

  • Kontroluj czas oczekiwania i jakość, wysyłając żądania tylko do tych danych, których potrzebujesz. Za pomocą maski pola możesz uniknąć niepotrzebnego czasu przetwarzania i wyższych opłat za żądania. Szczegółowe informacje znajdziesz w sekcji Wybieranie informacji do zwrócenia.

Pobierz macierz możliwych tras

Metoda Compute Route Matrix interfejsu Routes API dostarcza informacji o zalecanych trasach między wieloma punktami początkowymi i końcowymi, w tym odległość i szacowany czas przyjazdu, aby pomóc Ci wybrać najlepsze miejsca wylotu i miejsca docelowe zgodnie z Twoimi potrzebami biznesowymi. Możesz prosić o dostęp do następujących danych o odległości:

  • Odległość w przypadku wybranego środka transportu

  • Dystans w kilometrach lub milach

  • Szacowany czas podróży przy korku

Dzięki danym o odległości możesz określić najwydajniejszy sposób kierowania pasażerów, przesyłki lub pracowników między różnymi miejscami wylotu i docelowym.

Możesz przesyłać strumieniowo elementy odpowiedzi, zanim cała macierz zostanie obliczona, co zmniejszy czas oczekiwania na odpowiedź.

Możesz określić wiele punktów początkowych i miejsc docelowych w żądaniu po stronie serwera przez liczbę punktów początkowych pomnożoną przez liczbę miejsc docelowych wynoszącą maksymalnie 625.

Jak działa interfejs Routes API

Interfejs Routes API ma 2 metody: ComputeRoutes i ComputeRouteMatrix.

ComputeRoutes

Metoda ComputeRoutes interfejsu Routes API akceptuje żądanie HTTP POST z treścią żądania JSON, która zawiera szczegóły żądania. Wymagane są atrybuty punktu początkowego, docelowego, podróżnego i maska pola, które określają, 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 1 miejsce docelowe, TravelMode i maska pola, które określają, które pola mają zostać zwrócone.

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 podsumowanie zasobów dostępnych w ramach interfejsu Routes API wraz z danymi zwróconymi przez nie.

Zasoby danych Zwrócone dane Format zwracanych
ComputeRoutes Zwraca w razie potrzeby trasy, etapy i kroki trasy z alternatywnymi trasami. JSON
ComputeRouteMatrix Zwraca tablicę tras z jednego punktu na trasie wylotu do jednego docelowego punktu na trasie.

Jak korzystać z interfejsu Routes API

1 Skonfiguruj Zacznij od konfigurowania projektu Google Cloud i postępuj zgodnie z poniższymi instrukcjami.
2 Obliczanie trasy i sprawdzanie odpowiedzi Więcej informacji znajdziesz w sekcjach Wyznaczanie trasy i Przeglądanie 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ę dostępnych bibliotek klienta dla interfejsu Routes API znajdziesz w artykule Biblioteki klienta.

Co dalej