Method: computeRoutes

Zwraca główną trasę między żądanym miejscem początkowym a docelowym dla żądanego środka transportu.

Żądanie HTTP

POST https://mapstools.googleapis.com/v1:computeRoutes

Adres URL używa składni transkodowania gRPC.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "travelMode": enum (RouteTravelMode),
  "intermediateWaypoints": [
    {
      object (Waypoint)
    }
  ],
  "routingPreference": enum (RoutingPreference),
  "locationBias": {
    object (LatLng)
  },
  "includePolyline": boolean,
  "computeAlternativeRoutes": boolean,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "departureTime": string,
  "arrivalTime": string
  // End of mutually exclusive fields.
}
Pola
origin

object (Waypoint)

Wymagane. Punkt na trasie będący punktem początkowym.
destination

object (Waypoint)

Wymagane. Punkt na trasie miejsca docelowego.
travelMode

enum (RouteTravelMode)

Opcjonalnie. Określa środek transportu.
intermediateWaypoints[]

object (Waypoint)

Opcjonalnie. Przystanki pośrednie między miejscem początkowym a docelowym, przez które należy przejechać w odpowiedniej kolejności. Obsługiwanych jest maksymalnie 25 punktów pośrednich.

Określenie więcej niż 10 punktów pośrednich spowoduje wzrost kosztów i opóźnienia. Punkty pośrednie nie są obsługiwane, gdy parametr travelMode ma wartość TRANSIT.
routingPreference

enum (RoutingPreference)

Opcjonalnie. Określa, jak dane o natężeniu ruchu są używane do obliczania trasy. ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL nie jest obsługiwany, gdy travelMode to WALK lub BICYCLE. W przypadku TRANSIT umożliwia to wyświetlanie danych o transporcie publicznym w czasie rzeczywistym, takich jak opóźnienia i odwołania.
locationBias

object (LatLng)

Opcjonalnie. Lokalizacja, która ma być preferowana w wynikach wyszukiwania, np. w celu uściślenia zapytań tekstowych dotyczących punktów orientacyjnych.
includePolyline

boolean

Opcjonalnie. Określa, czy w trasach odpowiedzi ma być uwzględniona zakodowana linia łamana. Domyślna wartość to false. Jeśli ustawisz wartość true, zwracany jest błąd Route.encoded_polyline.
computeAlternativeRoutes

boolean

Opcjonalnie. Określa, czy oprócz zalecanej trasy mają być obliczane trasy alternatywne. Wartość domyślna to false, co oznacza, że zwracana jest tylko zalecana trasa. Jeśli ustawiona jest wartość prawda, zwracane są wszystkie dostępne trasy, chociaż alternatywne trasy mogą nie być dostępne w przypadku każdego żądania.
Określa, kiedy należy wyruszyć z miejsca początkowego lub dotrzeć do ostatniego punktu orientacyjnego. Jeśli nie zostanie podany, domyślnie przyjmuje się bieżący czas odjazdu. W przypadku TRANSIT czas musi przypadać nie wcześniej niż 7 dni temu i nie później niż za 100 dni. W przypadku innych środków transportu czas nie może być w przeszłości i może wynosić maksymalnie 365 dni w przyszłości. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
departureTime

string (Timestamp format)

Opcjonalnie. Wskazuje, że trasa powinna być obliczana na podstawie czasu wyjazdu.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
arrivalTime

string (Timestamp format)

Opcjonalnie. Wskazuje, że trasa powinna być obliczana na podstawie czasu przybycia.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".
Koniec pól wykluczających się wzajemnie.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu ComputeRoutesResponse.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/maps-platform.mapstools