Method: computeRoutes

{
  "routeLabels": [
    enum (RouteLabel)
  ],
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "optimizedIntermediateWaypointIndex": [
    integer
  ],
  "localizedValues": {
    object (RouteLocalizedValues)
  },
  "routeToken": string
}

enum (RouteLabel)

Etykiety Route umożliwiające identyfikację konkretnych właściwości trasy, które można porównać z innymi.

object (RouteLeg)

Zespół ścieżek (odcinków ścieżek między punktami na trasie), które tworzą trasę. Każdy etap odpowiada podróży między 2 elementami Waypoints spoza via. Na przykład trasa bez pośrednich punktów na trasie ma tylko jeden etap. Trasa obejmująca jeden pośredni punkt na trasie inny niż via ma dwa etapy. Trasa obejmująca jeden pośredni punkt na trasie via ma jeden etap. Kolejność punktów jest zgodna z kolejnością punktów pośrednich od origin do intermediates do destination.

integer

Długość trasy w metrach.

string (Duration format)

Długość czasu potrzebnego na pokonanie trasy. Jeśli ustawisz routingPreference na TRAFFIC_UNAWARE, ta wartość jest taka sama jak staticDuration. Jeśli ustawisz routingPreference na TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL, ta wartość jest obliczana z uwzględnieniem warunków ruchu.

Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „s”. Przykład: "3.5s".

string (Duration format)

Długość przejazdu wzdłuż trasy bez uwzględniania warunków drogowych.

Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „s”. Przykład: "3.5s".

object (Polyline)

Całkowita linia łamana trasy. Ta linia łamana jest połączona linią łamaną wszystkich elementów legs.

string

Opis trasy.

string

Tablica ostrzeżeń do wyświetlenia przy wyświetlaniu trasy.

object (Viewport)

Ramka ograniczająca widoczny obszar linii łamanej.

object (RouteTravelAdvisory)

dodatkowe informacje o trasie,

integer

Jeśli ustawisz optimizeWaypointOrder na wartość true, to pole będzie zawierać zoptymalizowaną kolejność pośrednich punktów pośrednich. W przeciwnym razie to pole jest puste. Jeśli na przykład podasz dane punktu początkowego: LA; pośrednie punkty na drodze: Dallas, Bangor, Phoenix; cel podróży: Nowy Jork; a zoptymalizowana pośrednia kolejność punktów pośrednich to Phoenix, Dallas, Bangor, to pole zawiera wartości [2, 0, 1]. Indeks zaczyna się od 0 w przypadku pierwszego pośredniego punktu pośredniego podanego w danych wejściowych.

object (RouteLocalizedValues)

Reprezentacje tekstowe właściwości obiektu Route.

string

Bezpieczny w internecie token trasy zakodowany w base64, który można przekazać do pakietu SDK Navigation SDK, który umożliwia zrekonstruowanie trasy podczas nawigacji, a w przypadku zmiany trasy musi uwzględniać pierwotny cel utworzony podczas tworzenia trasy przez wywołanie metody v2.computeRoutes. Klienci powinni traktować ten token jako nieprzezroczysty obiekt blob. Nie służy do odczytywania tekstu ani wprowadzania mutacji. UWAGA: Route.route_token jest dostępne tylko dla żądań, dla których ComputeRoutesRequest.routing_preference ma wartość TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL. Funkcja Route.route_token nie jest obsługiwana w przypadku żądań z punktami pośrednimi Via.

{
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegLocalizedValues)
  },
  "stepsOverview": {
    object (StepsOverview)
  }
}

integer

Odległość pokonywania odcinka trasy w metrach.

string (Duration format)

Długość czasu potrzebnego na poruszanie się nogą. Jeśli route_preference ma wartość TRAFFIC_UNAWARE, ta wartość jest taka sama jak staticDuration. Jeśli route_preference to TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL, ta wartość jest obliczana z uwzględnieniem warunków ruchu.

Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „s”. Przykład: "3.5s".

string (Duration format)

Długość przejazdu przez odcinek, obliczona bez uwzględniania warunków drogowych.

Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „s”. Przykład: "3.5s".

object (Polyline)

Ogólna linia łamana tej odnogi obejmująca linię łamaną każdego elementu step.

object (Location)

Lokalizacja początkowa tego etapu. Ta lokalizacja może się różnić od podanej lokalizacji origin. Jeśli na przykład podany origin nie znajduje się w pobliżu drogi, jest to punkt na drodze.

