Route

Bao hàm một tuyến đường, bao gồm một loạt các đoạn đường được kết nối nối liền với nhau giữa điểm đầu, điểm cuối và điểm trung gian.

Biểu diễn dưới dạng 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
  ]
}
Trường
legs[]

object (RouteLeg)

Một tập hợp các chân (đoạn đường đi giữa các điểm tham chiếu) tạo nên tuyến đường. Mỗi chặng tương ứng với chuyến đi giữa hai Điểm tham chiếu không thuộc via. Ví dụ: một tuyến đường không có điểm tham chiếu trung gian chỉ có một chặng. Tuyến bao gồm một điểm trung gian không phải via có hai chân. Một tuyến đường bao gồm một điểm trung gian via có một chân. Thứ tự của các chân khớp với thứ tự của các Điểm tham chiếu từ origin đến intermediates đến destination.

distanceMeters

integer

Khoảng cách đi lại của tuyến đường, tính bằng mét.

duration

string (Duration format)

Khoảng thời gian cần thiết để điều hướng tuyến đường. Nếu bạn đặt routingPreference thành TRAFFIC_UNAWARE, thì giá trị này sẽ giống với staticDuration. Nếu bạn đặt routingPreference thành TRAFFIC_AWARE hoặc TRAFFIC_AWARE_OPTIMAL, thì giá trị này sẽ được tính toán có tính đến điều kiện giao thông.

Thời lượng tính bằng giây với tối đa 9 chữ số phân số, kết thúc bằng "s". Ví dụ: "3.5s".

staticDuration

string (Duration format)

Thời gian di chuyển trên tuyến đường mà không tính đến tình trạng giao thông.

Thời lượng tính bằng giây với tối đa 9 chữ số phân số, kết thúc bằng "s". Ví dụ: "3.5s".

polyline

object (Polyline)

Hình nhiều đường tổng thể. Hình nhiều đường này sẽ là hình nhiều đường kết hợp của tất cả legs.

description

string

Nội dung mô tả về tuyến đường.

warnings[]

string

Một mảng cảnh báo cần xuất hiện khi hiện tuyến đường.

viewport

object (Viewport)

Hộp giới hạn khung nhìn của hình nhiều đường.

travelAdvisory

object (RouteTravelAdvisory)

Thông tin bổ sung về tuyến đường.

optimizedIntermediateWaypointIndex[]

integer

Nếu ComputeRoutesRequest.optimize_waypoint_order được đặt thành true, thì trường này sẽ chứa thứ tự tối ưu của các điểm tham chiếu của trung gian. nếu không, trường này sẽ trống. Ví dụ: giả sử đầu vào là Origin: LA; Trung cấp: Dallas, Bangor, Phoenix; Điểm đến: New York; và thứ tự điểm tham chiếu trung gian được tối ưu hoá là: Phoenix, Dallas, Bangor. Rồi trường này chứa các giá trị [2, 0, 1]. Chỉ mục bắt đầu bằng 0 cho điểm trung gian đầu tiên.

RouteLeg

Đóng gói một đoạn giữa các điểm tham chiếu không phải via.

Biểu diễn dưới dạng JSON
{
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  }
}
Trường
distanceMeters

integer

Khoảng cách di chuyển của chặng của tuyến đường, tính bằng mét.

duration

string (Duration format)

Khoảng thời gian cần thiết để di chuyển một chặng. Nếu bạn đặt route_preference thành TRAFFIC_UNAWARE thì giá trị này sẽ giống với staticDuration. Nếu route_preferenceTRAFFIC_AWARE hoặc TRAFFIC_AWARE_OPTIMAL, thì giá trị này sẽ được tính toán có tính đến điều kiện giao thông.

Thời lượng tính bằng giây với tối đa 9 chữ số phân số, kết thúc bằng "s". Ví dụ: "3.5s".

staticDuration

string (Duration format)

Thời gian di chuyển qua đoạn đường đó, được tính mà không tính đến tình trạng giao thông.

Thời lượng tính bằng giây với tối đa 9 chữ số phân số, kết thúc bằng "s". Ví dụ: "3.5s".

polyline

object (Polyline)

Hình nhiều đường tổng thể của đoạn đường này. Điều này bao gồm cả hình nhiều đường của mỗi step.

startLocation

object (Location)

Vị trí bắt đầu của chặng này. Mã này có thể khác với origin được cung cấp. Ví dụ: khi origin được cung cấp không nằm gần một con đường, thì đây là một điểm trên đường.

endLocation

object (Location)

Vị trí kết thúc của chặng này. Mã này có thể khác với destination được cung cấp. Ví dụ: khi destination được cung cấp không nằm gần một con đường, thì đây là một điểm trên đường.

