RouteTravelAdvisory
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Chứa thông tin bổ sung mà người dùng cần được thông báo, chẳng hạn như các quy định hạn chế có thể có về khu vực giao thông.
| Biểu diễn dưới dạng JSON |
{
"tollInfo": {
object (TollInfo)
},
"speedReadingIntervals": [
{
object (SpeedReadingInterval)
}
],
"fuelConsumptionMicroliters": string,
"routeRestrictionsPartiallyIgnored": boolean,
"transitFare": {
object (Money)
}
} |
| Trường |
tollInfo |
object (TollInfo)
Chứa thông tin về phí cầu đường trên tuyến đường. Trường này chỉ được điền sẵn nếu tuyến đường dự kiến có trạm thu phí và TOLLS được đưa vào ComputeRoutesRequest.extra_computations của yêu cầu. Nếu bạn đặt trường này nhưng không điền sẵn trường con estimatedPrice, thì tuyến đường sẽ có trạm thu phí nhưng giá ước tính là không xác định. Nếu bạn không đặt tollInfo, thì tuyến đường sẽ không có trạm thu phí.
|
speedReadingIntervals[] |
object (SpeedReadingInterval)
Khoảng thời gian đọc tốc độ cho biết mật độ giao thông. Trường này chỉ được điền sẵn cho các yêu cầu khi yêu cầu có giá trị TRAFFIC_AWARE hoặc TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference và TRAFFIC_ON_POLYLINE được đưa vào ComputeRoutesRequest.extra_computations. Các khoảng thời gian này bao gồm toàn bộ đường nhiều đường của tuyến đường mà không bị trùng lặp. Điểm bắt đầu của một khoảng thời gian cụ thể 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).
|
fuelConsumptionMicroliters |
string (int64 format)
Lượng nhiên liệu tiêu thụ dự kiến (tính bằng microlit). Trường này chỉ được điền khi FUEL_CONSUMPTION có trong ComputeRoutesRequest.extra_computations của yêu cầu.
|
routeRestrictionsPartiallyIgnored |
boolean
Tuyến đường được trả về có thể có những hạn chế không phù hợp với chế độ di chuyển hoặc các đối tượng sửa đổi tuyến đường được yêu cầu.
|
transitFare |
object (Money)
Nếu có, thuộc tính này sẽ chứa tổng giá vé hoặc chi phí vé trên tuyến đường này. Thuộc tính này chỉ được trả về cho các yêu cầu TRANSIT và chỉ dành cho những tuyến đường có thông tin về giá vé cho tất cả các bước đi phương tiện công cộng.
|
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-31 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-31 UTC."],[[["\u003cp\u003eJSON representation provides supplementary route details like tolls, traffic, and fuel consumption.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003etollInfo\u003c/code\u003e field indicates presence of tolls and potential costs if available.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003espeedReadingIntervals\u003c/code\u003e details traffic density along the route using intervals.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003efuelConsumptionMicroliters\u003c/code\u003e provides an estimate of fuel usage for the route.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003erouteRestrictionsPartiallyIgnored\u003c/code\u003e signals potential unsuitability of the route for the travel mode.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003etransitFare\u003c/code\u003e shows the total cost for transit routes if applicable and available.\u003c/p\u003e\n"]]],["The core content details route information via a JSON structure. Key data includes `tollInfo` (toll details), `speedReadingIntervals` (traffic density), `fuelConsumptionMicroliters` (predicted fuel use), `routeRestrictionsPartiallyIgnored` (potential route restrictions), and `transitFare` (total transit costs). The data provides details about tolls, traffic, fuel consumption, restrictions and fares, depending on the request and the characteristics of the route.\n"],null,["# RouteTravelAdvisory\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n\nContains the additional information that the user should be informed about, such as possible traffic zone restrictions.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"tollInfo\": { object (/maps/documentation/routes/reference/rest/v2/TollInfo) }, \"speedReadingIntervals\": [ { object (/maps/documentation/routes/reference/rest/v2/SpeedReadingInterval) } ], \"fuelConsumptionMicroliters\": string, \"routeRestrictionsPartiallyIgnored\": boolean, \"transitFare\": { object (/maps/documentation/routes/reference/rest/v2/Money) } } ``` |\n\n| Fields ||\n|-------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `tollInfo` | `object (`[TollInfo](/maps/documentation/routes/reference/rest/v2/TollInfo)`)` Contains information about tolls on the route. This field is only populated if tolls are expected on the route and `TOLLS` is included in the request's [ComputeRoutesRequest.extra_computations](/maps/documentation/routes/reference/rest/v2/TopLevel/computeRoutes#body.request_body.FIELDS.extra_computations). If this field is set, but the `estimatedPrice` subfield is not populated, then the route contains tolls, but the estimated price is unknown. If `tollInfo` is not set, then there are no tolls expected on the route. |\n| `speedReadingIntervals[]` | `object (`[SpeedReadingInterval](/maps/documentation/routes/reference/rest/v2/SpeedReadingInterval)`)` Speed reading intervals indicating traffic density. This field is only populated for requests when the request has a `TRAFFIC_AWARE` or `TRAFFIC_AWARE_OPTIMAL` [ComputeRoutesRequest.routing_preference](/maps/documentation/routes/reference/rest/v2/TopLevel/computeRoutes#body.request_body.FIELDS.routing_preference) value, and `TRAFFIC_ON_POLYLINE` is included in the [ComputeRoutesRequest.extra_computations](/maps/documentation/routes/reference/rest/v2/TopLevel/computeRoutes#body.request_body.FIELDS.extra_computations). The intervals cover the entire polyline of the route without overlap. The start point of a specified interval is the same as the end point of the preceding interval. Example: polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speedReadingIntervals: [A,C), [C,D), [D,G). |\n| `fuelConsumptionMicroliters` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The predicted fuel consumption in microliters. This field is only populated when `FUEL_CONSUMPTION` is included in the request's [ComputeRoutesRequest.extra_computations](/maps/documentation/routes/reference/rest/v2/TopLevel/computeRoutes#body.request_body.FIELDS.extra_computations). |\n| `routeRestrictionsPartiallyIgnored` | `boolean` Returned route may have restrictions that are not suitable for requested travel mode or route modifiers. |\n| `transitFare` | `object (`[Money](/maps/documentation/routes/reference/rest/v2/Money)`)` If present, contains the total fare or ticket costs on this route This property is only returned for `TRANSIT` requests and only for routes where fare information is available for all transit steps. |"]]