object (Location)

Lokalizacja końcowa tego etapu. Ta lokalizacja może się różnić od podanej lokalizacji destination. Jeśli na przykład podany destination nie znajduje się w pobliżu drogi, jest to punkt na drodze.

object (RouteLegStep)

Tablica kroków oznaczających segmenty w tym odcinku. Każdy krok odpowiada jednej instrukcji nawigacji.

object (RouteLegTravelAdvisory)

Zawiera dodatkowe informacje, o których należy poinformować użytkownika, np. możliwe ograniczenia strefy ruchu na danym etapie trasy.

object (RouteLegLocalizedValues)

Reprezentacje tekstowe właściwości obiektu RouteLeg.

object (StepsOverview)

Omówienie czynności, które musisz wykonać w tym artykule (RouteLeg). Pole jest wypełniane tylko w przypadku tras TRANSIT.

{

  // Union field polyline_type can be only one of the following:
  "encodedPolyline": string,
  "geoJsonLinestring": {
    object
  }
  // End of list of possible types for union field polyline_type.
}

string

Kodowanie ciągu łamanego linii łamanej za pomocą algorytmu kodowania linii łamanej

object (Struct format)

Wskazuje linię łamaną w formacie linii GeoJSON.

{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelAdvisory": {
    object (RouteLegStepTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegStepLocalizedValues)
  },
  "transitDetails": {
    object (RouteLegStepTransitDetails)
  },
  "travelMode": enum (RouteTravelMode)
}

integer

Odległość pokonywania tego kroku wyrażona w metrach. W pewnych okolicznościach to pole może nie mieć wartości.

string (Duration format)

Czas podróży na tym etapie bez uwzględniania warunków drogowych. W pewnych okolicznościach to pole może nie mieć wartości.

Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „s”. Przykład: "3.5s".

object (Polyline)

Linia łamana powiązana z tym krokiem.

object (Location)

Lokalizacja początkowa tego kroku.

object (Location)

Lokalizacja końcowa tego kroku.

object (NavigationInstruction)

Instrukcje nawigacji.

object (RouteLegStepTravelAdvisory)

Zawiera dodatkowe informacje, o których należy poinformować użytkownika, np. możliwe ograniczenia strefy ruchu na etapie.

object (RouteLegStepLocalizedValues)

Reprezentacje tekstowe właściwości obiektu RouteLegStep.

object (RouteLegStepTransitDetails)

Szczegóły dotyczące tego kroku, jeśli tryb podróży to TRANSIT.

enum (RouteTravelMode)

Środek transportu użyty w tym kroku.

{
  "maneuver": enum (Maneuver),
  "instructions": string
}

enum (Maneuver)

Obejmuje instrukcje nawigacji dotyczące bieżącego kroku (np. skręć w lewo, scal lub prosto). To pole określa, która ikona ma być wyświetlana.

string

Instrukcje, jak przejść ten etap.

{
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}

object (SpeedReadingInterval)

UWAGA: to pole nie jest obecnie wypełnione.

{
  "distance": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}

object (LocalizedText)

Długość podróży przedstawiona w formie tekstowej.

object (LocalizedText)

Czas trwania bez uwzględnienia warunków na drodze, podany w formie tekstowej.

{
  "stopDetails": {
    object (TransitStopDetails)
  },
  "localizedValues": {
    object (TransitDetailsLocalizedValues)
  },
  "headsign": string,
  "headway": string,
  "transitLine": {
    object (TransitLine)
  },
  "stopCount": integer,
  "tripShortText": string
}

object (TransitStopDetails)

Informacje o przystankach na czas przyjazdu i odjazdu na danym etapie.

object (TransitDetailsLocalizedValues)

Reprezentacje tekstowe właściwości obiektu RouteLegStepTransitDetails.

string

Określa kierunek jazdy na tej linii zgodnie z oznaczeniem na pojeździe lub na przystanku odjazdu. Kierunek to często stacja docelowa.

string (Duration format)

Określa oczekiwany czas jako czas między odjazdem z tego samego przystanku o danej porze. Jeśli na przykład ustawisz wartość 600 sekund na trasie przejazdu, w razie spóźnienia na autobus musisz czekać 10 minut.

Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „s”. Przykład: "3.5s".

object (TransitLine)

Informacje o linii transportu publicznego użytej w tym kroku.

integer