steps[]

object (RouteLegStep)

Một dãy các bước biểu thị các đoạn trong chặng này. Mỗi bước đại diện cho một lệnh điều hướng.

travelAdvisory

object (RouteLegTravelAdvisory)

Trình bày thông tin bổ sung mà người dùng cần biết, chẳng hạn như khả năng hạn chế khu vực giao thông, v.v. trên một tuyến đường.

Hình nhiều đường

Đóng gói một hình nhiều đường được mã hoá.

Biểu diễn dưới dạng 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.
}
Trường
Trường kết hợp polyline_type. Đóng gói loại hình nhiều đường. Giá trị mặc định là encrypted_polyline. polyline_type chỉ có thể là một trong những trạng thái sau đây:
encodedPolyline

string

Mã hoá chuỗi của hình nhiều đường bằng thuật toán mã hoá hình nhiều đường

geoJsonLinestring

object (Struct format)

Chỉ định một hình nhiều đường bằng định dạng GeoJSON LineString

RouteLegStep

Đóng gói một phân đoạn của RouteLeg. Mỗi bước tương ứng với một lệnh điều hướng. Chân tuyến đường được tạo thành từ các bước.

Biểu diễn dưới dạng JSON
{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelAdvisory": {
    object (RouteLegStepTravelAdvisory)
  }
}
Trường
distanceMeters

integer

Khoảng cách đi lại của bước này, tính bằng mét. Trong một số trường hợp, trường này có thể không có giá trị.

staticDuration

string (Duration format)

Thời gian di chuyển thông qua bước này mà không tính đến tình trạng giao thông. Trong một số trường hợp, trường này có thể không có giá trị.

Thời lượng tính bằng giây với tối đa 9 chữ số phân số, kết thúc bằng "s". Ví dụ: "3.5s".

polyline

object (Polyline)

Hình nhiều đường liên kết với bước này.

startLocation

object (Location)

Vị trí bắt đầu của bước này.

endLocation

object (Location)

Vị trí kết thúc của bước này.

navigationInstruction

object (NavigationInstruction)

Hướng dẫn đi theo chỉ dẫn.

travelAdvisory

object (RouteLegStepTravelAdvisory)

Trình bày thông tin bổ sung mà người dùng cần biết, chẳng hạn như khả năng hạn chế khu vực giao thông đối với một chặng chân.

RouteLegStepTravelAdvisory

Trình bày thông tin bổ sung mà người dùng cần biết, chẳng hạn như khả năng hạn chế khu vực giao thông đối với một chặng chân.

Biểu diễn dưới dạng JSON
{
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
Trường
speedReadingIntervals[]

object (SpeedReadingInterval)

Khoảng thời gian đọc tốc độ nêu chi tiết mật độ lưu lượng truy cập. Áp dụng trong trường hợp có lựa chọn ưu tiên về định tuyến TRAFFIC_AWARETRAFFIC_AWARE_OPTIMAL. Các khoảng thời gian này bao phủ toàn bộ hình nhiều đường của RouteLegStep mà không chồng chéo. Điểm bắt đầu của khoảng thời gian được chỉ định giống với điểm kết thúc của khoảng trước đó.

Ví dụ:

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

RouteLegTravelAdvisory

Trình bày thông tin bổ sung mà người dùng cần biết, chẳng hạn như khả năng hạn chế khu vực giao thông, v.v. trên một tuyến đường.

Biểu diễn dưới dạng JSON
{
  "tollInfo": {
    object (TollInfo)
  },
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
Trường
tollInfo

object (TollInfo)

Đóng gói thông tin về lệ phí cầu đường trên RouteLeg cụ thể. Trường này chỉ được điền sẵn nếu chúng tôi dự kiến sẽ có thu phí trên RouteLeg. Nếu bạn đặt trường này nhưng trường phụ estimatedPrice không được điền, chúng tôi dự kiến rằng đường đó có thu phí nhưng chúng tôi không biết giá ước tính. Nếu trường này không tồn tại thì sẽ không có phí trên RouteLeg.

speedReadingIntervals[]

object (SpeedReadingInterval)

Khoảng thời gian đọc tốc độ nêu chi tiết mật độ lưu lượng truy cập. Áp dụng trong trường hợp có lựa chọn ưu tiên về định tuyến TRAFFIC_AWARETRAFFIC_AWARE_OPTIMAL. Các khoảng này bao phủ toàn bộ hình nhiều đường của RouteLg mà không chồng chéo nhau. Điểm bắt đầu của khoảng thời gian được chỉ định giống với điểm kết thúc của khoảng trước đó.

Ví dụ:

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