Omówienie interfejsu Routes API

Interfejs Routes API to usługa, która akceptuje żądanie HTTPS i zwraca albo najlepszą trasę między 2 miejscami, albo odległości i czasy przejazdu dla macierzy tras między różnymi miejscami początkowymi i docelowymi.

Dlaczego warto korzystać z interfejsu Routes API

Interfejs Routes API umożliwia uzyskiwanie dokładnych tras i informacji o podróży na podstawie szczegółów transportu, aktualnych danych o naruszeniach w ruchu i preferencjach dotyczących trasy:

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

  • Kierunek, w którym jedzie pojazd

  • Strona drogi, po której pasażerowie wsiadają do pojazdu lub z niego wysiadają

  • warunki na drodze i zamknięcia dróg;

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

  • Uzyskaj równowagę między opóźnieniem, jakością i kosztem w przypadku różnych potrzeb związanych z kierowaniem, korzystając z opcjonalnych funkcji, takich jak opłaty drogowe i metadane dotyczące podróży, np. czas i odległość oraz wydajność paliwowa.

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

  • Jak najlepiej przypisać grupę pracowników do odbioru serii paczek

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

Co można robić za pomocą interfejsu Routes API?

Interfejs Routes API umożliwia uzyskanie 2 głównych kategorii informacji o kierowaniu:

  • Trasy z lokalizacji do jednego lub wielu miejsc docelowych

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

Wyznaczanie tras do jednego lub wielu miejsc docelowych

Za pomocą metody Compute Routes interfejsu Routes API możesz obliczyć:

  • Uzyskaj wskazówki dojazdu na różne sposoby do jednego lub wielu miejsc docelowych:

    • środki transportu, w tym transport publiczny, samochody, pojazdy dwukołowe, chodzenie pieszo lub jazda na rowerze;

    • 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, np. „Chicago, IL”, „Darwin, NT, Australia”, „1800 Amphitheatre Parkway, Mountain View, CA 94043” lub „CWF6+FWX Mountain View, California”.

    • Identyfikatory miejsc

    • współrzędne geograficzne, opcjonalnie z kierunkiem pojazdu;

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

  • Zarządzaj opóźnieniem i jakością, prosząc o tylko te dane, których potrzebujesz, za pomocą maski pola. Pomoże Ci to uniknąć niepotrzebnego czasu przetwarzania i wyższych stawek rozliczeniowych za żądania. Szczegółowe informacje znajdziesz w sekcji Wybieranie informacji do zwrócenia.

Pobieranie macierzy możliwych tras

Metoda interfejsu Routes API Compute Route Matrix udostępnia tablicę informacji o zalecanych trasach między wieloma punktami początkowymi i końcowymi, w tym odległość i szacowany czas przybycia, aby ułatwić wybór najlepszego miejsca początkowego i docelowego na podstawie potrzeb biznesowych. Możesz poprosić o te rodzaje danych o odległości:

  • Odległość dla wybranego środka transportu

  • Dystans w kilometrach lub milach

  • Szacowany czas podróży w korku

Dzięki danym o odległości możesz określić najskuteczniejszy sposób kierowania pasażerów, przesyłek lub pracowników między wieloma możliwymi punktami początkowymi i docelowymi.

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 przyjmuje żądanie HTTP POST z treścią żądania w formacie 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 pola, które zostały zażądane.

ComputeRouteMatrix

Interfejs Routes API ComputeRouteMatrix przyjmuje żądanie HTTP POST z treścią w formacie JSON zawierającą 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 kombinacji wszystkich punktów pośrednich źródła i celu.

Zasoby

Tabela poniżej zawiera podsumowanie zasobów dostępnych za pomocą interfejsu Routes API wraz z zwracanymi przez niego 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 Obliczanie macierzy tras i sprawdzanie odpowiedzi Więcej informacji znajdziesz w artykułach Pobieranie macierzy tras i Sprawdzanie odpowiedzi z macierzy tras.

Dostępne biblioteki klienta

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

Co dalej?