Route

Obejmuje trasę, która składa się z kilku połączonych fragmentów drogi, które łączą punkt początkowy, końcowy i pośredni.

Zapis JSON
{
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "optimizedIntermediateWaypointIndex": [
    integer
  ]
}
Pola
legs[]

object (RouteLeg)

Zbiór nóg (odcinków ścieżki między punktami pośrednimi), z których składa się trasa. Każdy odcinek odpowiada podróży między dwoma punktami pośrednimi niebędącymi via. Na przykład trasa bez pośrednich punktów kontrolnych ma tylko 1 etap. Trasa obejmująca jeden punkt pośredni inny niż via ma dwie nogi. Trasa zawierająca 1 punkt pośredni via ma 1 etap. Kolejność etapów odpowiada kolejności punktów drogi od origin do intermediates do destination.

distanceMeters

integer

Odległość przebyta trasa w metrach.

duration

string (Duration format)

Czas potrzebny na przejechanie trasy. Jeśli ustawisz routingPreference na TRAFFIC_UNAWARE, ta wartość będzie taka sama jak staticDuration. Jeśli ustawisz parametr routingPreference na wartość TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL, ta wartość zostanie obliczona z uwzględnieniem warunków ruchu.

Czas trwania w sekundach składający się z maksymalnie dziewięciu cyfr po przecinku i kończący się „s”. Przykład: "3.5s".

staticDuration

string (Duration format)

Czas przejazdu trasy bez uwzględnienia warunków na drodze.

Czas w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „s”. Przykład: "3.5s".

polyline

object (Polyline)

Linia łamana całej trasy. Ta linia łamana to połączona linia łamana ze wszystkich elementów typu legs.

description

string

Opis trasy.

warnings[]

string

Tablica ostrzeżeń wyświetlanych podczas wyświetlania trasy.

viewport

object (Viewport)

Ramka ograniczająca widoczny obszar linii łamanej.

travelAdvisory

object (RouteTravelAdvisory)

Dodatkowe informacje o trasie.

optimizedIntermediateWaypointIndex[]

integer

Jeśli ComputeRoutesRequest.optimize_waypoint_order ma wartość Prawda, to pole zawiera zoptymalizowaną kolejność punktów pośrednich. W przeciwnym razie to pole jest puste. Załóżmy na przykład, że dane wejściowe to Pochodzenie: LA; dla średnio zaawansowanych: Dallas, Bangor, Phoenix; Miejsce docelowe: Nowy Jork, a zoptymalizowana kolejność pośrednich punktów pośrednich: Phoenix, Dallas, Bangor. To pole zawiera wartości [2, 0, 1]. Indeks zaczyna się od 0 w przypadku pierwszego punktu pośredniego.

RouteLeg

Zawiera segment między punktami pośrednimi innymi niż via.

Zapis JSON
{
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  }
}
Pola
distanceMeters

integer

Odległość do przebycia na etapie trasy w metrach.

duration

string (Duration format)

Czas potrzebny na przebycie odcinka. 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 na drodze.

Czas w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „s”. Przykład: "3.5s".

staticDuration

string (Duration format)

Czas przejazdu na danej trasie, obliczony bez uwzględnienia warunków ruchu.

Czas w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „s”. Przykład: "3.5s".

polyline

object (Polyline)

Całkowity wielokąt dla tego etapu. Obejmuje to również linię łamaną każdej step.

startLocation

object (Location)

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

endLocation

object (Location)

Miejsce docelowe tego etapu. Może się on różnić od podanego destination. Jeśli na przykład podany punkt destination nie znajduje się w pobliżu drogi, jest to punkt na drodze.

steps[]

object (RouteLegStep)

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

travelAdvisory

object (RouteLegTravelAdvisory)

Zawiera dodatkowe informacje, o których użytkownik powinien zostać poinformowany, np. o możliwych ograniczeniach w strefach ruchu.

Linia łamana

Oznacza zakodowaną linię łamaną.

Zapis JSON
{

  // 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.
}
Pola
Pole sumy polyline_type. Zawiera typ linii łamany. Wartość domyślna to encoded_polyline. polyline_type może mieć tylko jedną z tych wartości:
encodedPolyline

string

Kodowanie ciągu znaków linii łamanej za pomocą algorytmu kodowania linii łamanej.

geoJsonLinestring

object (Struct format)

Określa wielokąt w formacie GeoJSON LineString.

RouteLegStep

Zawiera segment RouteLeg. Etap odpowiada pojedynczej instrukcji dotyczącej nawigacji. Odcinki trasy składają się z etapów.

Zapis JSON
{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelAdvisory": {
    object (RouteLegStepTravelAdvisory)
  }
}
Pola
distanceMeters

integer

Długość tego kroku w metrach. W niektórych przypadkach to pole może nie mieć wartości.

staticDuration

string (Duration format)

Czas przejazdu na tym etapie bez uwzględniania warunków na drodze. W niektórych okolicznościach to pole może nie zawierać wartości.

Czas trwania w sekundach składający się z maksymalnie dziewięciu cyfr po przecinku i kończący się „s”. Przykład: "3.5s".

polyline

object (Polyline)

Polilinia powiązana z tym krokiem.

startLocation

object (Location)

Lokalizacja początkowa tego kroku.

endLocation

object (Location)

Lokalizacja końcowa tego kroku.

navigationInstruction

object (NavigationInstruction)

Instrukcje nawigacji.

travelAdvisory

object (RouteLegStepTravelAdvisory)

Zawiera dodatkowe informacje, o których użytkownik powinien zostać poinformowany, takie jak możliwe ograniczenie strefy ruchu na etapie etapu.

RouteLegStepTravelAdvisory

Zawiera dodatkowe informacje, o których użytkownik powinien zostać poinformowany, takie jak możliwe ograniczenie strefy ruchu na etapie etapu.

Zapis JSON
{
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
Pola
speedReadingIntervals[]

object (SpeedReadingInterval)

UWAGA: to pole nie jest obecnie wypełnione.

RouteLegTravelAdvisory

Zawiera dodatkowe informacje, o których użytkownik powinien zostać poinformowany, np. o możliwych ograniczeniach w strefach ruchu.

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

object (TollInfo)

Zawiera informacje o opłatach za przejazd na określonym RouteLeg. To pole jest wypełniane tylko wtedy, gdy spodziewamy się opłat za przejazd RouteLeg. Jeśli to pole jest ustawione, ale podpole estimatedPrice jest puste, zakładamy, że droga zawiera opłaty drogowe, ale nie znamy ich przybliżonej ceny. Jeśli to pole nie istnieje, RouteLeg nie pobiera opłat.

speedReadingIntervals[]

object (SpeedReadingInterval)

Interwały szybkości czytania określające gęstość ruchu. Ma zastosowanie w przypadku preferencji routingu TRAFFIC_AWARE i TRAFFIC_AWARE_OPTIMAL. Interwały obejmują cały poligon RouteLeg bez nakładania się. Punkt początkowy określonego przedziału czasowego jest taki sam jak punkt końcowy poprzedniego przedziału czasowego.

Przykład:

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