Omówienie interfejsu Routes API

Interfejs Routes API to usługa, która akceptuje żądania HTTPS oraz zwraca idealną trasę między dwiema lokalizacjami lub odległość i długość macierz tras między różnymi lokalizacjami początkowymi i docelowymi.

Dlaczego warto korzystać z interfejsu Routes API

Dzięki interfejsowi Routes API możesz uzyskać dokładne informacje o trasach i podróżach ze szczegółowymi informacjami o transporcie, aktualnymi informacjami o ruchu i warunkach na drodze oraz trasą ustawienia:

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

  • W którym kierunku jedzie pojazd

  • po stronie drogi, po której na miejscu zatrzymują się i podwożenia;

  • Warunki na drogach i zamknięte drogi

  • obawy związane z bezpieczeństwem, takie jak unikanie niebezpiecznych miejsc lub zapewnienie bezpiecznego odbioru do odbioru; obszary

  • Zoptymalizuj czas oczekiwania, jakość i koszty związane z routingiem za pomocą opcjonalnych opcji dane takie jak metadane dotyczące opłat i podróży, takie jak czas i odległość oraz paliwo efektywność

Możesz też określić najbardziej efektywne trasy do planowania wysyłki, takie jak jako:

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

  • Zidentyfikować najlepszy magazyn, z którego zostanie wysłane paczki do punktu końcowego. miejsce docelowe

Do czego służy interfejs Routes API?

Dzięki interfejsowi Routes API możesz uzyskać 2 główne kategorie routingu informacje:

  • 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

Za pomocą metody Compute Routes interfejsu Routes API można obliczyć dla różnych lokalizacji:

  • Wyznacz trasę dojazdu różnymi środkami transportu w przypadku pojedynczego lub kilku przejazdów miejsca docelowe:

    • Środki transportu, w tym transport publiczny, pojazdy, pojazdy dwukołowe, pieszo lub rowerem.

    • Seria punktów pośrednich, które można zoptymalizować pod kątem maksymalnej podróżnych.

  • Wiele sposobów określania miejsc wylotu, miejsc docelowych i punktów pośrednich:

    • Ciągi tekstowe. Na przykład: „Gdańsk, mazowieckie”, „Darwin, Terytorium Stołeczne, Polska”, „1800 Amphitheatre Parkway, Mountain View, CA 94043, USA” lub „CWF6+FWX Mountain” View, Kalifornia”

    • Identyfikatory miejsc

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

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

  • kontrolować czas oczekiwania i jakość, żądając tylko tych danych, których potrzebujesz, maską pola, która pomaga uniknąć niepotrzebnego czasu przetwarzania i zwiększyć i pytania o stawki. Więcej informacji: Wybierz informacje do zwrócenia.

Uzyskaj macierz możliwych tras

Metoda Compute Route Matrix interfejsu Routes API udostępnia macierz informacji o zalecanych trasach między punktem początkowym i końcowym punktów, w tym odległość i szacowany czas przyjazdu, aby łatwiej wybrać najlepsze miejsca wylotu i przylotu na podstawie do potrzeb biznesowych. Możesz prosić o te rodzaje danych o odległości:

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

  • Odległość w kilometrach lub milach

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

Dane o dystansie pozwolą Ci wyznaczyć najbardziej efektywny sposób pasażerów, przesyłek i pracowników między różnymi możliwymi punktami początkowymi miejsca docelowe.

Możesz przesyłać strumieniowo elementy odpowiedzi, zanim cała tablica zostanie utworzona obliczając to rozwiązanie, zmniejszając czas oczekiwania na odpowiedź.

W każdym żądaniu po stronie serwera możesz określić wiele punktów początkowych i miejsc docelowych za pomocą liczba miejsc wylotu pomnożona przez liczbę miejsc docelowych do 625.

Jak działa interfejs Routes API

Interfejs Routes API udostępnia 2 metody: ComputeRoutes i ComputeRouteMatrix

ComputeRoutes

Metoda ComputeRoutes interfejsu Routes API akceptuje żądanie HTTP POST z treść żądania JSON, która zawiera szczegóły żądania; Wymagane jest źródło, miejsce docelowe, tryb podróży i maska pola, które określają, które pola zwrócić.

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 wówczas żądaną trasę i zwraca pola poproszono o dostęp.

ComputeRouteMatrix

Interfejs Routes API ComputeRouteMatrix akceptuje żądanie HTTP POST z treść żądania JSON, która zawiera szczegóły żądania; Wymagane jest co najmniej 1 origin, co najmniej dwa miejsca docelowe, travelMode i maską pola, aby określić, 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 dla połączenia wszystkich źródeł oraz punkty pośrednie na trasie.

Zasoby

W tabeli poniżej znajdziesz podsumowanie zasobów dostępnych w Interfejs Routes API wraz z zwracanymi danymi.

Zasoby danych Zwrócone dane Format zwrotu
ComputeRoutes Zwraca trasy, nogi i kroki trasy wraz z trasami alternatywnymi, w razie potrzeby. JSON
ComputeRouteMatrix Zwraca tablicę tras z jednego punktu początkowego do jednego miejsca docelowego na trasie.

Jak korzystać z interfejsu Routes API

1 Konfiguracja Zacznij od skonfigurowania projektu Google Cloud. i wykonaj podane niżej instrukcje konfiguracji.
2 Obliczanie trasy i sprawdzanie odpowiedzi Więcej informacji znajdziesz w artykułach Wyznaczanie trasy i Przeglądanie odpowiedzi na pytania o trasę.
3 Obliczaj macierz tras i sprawdzaj odpowiedź Więcej informacji znajdziesz w artykule o wyznaczaniu tras. i Sprawdź odpowiedź macierzy tras.

Dostępne biblioteki klienta

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

Co dalej?