Route

Bao bọc một tuyến đường, bao gồm một loạt các đoạn đường được kết nối với nhau để kết hợp với các điểm đầu, cuối và 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
  ]
}
Các trường
legs[]

object (RouteLeg)

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

distanceMeters

integer

Khoảng cách đi được 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 thiết lập 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 dựa trên điều kiện lưu lượng truy cập.

Thời lượng tính bằng giây có 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 đi qua 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 có 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 tuyến đường. Hình nhiều đường này sẽ là hình nhiều đường tổng 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 sẽ xuất hiện khi hiển thị 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, trường này sẽ chứa thứ tự được tối ưu hoá của điểm tham chiếu trung gian. Nếu không, trường này sẽ trống. Ví dụ: giả sử dữ liệu đầu vào là Xuất xứ: 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. Khi đó 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 tham chiếu trung gian đầu tiên.

RouteLeg

Đóng gói một phân đ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)
  }
}
Các trường
distanceMeters

integer

Quãng đường đi được của chân 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 chân. 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 được tính toán có tính đến điều kiện lưu lượng truy cập.

Thời lượng tính bằng giây có 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 chặng, được tính toán mà không tính đến tình trạng giao thông.

Thời lượng tính bằng giây có 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ể cho chân này. Quy định này cũng áp dụng cho hình nhiều đường của mỗi step.

startLocation

object (Location)

Vị trí bắt đầu của chân 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ân 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 cho biết các đoạn trong chân này. Mỗi bước đại diện cho một hướng dẫn điều hướng.

travelAdvisory

object (RouteLegTravelAdvisory)

Bao gồm thông tin bổ sung mà người dùng cần được thông báo, chẳng hạn như việc hạn chế khu vực giao thông có thể xảy ra, v.v. trên đoạn tuyến đường.

Hình nhiều đường

Đóng gói một hình nhiều đường đã 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.
}
Các trường
Trường nhóm polyline_type. Đóng gói loại hình nhiều đường. Giá trị mặc định là được mã hoá_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 hướng dẫn di chuyển. Chân của 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)
  }
}
Các trường
distanceMeters

integer

Quãng đường đi được 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 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 có 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 di chuyển.

travelAdvisory

object (RouteLegStepTravelAdvisory)

Đưa ra thông tin bổ sung mà người dùng cần được thông báo, chẳng hạn như việc hạn chế khu vực giao thông có thể xảy ra ở bước chân.

RouteLegStepTravelAdvisory

Đưa ra thông tin bổ sung mà người dùng cần được thông báo, chẳng hạn như việc hạn chế khu vực giao thông có thể xảy ra ở bước chân.

Biểu diễn dưới dạng JSON
{
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
Các 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. Có thể áp dụng trong trường hợp có các lựa chọn ưu tiên định tuyến đến TRAFFIC_AWARETRAFFIC_AWARE_OPTIMAL. Các khoảng thời gian 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 thời gian trước đó.

Ví dụ:

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

RouteLegTravelAdvisory

Bao gồm thông tin bổ sung mà người dùng cần được thông báo, chẳng hạn như việc hạn chế khu vực giao thông có thể xảy ra, v.v. trên đoạn tuyến đường.

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

object (TollInfo)

Cung cấp thông tin chi tiết về lệ phí cầu đường trên Tuyến đường cụ thể. Trường này chỉ được điền nếu chúng ta cho rằng có thu phí trên Tuyến đường. Nếu trường này được đặt nhưng trường phụ $Price (Giá ước tính) không được điền, chúng tôi dự kiến rằng đường có thu phí cầu đường 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ó thu phí trên Tuyến{0/}.

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. Có thể áp dụng trong trường hợp có các lựa chọn ưu tiên định tuyến đến TRAFFIC_AWARETRAFFIC_AWARE_OPTIMAL. Các khoảng thời gian bao phủ toàn bộ hình nhiều đường của Tuyến đường Lg 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 thời gian trước đó.

Ví dụ:

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