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:

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

  • Kierunek, w którym 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

  • Określanie najlepszego magazynu, z którego można wysłać paczki do ich ostatecznego miejsca przeznaczenia

Do czego służy interfejs Routes API?

Za pomocą interfejsu Routes API możesz uzyskać 2 podstawowe kategorie informacji o kierowaniu:

  • Trasy z 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ż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żesz zoptymalizować pod kątem najbardziej efektywnej kolejności ich przejazdu.

  • Kilka sposobów na określenie miejsc odjazdu, miejsc docelowych i punktów pośrednich:

    • Ciągi tekstowe. Przykłady: „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 kierowaniem pojazdu

  • Dostosuj opcje trasy 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 poprosić 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 w korku

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ć elementy odpowiedzi strumieniowo, zanim zostanie obliczona cała tablica, co zmniejsza opóźnienie odpowiedzi.

Możesz określić wiele źródeł i miejsc docelowych na żądanie po stronie serwera, podając liczbę źródeł razy liczbę miejsc docelowych do 625.

Jak działa interfejs Routes API

Interfejs API Routes ma 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 są parametry origin, destination, travelMode i 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'

Usługa oblicza następnie żądaną trasę i zwraca żądane pola.

ComputeRouteMatrix

Interfejs Routes API ComputeRouteMatrix akceptuje żądanie HTTP POST z treść żądania JSON, która zawiera szczegóły żądania; Wymagane są co najmniej 1 pochodzenie, co najmniej 2 miejsca docelowe, tryb podróży i maska pól, która określa, 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 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 zwracanej wartości
ComputeRoutes Zwraca trasy, odcinki i kroki na trasie, w tym alternatywne trasy, jeśli są dostępne. JSON
ComputeRouteMatrix Zwraca tablicę dróg od jednego punktu początkowego do jednego punktu docelowego.

Jak korzystać z interfejsu Routes API

1 Konfiguracja Zacznij od konfigurowania projektu Google Cloud i wykonaj podane niżej instrukcje konfiguracji.
2 Obliczanie trasy i sprawdzanie odpowiedzi Więcej informacji znajdziesz w artykułach Pobieranie trasy i Sprawdzanie odpowiedzi na pytania dotyczące trasy.
3 Obliczaj macierz tras i sprawdzaj odpowiedź Więcej informacji znajdziesz w artykułach Pobieranie macierzy tras i Sprawdzanie odpowiedzi z macierzy tras.

Dostępne biblioteki klienta

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

Co dalej?