Omówienie interfejsu Routes API

Routes API to usługa, która przyjmuje żądania HTTPS i zwraca idealną trasę między dwoma lokalizacjami lub odległość i czasy podróży, która stanowi macierz 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 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

  • Informacje o warunkach drogowych i zamknięciach dróg

  • kwestie bezpieczeństwa, takie jak unikanie niebezpiecznych miejsc lub zapewnienie bezpiecznych miejsc odbioru.

  • Znajdź równowagę między czasem oczekiwania, jakością i kosztami w zależności od potrzeb związanych z trasą dzięki funkcjom opcjonalnym, takim jak opłaty i metadane podróży, takie jak czas i odległość oraz spalanie

Możesz też określać najlepsze trasy do planowania wysyłki, takie jak:

  • Jak najlepiej przypisać zestaw instancji roboczych do odbioru serii pakietów

  • Określ najlepszy magazyn, z którego mają być wysyłane 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:

  • Dowiedz się, jak podróżować różnymi sposobami oraz do 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 maksymalnej skuteczności sposobu przemieszczania się.

  • Wiele sposobów określania miejsc wylotu, 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 długości i szerokości geograficznej, opcjonalnie z kierunkiem pojazdu

  • Możliwość dostosowania opcji tras do swoich potrzeb i celów:

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

Pobranie macierzy 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 pomóc Ci wybrać najlepsze miejsca wylotu i miejsca docelowe dostosowane do Twoich potrzeb biznesowych. Możesz prosić o takie dane o odległości:

  • Odległość dla wybranego środka transportu

  • Dystans w kilometrach lub milach

  • Szacowany czas podróży w korkach

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 docelowym.

Możesz strumieniować elementy odpowiedzi przed obliczeniem całej macierzy, co skraca czas oczekiwania na odpowiedź.

W żądaniu 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 równą 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 zawierającą jego szczegóły. Wymagane są atrybuty origin, destination, travelMode i maska pola określające, 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 zawierającą jego szczegóły. Wymagane są co najmniej 1 źródło, co najmniej 1 miejsce docelowe, TravelMode i maska pola do określania, 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 kombinacji wszystkich punktów początkowych i docelowych.

Zasoby

Poniższa tabela zawiera podsumowanie zasobów dostępnych za pośrednictwem interfejsu Routes API oraz zwracanych przez nie danych.

Zasoby danych Zwrócone dane Format zwracanych
ComputeRoute Zwraca trasy, etapy i kroki trasy z alternatywnymi trasami, jeśli jest to wymagane. 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 instrukcjami konfiguracji poniżej.
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 artykułach na temat pobierania macierzy tras i sprawdzania odpowiedzi macierzy tras.

Dostępne biblioteki klienta

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

Co dalej?