RouteTravelAdvisory
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
حاوی اطلاعات اضافی است که کاربر باید از آنها مطلع شود، مانند محدودیت های احتمالی منطقه ترافیک.
| نمایندگی JSON |
|---|
{
"tollInfo": {
object (TollInfo)
},
"speedReadingIntervals": [
{
object (SpeedReadingInterval)
}
],
"fuelConsumptionMicroliters": string,
"routeRestrictionsPartiallyIgnored": boolean,
"transitFare": {
object (Money)
}
} |
| فیلدها |
|---|
tollInfo | object ( TollInfo ) حاوی اطلاعاتی در مورد عوارض در مسیر است. این فیلد تنها در صورتی پر می شود که در مسیر انتظار عوارضی وجود داشته باشد و TOLLS در ComputeRoutesRequest.extra_computations درخواست گنجانده شود. اگر این فیلد تنظیم شده باشد، اما زیرفیلد estimatedPrice قیمت پر نشده باشد، مسیر شامل عوارض است، اما قیمت تخمینی ناشناخته است. اگر tollInfo تنظیم نشده باشد، هیچ عوارضی در مسیر وجود ندارد. |
speedReadingIntervals[] | object ( SpeedReadingInterval ) فواصل تندخوانی که تراکم ترافیک را نشان می دهد. این فیلد فقط برای درخواست‌ها پر می‌شود که درخواست دارای یک مقدار TRAFFIC_AWARE یا TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference باشد و TRAFFIC_ON_POLYLINE در ComputeRoutesRequest.extra_computations گنجانده شده است. فواصل، کل چند خط مسیر را بدون همپوشانی پوشش می دهند. نقطه شروع یک بازه مشخص با نقطه پایان بازه قبلی یکسان است. مثال: polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speedReadingIntervals: [A,C), [C,D), [D,G).
|
fuelConsumptionMicroliters | string ( int64 format) مصرف سوخت پیش بینی شده بر حسب میکرولیتر این فیلد فقط زمانی پر می شود که FUEL_CONSUMPTION در ComputeRoutesRequest.extra_computations درخواست گنجانده شود. |
routeRestrictionsPartiallyIgnored | boolean مسیر برگشتی ممکن است دارای محدودیت‌هایی باشد که برای حالت سفر یا اصلاح‌کننده‌های مسیر درخواستی مناسب نباشد. |
transitFare | object ( Money ) در صورت وجود، شامل کل کرایه یا هزینه‌های بلیت در این مسیر است. این ویژگی فقط برای درخواست‌های TRANSIT و فقط برای مسیرهایی که اطلاعات کرایه برای تمام مراحل حمل‌ونقل در دسترس است، بازگردانده می‌شود. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\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. |"]]
