Omówienie interfejsu Routes API

Routes API to usługa, która przyjmuje żądanie HTTPS i zwraca idealną trasę między dwiema lokalizacjami lub odległości i czasy podróży w macierzy tras między różnymi lokalizacjami miejsca wylotu i docelowego.

Dlaczego warto korzystać z interfejsu Routes API

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

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

  • W którym kierunku zmierza pojazd.

  • Pobocze drogi do odbioru lub dostawy

  • warunki drogowe i zamknięte drogi,

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

  • Znajdź równowagę między czasem oczekiwania, jakością i kosztami na potrzeby tras dzięki funkcjom opcjonalnym, takim jak opłaty i metadane podróży, takie jak czas i odległość oraz efektywność paliwa.

Możesz też określić najlepsze trasy do planowania wysyłki, na przykład:

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

  • Wybierz najlepszy magazyn, z którego należy wysłać paczki do miejsca przeznaczenia.

Do czego służy interfejs Routes API?

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

  • Trasy z danej lokalizacji do jednego lub wielu miejsc docelowych

  • Tablica możliwych tras między wieloma lokalizacjami początkowymi i końcowymi.

Wyznaczanie tras do jednego lub wielu miejsc docelowych

Za pomocą metody Compute Routes interfejsu Routes API możesz 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, samochód, pojazd dwukołowy, pieszy lub rower.

    • Szereg punktów na trasie, które można zoptymalizować, aby zapewnić jak najefektywniejszą trasę dojazdu.

  • Wiele sposobów określania miejsc wylotu, miejsc docelowych i punktów na trasie:

    • Ciągi tekstowe. Na przykład: „Chicago, Illinois”, „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 trasy do swoich potrzeb i celów:

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

Pobierz zestaw możliwych tras

Metoda Compute Route Matrix interfejsu Routes API udostępnia macierz informacji o zalecanych trasach między wieloma punktami początkowymi i końcowymi, w tym odległość i szacowany czas przyjazdu, aby ułatwić Ci wybór najlepszych miejsc wylotu i miejsc docelowych w zależności od potrzeb biznesowych. Możesz prosić o tego rodzaju dane o odległości:

  • Odległość dla wybranego środka transportu

  • Dystans w kilometrach lub milach

  • Szacowany czas podróży przy obecnym natężeniu ruchu

Dzięki danym o odległości możesz określić najefektywniejszy sposób kierowania pasażerów, przesyłek lub pracowników między wieloma możliwymi miejscami wylotu i docelowych.

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

W ramach jednego żądania po stronie serwera możesz określić wiele punktów początkowych i miejsc docelowych, podając liczbę punktów początkowych pomnożoną przez liczbę miejsc docelowych nie większą niż 625.

Jak działa interfejs Routes API

Interfejs Routes API ma 2 metody: ComputeRoute i ComputeRouteMatrix.

ComputeRoute

Metoda ComputeRoute interfejsu Routes API akceptuje żądanie HTTP POST z treścią żądania JSON, która zawiera szczegóły żądania. Wymagane są: punkt początkowy, miejsce docelowe, tryb podróży i maska pola do określenia, 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 2 miejsca docelowe, TravelMode i maska pola, która określa 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 połączenia wszystkich punktów na trasie wylotu i docelowego.

Zasoby

W tabeli poniżej znajdziesz listę zasobów dostępnych za pomocą interfejsu Routes API oraz zwróconych przez nie danych.

Zasoby danych Zwrócone dane Format zwracanych
ComputeRoute Zwraca trasy, etapy i kroki dla trasy z alternatywnymi trasami, jeśli o to poprosisz. JSON
ComputeRouteMatrix Zwraca tablicę tras z jednego punktu początkowego do jednego docelowego.

Jak korzystać z interfejsu Routes API

1 Konfiguracja Zacznij od konfigurowania projektu Google Cloud i postępuj zgodnie z podanymi niżej instrukcjami konfiguracji.
2 Obliczanie trasy i sprawdzanie odpowiedzi Więcej informacji znajdziesz w artykułach Wyznaczanie trasy i Sprawdzanie 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ę bibliotek klienta dostępnych dla interfejsu Routes API znajdziesz w artykule Biblioteki klienta.

Co dalej