Liczba przesiadek od odjazdu do przystanku przyjazdu. Liczba ta obejmuje przystanek przylotów, ale nie uwzględnia przystanku odlotu. Jeśli na przykład trasa rozpoczyna się ze przystanku A, mija przystanki B i C i dociera do przystanku D, stopCount zwróci wartość 3.

string

Tekst widoczny w rozkładach jazdy i na tablicach informacyjnych dla pasażerów, którzy chcą skorzystać z transportu publicznego. Tekst powinien jednoznacznie identyfikować podróż w ramach dnia usługi. Na przykład „538” to tripShortText pociągu Amtrak odjeżdżającego z San Jose, CA o 15:10 w dni powszednie do Sacramento, CA.

{
  "arrivalStop": {
    object (TransitStop)
  },
  "arrivalTime": string,
  "departureStop": {
    object (TransitStop)
  },
  "departureTime": string
}

object (TransitStop)

Informacje o przystanku na danym etapie.

string (Timestamp format)

Szacowany czas dotarcia na miejsce.

Sygnatura czasowa w formacie „Zulu” RFC3339 UTC z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

object (TransitStop)

Informacje o przystanku odjazdu dla tego kroku.

string (Timestamp format)

Szacowany czas odjazdu danego kroku.

Sygnatura czasowa w formacie „Zulu” RFC3339 UTC z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

{
  "name": string,
  "location": {
    object (Location)
  }
}

string

Nazwa przystanku.

object (Location)

Lokalizacja przystanku wyrażona we współrzędnych szerokości i długości geograficznej.

{
  "arrivalTime": {
    object (LocalizedTime)
  },
  "departureTime": {
    object (LocalizedTime)
  }
}

object (LocalizedTime)

Czas w sformatowanej tekstowej reprezentacji czasu z odpowiednią strefą czasową.

object (LocalizedTime)

Czas w sformatowanej tekstowej reprezentacji czasu z odpowiednią strefą czasową.

{
  "time": {
    object (LocalizedText)
  },
  "timeZone": string
}

object (LocalizedText)

Czas podany jako ciąg znaków w danej strefie czasowej.

string

Zawiera strefę czasową. Ta wartość to nazwa strefy czasowej zdefiniowana w bazie danych stref czasowych IANA, np. „America/New_York”.

{
  "agencies": [
    {
      object (TransitAgency)
    }
  ],
  "name": string,
  "uri": string,
  "color": string,
  "iconUri": string,
  "nameShort": string,
  "textColor": string,
  "vehicle": {
    object (TransitVehicle)
  }
}

object (TransitAgency)

Przewoźnik (lub przewoźnika), który obsługuje tę linię transportu publicznego.

string

Pełna nazwa tej linii transportu publicznego, na przykład „ul. Lokalna 8”.

string

identyfikator URI dla tej linii transportu publicznego podany przez przewoźnika.

string

Kolor często używany na szyldach i znakach tej linii. Jest przedstawiona w systemie szesnastkowym.

string

Identyfikator URI ikony powiązanej z tym wierszem.

string

Krótka nazwa tej linii transportu publicznego. Zwykle jest to numer wiersza, np. „M7” lub „355”.

string

Kolor często używany w tekście na szyldach i znakach tej linii. Jest przedstawiona w systemie szesnastkowym.

object (TransitVehicle)

Typ pojazdu poruszającego się na tej linii transportu publicznego.

{
  "name": string,
  "phoneNumber": string,
  "uri": string
}

string

Nazwa tego przewoźnika.

string

Numer telefonu przewoźnika w zależności od regionu.

string

Identyfikator URI przewoźnika.

{
  "name": {
    object (LocalizedText)
  },
  "type": enum (TransitVehicleType),
  "iconUri": string,
  "localIconUri": string
}

object (LocalizedText)

Nazwa pojazdu pisana wielkimi literami.

enum (TransitVehicleType)

Typ używanego pojazdu.

string

Identyfikator URI ikony powiązanej z tym typem pojazdu.

string

Identyfikator URI ikony powiązanej z tym typem pojazdu na podstawie lokalnego znaku transportowego.

{
  "tollInfo": {
    object (TollInfo)
  },
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}

object (TollInfo)

Zawiera informacje o opłatach na poszczególnych obszarach RouteLeg. To pole jest wypełniane tylko wtedy, gdy spodziewamy się opłat za przejazd na: RouteLeg. Jeśli to pole jest ustawione, ale pole podrzędne indexPrice nie jest wypełnione, przewidujemy, że droga zawiera opłaty za przejazd, ale nie znamy szacunkowej ceny. Jeśli to pole nie istnieje, RouteLeg nie ma opłat.

