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 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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. |"]]