object (SpeedReadingInterval)

Interwały odczytu określające gęstość ruchu. Ma zastosowanie w przypadku ustawień routingu TRAFFIC_AWARE i TRAFFIC_AWARE_OPTIMAL. Przedziały obejmują całą linię łamaną elementu RouteLeg bez nakładania się. Punkt początkowy określonego interwału jest taki sam jak punkt końcowy poprzedniego interwału.

Przykład:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speedReadingIntervals: [A,C), [C,D), [D,G).

{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}

object (LocalizedText)

Długość podróży przedstawiona w formie tekstowej.

object (LocalizedText)

Czas trwania wyrażony w formie tekstowej z uwzględnieniem warunków na drodze. Uwaga: jeśli nie wysyłasz żądań informacji o ruchu, ta wartość będzie taka sama jak wartość staticDuration.

object (LocalizedText)

Czas trwania bez uwzględnienia warunków na drodze, podany w formie tekstowej.

{
  "multiModalSegments": [
    {
      object (MultiModalSegment)
    }
  ]
}

object (MultiModalSegment)

Podsumowanie informacji o różnych multimodalnych segmentach elementu RouteLeg.steps. To pole nie jest wypełniane, jeśli RouteLeg nie zawiera żadnych segmentów multimodalnych w krokach.

{
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelMode": enum (RouteTravelMode),
  "stepStartIndex": integer,
  "stepEndIndex": integer
}

object (NavigationInstruction)

Instrukcja nawigacji dla segmentu multimodalnego.

enum (RouteTravelMode)

Środek transportu segmentu multimodalnego.

integer

Odpowiedni indeks RouteLegStep, który jest początkiem segmentu multimodalnego.

integer

Odpowiedni indeks RouteLegStep, który kończy się segmentem multimodalnym.

{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}

object (LatLng)

To pole jest wymagane. Najniższa pozycja widocznego obszaru.

object (LatLng)

To pole jest wymagane. Najwyższy punkt widocznego obszaru.

{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  },
  "transitFare": {
    object (LocalizedText)
  }
}

object (LocalizedText)

Długość podróży przedstawiona w formie tekstowej.

object (LocalizedText)

Czas trwania wyrażony w formie tekstowej z uwzględnieniem warunków na drodze. Uwaga: jeśli nie prosiłeś o informacje o natężeniu ruchu, ta wartość będzie taka sama jak wartość staticDuration.

object (LocalizedText)

Czas trwania bez uwzględnienia warunków na drodze, podany w formie tekstowej.

object (LocalizedText)

Opłata za transport w formie tekstowej.

{
  "origin": {
    object (GeocodedWaypoint)
  },
  "destination": {
    object (GeocodedWaypoint)
  },
  "intermediates": [
    {
      object (GeocodedWaypoint)
    }
  ]
}

object (GeocodedWaypoint)

Geokodowany punkt na trasie początkowy.

object (GeocodedWaypoint)

Geokodowany punkt na trasie docelowy.

object (GeocodedWaypoint)

Lista pośrednich geokodowanych punktów pośrednich, z których każdy zawiera pole indeksu odpowiadające zerowej pozycji punktu pośredniego w kolejności, w jakiej zostały one określone w żądaniu.

{
  "geocoderStatus": {
    object (Status)
  },
  "type": [
    string
  ],
  "partialMatch": boolean,
  "placeId": string,
  "intermediateWaypointRequestIndex": integer
}

object (Status)

Wskazuje kod stanu wynikający z operacji geokodowania.

string

Typy wyniku w postaci 0 lub większej liczby tagów typu. Obsługiwane typy: typy adresów i typy komponentów adresu.

boolean

Wskazuje, że geokoder nie zwrócił dokładnego dopasowania do pierwotnego żądania, chociaż udało mu się dopasować część żądanego adresu. Warto sprawdzić pierwotne żądanie pod kątem błędów z błędami lub niekompletnego adresu.

string

Identyfikator miejsca powiązany z tym wynikiem.

integer

Indeks odpowiedniego pośredniego punktu pośredniego w żądaniu. Pole wypełnione tylko wtedy, gdy odpowiedni punkt na trasie jest pośrednim punktem na trasie.