تتوفر واجهة برمجة تطبيقات المسارات المفضلة حاليًا لعملاء محددين فقط. يمكنك التواصل مع فريق المبيعات لمعرفة المزيد من المعلومات.

تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

Package google.maps.routes.v1

الفهرس

RoutesPreferred (واجهة)
ComputeCustomRoutesRequest (رسالة)
ComputeCustomRoutesResponse (رسالة)
ComputeCustomRoutesResponse.FallbackInfo (رسالة)
ComputeCustomRoutesResponse.FallbackInfo.FallbackRouteObjective (تعداد)
ComputeRouteMatrixRequest (رسالة)
ComputeRoutesRequest (رسالة)
ComputeRoutesResponse (رسالة)
CustomRoute (رسالة)
FallbackInfo (رسالة)
FallbackReason (تعداد)
FallbackRoutingMode (تعداد)
Location (رسالة)
Maneuver (تعداد)
NavigationInstruction (رسالة)
Polyline (رسالة)
PolylineEncoding (تعداد)
PolylineQuality (تعداد)
Route (رسالة)
RouteLeg (رسالة)
RouteLegStep (رسالة)
RouteLegStepTravelAdvisory (رسالة)
RouteLegTravelAdvisory (رسالة)
RouteMatrixDestination (رسالة)
RouteMatrixElement (رسالة)
RouteMatrixElementCondition (تعداد)
RouteMatrixOrigin (رسالة)
RouteModifiers (رسالة)
RouteObjective (رسالة)
RouteObjective.RateCard (رسالة)
RouteObjective.RateCard.MonetaryCost (رسالة)
RouteTravelAdvisory (رسالة)
RouteTravelMode (تعداد)
RoutingPreference (تعداد)
SpeedReadingInterval (رسالة)
SpeedReadingInterval.Speed (تعداد)
TollInfo (رسالة)
TollPass (تعداد)
Units (تعداد)
VehicleEmissionType (تعداد)
VehicleInfo (رسالة)
Waypoint (رسالة)

RoutesPreferred

واجهة Routes Preferred API

ComputeCustomRoutes

ComputeCustomRoutes
`rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)` بالنظر إلى مجموعة من نقاط الطريق النهائية والمتوسطة وهدف المسار، يتم احتساب أفضل مسار لتحقيق هدف المسار. تعرض هذه الطريقة أيضًا أسرع مسار وأقصر مسار كمسارات مرجعية. ملاحظة: تتطلّب هذه الطريقة تحديد قناع حقل الردّ في الإدخال. يمكنك تقديم قناع حقل الاستجابة باستخدام مَعلمة عنوان URL `$fields` أو `fields`، أو باستخدام عنوان HTTP/gRPC `X-Goog-FieldMask` (راجِع مَعلمات وعناوين URL المتاحة). القيمة هي قائمة مسارات حقول مفصولة بفواصل. اطّلِع على هذه المستندات التفصيلية حول كيفية إنشاء مسارات الحقول. على سبيل المثال، في هذه الطريقة: قناع الحقل لجميع الحقول المتاحة (للفحص اليدوي): `X-Goog-FieldMask: ` قناع الحقل الخاص بمسافات المسار ومدته والرمز المميز ومعلومات الرسوم: `X-Goog-FieldMask: routes.route.distanceMeters,routes.route.duration,routes.token,routes.route.travelAdvisory.tollInfo` لا تنصح Google باستخدام قناع حقل الردّ الذي يتضمّن حرف البدل (``)، أو تحديد قناع الحقل على المستوى الأعلى (`routes`)، وذلك للأسباب التالية: يساعد اختيار الحقول التي تحتاج إليها فقط خادمَنا في توفير دورات الحوسبة، ما يسمح لنا بعرض النتيجة لك بزمن استجابة أقل. يضمن اختيار الحقول التي تحتاج إليها فقط في مهمة الإنتاج تحقيق أداء مستقر من حيث وقت الاستجابة. قد نضيف المزيد من حقول الردود في المستقبل، وقد تتطلّب هذه الحقول الجديدة وقتًا إضافيًا للمعالجة. إذا اخترت جميع الحقول، أو إذا اخترت جميع الحقول على المستوى الأعلى، قد ينخفض الأداء لأنّ أي حقل جديد نضيفه سيتم تضمينه تلقائيًا في الردّ. يؤدي اختيار الحقول التي تحتاج إليها فقط إلى تقليل حجم الردّ، وبالتالي زيادة سرعة معالجة البيانات على الشبكة. نطاقات الأذونات يجب توفير نطاق OAuth التالي: `https://www.googleapis.com/auth/maps-platform.routespreferred` لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على بروتوكول OAuth 2.0.

rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)

بالنظر إلى مجموعة من نقاط الطريق النهائية والمتوسطة وهدف المسار، يتم احتساب أفضل مسار لتحقيق هدف المسار. تعرض هذه الطريقة أيضًا أسرع مسار وأقصر مسار كمسارات مرجعية.

ملاحظة: تتطلّب هذه الطريقة تحديد قناع حقل الردّ في الإدخال. يمكنك تقديم قناع حقل الاستجابة باستخدام مَعلمة عنوان URL $fields أو fields، أو باستخدام عنوان HTTP/gRPC X-Goog-FieldMask (راجِع مَعلمات وعناوين URL المتاحة). القيمة هي قائمة مسارات حقول مفصولة بفواصل. اطّلِع على هذه المستندات التفصيلية حول كيفية إنشاء مسارات الحقول.

على سبيل المثال، في هذه الطريقة:

قناع الحقل لجميع الحقول المتاحة (للفحص اليدوي): X-Goog-FieldMask: *
قناع الحقل الخاص بمسافات المسار ومدته والرمز المميز ومعلومات الرسوم: X-Goog-FieldMask: routes.route.distanceMeters,routes.route.duration,routes.token,routes.route.travelAdvisory.tollInfo

لا تنصح Google باستخدام قناع حقل الردّ الذي يتضمّن حرف البدل (*)، أو تحديد قناع الحقل على المستوى الأعلى (routes)، وذلك للأسباب التالية:

يساعد اختيار الحقول التي تحتاج إليها فقط خادمَنا في توفير دورات الحوسبة، ما يسمح لنا بعرض النتيجة لك بزمن استجابة أقل.
يضمن اختيار الحقول التي تحتاج إليها فقط في مهمة الإنتاج تحقيق أداء مستقر من حيث وقت الاستجابة. قد نضيف المزيد من حقول الردود في المستقبل، وقد تتطلّب هذه الحقول الجديدة وقتًا إضافيًا للمعالجة. إذا اخترت جميع الحقول، أو إذا اخترت جميع الحقول على المستوى الأعلى، قد ينخفض الأداء لأنّ أي حقل جديد نضيفه سيتم تضمينه تلقائيًا في الردّ.
يؤدي اختيار الحقول التي تحتاج إليها فقط إلى تقليل حجم الردّ، وبالتالي زيادة سرعة معالجة البيانات على الشبكة.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

https://www.googleapis.com/auth/maps-platform.routespreferred

لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على بروتوكول OAuth 2.0.

ComputeRouteMatrix

ComputeRouteMatrix
`rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)` تتلقّى هذه السمة قائمة بالمصادر والوجهات وتعرض بثًا يحتوي على معلومات المسار لكل مجموعة من المصدر والوجهة. ملاحظة: تتطلّب هذه الطريقة تحديد قناع حقل الردّ في الإدخال. يمكنك تقديم قناع حقل الاستجابة باستخدام مَعلمة عنوان URL `$fields` أو `fields`، أو باستخدام عنوان HTTP/gRPC `X-Goog-FieldMask` (راجِع مَعلمات وعناوين URL المتاحة). القيمة هي قائمة مسارات حقول مفصولة بفواصل. اطّلِع على هذه المستندات التفصيلية حول كيفية إنشاء مسارات الحقول. على سبيل المثال، في هذه الطريقة: قناع الحقل لجميع الحقول المتاحة (للفحص اليدوي): `X-Goog-FieldMask: ` قناع الحقل الخاص بمدد المسارات ومسافاتها وحالة العناصر وحالتها وفهارسها (مثال على إعداد الإصدار العلني): `X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration` من الضروري تضمين `status` في قناع الحقل، وإلا ستظهر جميع الرسائل على أنّها صحيحة. لا تشجّع Google على استخدام قناع حقل الردّ الخاص بأحرف البدل (``) للأسباب التالية: يساعد اختيار الحقول التي تحتاج إليها فقط خادمَنا في توفير دورات الحوسبة، ما يسمح لنا بعرض النتيجة لك بزمن استجابة أقل. يضمن اختيار الحقول التي تحتاج إليها فقط في مهمة الإنتاج تحقيق أداء مستقر من حيث وقت الاستجابة. قد نضيف المزيد من حقول الردود في المستقبل، وقد تتطلّب هذه الحقول الجديدة وقتًا إضافيًا للمعالجة. إذا اخترت جميع الحقول، أو إذا اخترت جميع الحقول على المستوى الأعلى، قد ينخفض الأداء لأنّ أي حقل جديد نضيفه سيتم تضمينه تلقائيًا في الردّ. يؤدي اختيار الحقول التي تحتاج إليها فقط إلى تقليل حجم الردّ، وبالتالي زيادة سرعة معالجة البيانات على الشبكة. نطاقات الأذونات يجب توفير نطاق OAuth التالي: `https://www.googleapis.com/auth/maps-platform.routespreferred` لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على بروتوكول OAuth 2.0.

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

تتلقّى هذه السمة قائمة بالمصادر والوجهات وتعرض بثًا يحتوي على معلومات المسار لكل مجموعة من المصدر والوجهة.

على سبيل المثال، في هذه الطريقة:

قناع الحقل لجميع الحقول المتاحة (للفحص اليدوي): X-Goog-FieldMask: *
قناع الحقل الخاص بمدد المسارات ومسافاتها وحالة العناصر وحالتها وفهارسها (مثال على إعداد الإصدار العلني): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

من الضروري تضمين status في قناع الحقل، وإلا ستظهر جميع الرسائل على أنّها صحيحة. لا تشجّع Google على استخدام قناع حقل الردّ الخاص بأحرف البدل (*) للأسباب التالية:

يساعد اختيار الحقول التي تحتاج إليها فقط خادمَنا في توفير دورات الحوسبة، ما يسمح لنا بعرض النتيجة لك بزمن استجابة أقل.
يضمن اختيار الحقول التي تحتاج إليها فقط في مهمة الإنتاج تحقيق أداء مستقر من حيث وقت الاستجابة. قد نضيف المزيد من حقول الردود في المستقبل، وقد تتطلّب هذه الحقول الجديدة وقتًا إضافيًا للمعالجة. إذا اخترت جميع الحقول، أو إذا اخترت جميع الحقول على المستوى الأعلى، قد ينخفض الأداء لأنّ أي حقل جديد نضيفه سيتم تضمينه تلقائيًا في الردّ.
يؤدي اختيار الحقول التي تحتاج إليها فقط إلى تقليل حجم الردّ، وبالتالي زيادة سرعة معالجة البيانات على الشبكة.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

https://www.googleapis.com/auth/maps-platform.routespreferred

لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على بروتوكول OAuth 2.0.

ComputeRoutes

ComputeRoutes
`rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)` تعرض هذه الطريقة المسار الأساسي مع مسارات بديلة اختيارية، وذلك عند توفّر مجموعة من نقاط الطريق النهائية والمتوسطة. ملاحظة: تتطلّب هذه الطريقة تحديد قناع حقل الردّ في الإدخال. يمكنك تقديم قناع حقل الاستجابة باستخدام مَعلمة عنوان URL `$fields` أو `fields`، أو باستخدام عنوان HTTP/gRPC `X-Goog-FieldMask` (راجِع مَعلمات وعناوين URL المتاحة). القيمة هي قائمة مسارات حقول مفصولة بفواصل. يمكنك الاطّلاع على مستندات مفصّلة حول كيفية إنشاء مسارات الحقول. على سبيل المثال، في هذه الطريقة: قناع الحقل لجميع الحقول المتاحة (للفحص اليدوي): `X-Goog-FieldMask: ` قناع الحقل الخاص بالمدة والمسافة والمضلّع على مستوى المسار (مثال على إعداد الإنتاج): `X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline` لا تنصح Google باستخدام قناع حقل الردّ الذي يتضمّن حرف البدل (``) أو تحديد قناع الحقل على المستوى الأعلى (`routes`)، وذلك للأسباب التالية: يساعد اختيار الحقول التي تحتاج إليها فقط خادمَنا في توفير دورات الحوسبة، ما يسمح لنا بعرض النتيجة لك بزمن استجابة أقل. يضمن اختيار الحقول التي تحتاج إليها فقط في مهمة الإنتاج تحقيق أداء مستقر من حيث وقت الاستجابة. قد نضيف المزيد من حقول الردود في المستقبل، وقد تتطلّب هذه الحقول الجديدة وقتًا إضافيًا للمعالجة. إذا اخترت جميع الحقول، أو إذا اخترت جميع الحقول على المستوى الأعلى، قد ينخفض الأداء لأنّ أي حقل جديد نضيفه سيتم تضمينه تلقائيًا في الردّ. يؤدي اختيار الحقول التي تحتاج إليها فقط إلى تقليل حجم الردّ، وبالتالي زيادة سرعة معالجة البيانات على الشبكة. نطاقات الأذونات يجب توفير نطاق OAuth التالي: `https://www.googleapis.com/auth/maps-platform.routespreferred` لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على بروتوكول OAuth 2.0.

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

تعرض هذه الطريقة المسار الأساسي مع مسارات بديلة اختيارية، وذلك عند توفّر مجموعة من نقاط الطريق النهائية والمتوسطة.

ملاحظة: تتطلّب هذه الطريقة تحديد قناع حقل الردّ في الإدخال. يمكنك تقديم قناع حقل الاستجابة باستخدام مَعلمة عنوان URL $fields أو fields، أو باستخدام عنوان HTTP/gRPC X-Goog-FieldMask (راجِع مَعلمات وعناوين URL المتاحة). القيمة هي قائمة مسارات حقول مفصولة بفواصل. يمكنك الاطّلاع على مستندات مفصّلة حول كيفية إنشاء مسارات الحقول.

على سبيل المثال، في هذه الطريقة:

قناع الحقل لجميع الحقول المتاحة (للفحص اليدوي): X-Goog-FieldMask: *
قناع الحقل الخاص بالمدة والمسافة والمضلّع على مستوى المسار (مثال على إعداد الإنتاج): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

لا تنصح Google باستخدام قناع حقل الردّ الذي يتضمّن حرف البدل (*) أو تحديد قناع الحقل على المستوى الأعلى (routes)، وذلك للأسباب التالية:

يساعد اختيار الحقول التي تحتاج إليها فقط خادمَنا في توفير دورات الحوسبة، ما يسمح لنا بعرض النتيجة لك بزمن استجابة أقل.
يضمن اختيار الحقول التي تحتاج إليها فقط في مهمة الإنتاج تحقيق أداء مستقر من حيث وقت الاستجابة. قد نضيف المزيد من حقول الردود في المستقبل، وقد تتطلّب هذه الحقول الجديدة وقتًا إضافيًا للمعالجة. إذا اخترت جميع الحقول، أو إذا اخترت جميع الحقول على المستوى الأعلى، قد ينخفض الأداء لأنّ أي حقل جديد نضيفه سيتم تضمينه تلقائيًا في الردّ.
يؤدي اختيار الحقول التي تحتاج إليها فقط إلى تقليل حجم الردّ، وبالتالي زيادة سرعة معالجة البيانات على الشبكة.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

https://www.googleapis.com/auth/maps-platform.routespreferred

لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على بروتوكول OAuth 2.0.

ComputeCustomRoutesRequest

رسالة طلب ComputeCustomRoutes

الحقول
`origin`	`Waypoint` الحقل مطلوب. نقطة الانطلاق على المسار
`destination`	`Waypoint` الحقل مطلوب. نقطة على المسار للوجهة
`intermediates[]`	`Waypoint` اختيارية: مجموعة من نقاط المرور على طول الطريق (باستثناء نقاط النهاية)، إما للتوقف عندها أو المرور بها يمكن إضافة ما يصل إلى 25 نقطة توقّف وسيطة.
`travel_mode`	`RouteTravelMode` اختيارية: تحدّد هذه السمة وسيلة النقل. يُسمح باستخدام القيمتَين `DRIVE` وTWO_WHEELER فقط.
`routing_preference`	`RoutingPreference` اختيارية: تحدّد هذه السمة كيفية احتساب المسار. يحاول الخادم استخدام خيار التوجيه المفضّل المحدّد لاحتساب المسار. إذا أدّى خيار التوجيه المفضّل إلى حدوث خطأ أو تأخير طويل جدًا، سيتم عرض رسالة خطأ. يمكنك تحديد هذا الخيار فقط عندما تكون قيمة `travel_mode` هي `DRIVE` أو `TWO_WHEELER`، وإلا سيفشل الطلب.
`polyline_quality`	`PolylineQuality` اختيارية: تحدّد هذه السمة إعداداتك المفضّلة لجودة الخط المتعدد الأضلاع.
`polyline_encoding`	`PolylineEncoding` اختيارية: تحدّد هذه السمة الترميز المفضّل للخط المتعدد الأضلاع.
`departure_time`	`Timestamp` اختيارية: وقت المغادرة في حال عدم ضبط هذه القيمة، يتم ضبطها تلقائيًا على الوقت الذي أرسلت فيه الطلب. إذا ضبطت هذه القيمة على وقت حدث في الماضي، سيتعذّر تنفيذ الطلب.
`route_modifiers`	`RouteModifiers` اختيارية: مجموعة من الشروط التي يجب استيفاؤها وتؤثر في طريقة احتساب المسارات
`route_objective`	`RouteObjective` الحقل مطلوب. هدف المسار الذي تريد تحسينه.
`language_code`	`string` اختيارية: رمز اللغة المستخدَمة وفق المعيار BCP-47، مثل "en-US" أو "sr-Latn" لمزيد من المعلومات، يُرجى الاطّلاع على معرّف اللغة Unicode. اطّلِع على اللغات المتاحة للحصول على قائمة باللغات المتاحة. عندما لا تقدّم هذه القيمة، يتم استنتاج لغة العرض من الموقع الجغرافي لطلب المسار.
`units`	`Units` اختيارية: تحدّد هذه السمة وحدات القياس لحقول العرض. ويشمل ذلك الحقل `instruction` في `NavigationInstruction`. لا تتأثر وحدات القياس المستخدَمة للمسار والجزء والخطوة والمسافة والمدة بهذه القيمة. في حال عدم تقديم هذه القيمة، يتم استنتاج وحدات العرض من الموقع الجغرافي للطلب.

ComputeCustomRoutesResponse

رسالة الرد ComputeCustomRoutes

الحقول
`routes[]`	`CustomRoute` المسارات "الأفضل" لهدف المسار المُدخَل
`fastest_route`	`CustomRoute` أسرع مسار مرجعي
`shortest_route`	`CustomRoute` أقصر مسار مرجعي
`fallback_info`	`FallbackInfo` معلومات احتياطية للمسارات المخصّصة

FallbackInfo

تتضمّن هذه السمة معلومات احتياطية عن ComputeCustomRoutes. تنفّذ ComputeCustomRoutes نوعَين من عمليات الرجوع إلى القيم الاحتياطية:

إذا تعذّر احتساب المسار باستخدام routing_preference الذي طلبه العميل، سيتم الرجوع إلى وضع توجيه آخر. في هذه الحالة، يتم استخدام fallback_routing_mode وrouting_mode_fallback_reason لتحديد وضع التوجيه الاحتياطي المستخدَم، بالإضافة إلى سبب التوجيه الاحتياطي.
إذا تعذّر على النظام احتساب "أفضل" مسار لهدف المسار الذي حدّده العميل، قد يعود إلى هدف آخر. يتم استخدام fallback_route_objective لتوضيح هدف المسار الاحتياطي.

الحقول

الحقول
`routing_mode`	`FallbackRoutingMode` وضع التوجيه المستخدَم للردّ. في حال تم تفعيل وضع احتياطي، قد يختلف الوضع عن إعدادات التوجيه المفضّلة في طلب العميل الأصلي.
`routing_mode_reason`	`FallbackReason` سبب استخدام الردّ الاحتياطي بدلاً من الردّ الأصلي لا تتم تعبئة هذا الحقل إلا عند تفعيل وضع الموافقة الاحتياطية وعرض الرد الاحتياطي.
`route_objective`	`FallbackRouteObjective` الهدف من المسار المستخدَم في الردّ. في حال تم تفعيل الخيار الاحتياطي، قد يختلف الهدف عن هدف المسار المقدَّم في طلب العميل الأصلي.

routing_mode

FallbackRoutingMode

وضع التوجيه المستخدَم للردّ. في حال تم تفعيل وضع احتياطي، قد يختلف الوضع عن إعدادات التوجيه المفضّلة في طلب العميل الأصلي.

routing_mode_reason

FallbackReason

سبب استخدام الردّ الاحتياطي بدلاً من الردّ الأصلي لا تتم تعبئة هذا الحقل إلا عند تفعيل وضع الموافقة الاحتياطية وعرض الرد الاحتياطي.

route_objective

FallbackRouteObjective

الهدف من المسار المستخدَم في الردّ. في حال تم تفعيل الخيار الاحتياطي، قد يختلف الهدف عن هدف المسار المقدَّم في طلب العميل الأصلي.

FallbackRouteObjective

RouteObjective المستخدَم للردّ.

عمليات التعداد
`FALLBACK_ROUTE_OBJECTIVE_UNSPECIFIED`	لم يتم تحديد هدف المسار الاحتياطي.
`FALLBACK_RATECARD_WITHOUT_TOLL_PRICE_DATA`	إذا طلب العميل `RateCard` وضبط include_tolls على "صحيح"، ولم تتوفّر لدى Google بيانات أسعار رسوم المرور للطريق، ستعود واجهة برمجة التطبيقات إلى `RateCard` بدون أخذ أسعار رسوم المرور في الاعتبار.

ComputeRouteMatrixRequest

رسالة طلب ComputeRouteMatrix

الحقول
`origins[]`	`RouteMatrixOrigin` الحقل مطلوب. مصفوفة المصادر التي تحدّد صفوف مصفوفة الردّ. تنطبق العديد من القيود على حجم عدد القيم الفريدة للمصادر والوجهات: يجب ألا يزيد عدد العناصر (نقاط الانطلاق × نقاط الوصول) عن 625 في أي حال. يجب ألا يزيد عدد العناصر (المصادر × الوجهات) عن 100 إذا تم ضبط routing_preference على `TRAFFIC_AWARE_OPTIMAL`. يجب ألا يزيد عدد نقاط المرور (نقاط البداية + الوجهات) المحدّدة على أنّها `place_id` عن 50.
`destinations[]`	`RouteMatrixDestination` الحقل مطلوب. مصفوفة الوجهات التي تحدّد أعمدة مصفوفة الردّ.
`travel_mode`	`RouteTravelMode` اختيارية: تحدّد هذه السمة وسيلة النقل.
`routing_preference`	`RoutingPreference` اختيارية: تحدّد هذه السمة كيفية احتساب المسار. يحاول الخادم استخدام خيار التوجيه المفضّل المحدّد لاحتساب المسار. إذا أدّى خيار التوجيه إلى حدوث خطأ أو تأخير طويل جدًا، سيتم عرض رسالة خطأ. يمكنك تحديد هذا الخيار فقط عندما تكون قيمة `travel_mode` هي `DRIVE` أو `TWO_WHEELER`، وإلا سيفشل الطلب.
`departure_time`	`Timestamp` اختيارية: وقت المغادرة في حال عدم ضبط هذه القيمة، يتم ضبطها تلقائيًا على الوقت الذي أرسلت فيه الطلب. إذا ضبطت هذه القيمة على وقت حدث من قبل، سيتعذّر تنفيذ الطلب.

ComputeRoutesRequest

رسالة الطلب ComputeRoutes

الحقول
`origin`	`Waypoint` الحقل مطلوب. نقطة الانطلاق على المسار
`destination`	`Waypoint` الحقل مطلوب. نقطة على المسار للوجهة
`intermediates[]`	`Waypoint` اختيارية: مجموعة من نقاط المرور على طول الطريق (باستثناء نقاط النهاية)، إما للتوقف عندها أو المرور بها يمكن إضافة ما يصل إلى 25 نقطة توقّف وسيطة.
`travel_mode`	`RouteTravelMode` اختيارية: تحدّد هذه السمة وسيلة النقل.
`routing_preference`	`RoutingPreference` اختيارية: تحدّد هذه السمة كيفية احتساب المسار. يحاول الخادم استخدام خيار التوجيه المفضّل المحدّد لاحتساب المسار. إذا أدّى خيار التوجيه إلى حدوث خطأ أو تأخير طويل جدًا، سيتم عرض رسالة خطأ. يمكنك تحديد هذا الخيار فقط عندما تكون قيمة `travel_mode` هي `DRIVE` أو `TWO_WHEELER`، وإلا سيفشل الطلب.
`polyline_quality`	`PolylineQuality` اختيارية: تحدّد هذه السمة إعداداتك المفضّلة لجودة الخط المتعدد الأضلاع.
`polyline_encoding`	`PolylineEncoding` اختيارية: تحدّد هذه السمة الترميز المفضّل للخط المتعدد الأضلاع.
`departure_time`	`Timestamp` اختيارية: وقت المغادرة في حال عدم ضبط هذه القيمة، يتم ضبطها تلقائيًا على الوقت الذي أرسلت فيه الطلب. إذا ضبطت هذه القيمة على وقت حدث في الماضي، سيتعذّر تنفيذ الطلب.
`compute_alternative_routes`	`bool` اختيارية: تحدّد هذه السمة ما إذا كان سيتم احتساب المسارات البديلة بالإضافة إلى المسار. لا يتم عرض طرق بديلة للطلبات التي تتضمّن نقاط توقّف وسيطة.
`route_modifiers`	`RouteModifiers` اختيارية: مجموعة من الشروط التي يجب استيفاؤها وتؤثر في طريقة احتساب المسارات
`language_code`	`string` اختيارية: رمز اللغة المستخدَمة وفق المعيار BCP-47، مثل "en-US" أو "sr-Latn" لمزيد من المعلومات، يُرجى الاطّلاع على معرّف اللغة Unicode. اطّلِع على اللغات المتاحة للحصول على قائمة باللغات المتاحة. عندما لا تقدّم هذه القيمة، يتم استنتاج لغة العرض من الموقع الجغرافي لطلب المسار.
`units`	`Units` اختيارية: تحدّد هذه السمة وحدات القياس لحقول العرض. ويشمل ذلك الحقل `instruction` في `NavigationInstruction`. لا تتأثر وحدات القياس المستخدَمة للمسار والجزء والخطوة والمسافة والمدة بهذه القيمة. في حال عدم تقديم هذه القيمة، يتم استنتاج وحدات العرض من الموقع الجغرافي للطلب.
`optimize_waypoint_order`	`bool` إذا تم ضبط optimizeWaypointOrder على "صحيح"، ستتم محاولة إعادة ترتيب نقاط المرور الوسيطة المحدّدة لتقليل التكلفة الإجمالية للمسار. إذا كانت أي من نقاط الطريق الوسيطة تمر عبر نقطة طريق، سيتعذّر تنفيذ الطلب. استخدِم `ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index` للعثور على الترتيب الجديد. إذا لم يتم طلب `routes.optimized_intermediate_waypoint_index` في العنوان `X-Goog-FieldMask`، سيتعذّر تنفيذ الطلب. إذا تم ضبط `optimize_waypoint_order` على "خطأ"، سيكون `ComputeRoutesResponse.optimized_intermediate_waypoint_index` فارغًا.

ComputeRoutesResponse

ComputeRoutes هي رسالة الرد.

الحقول

الحقول
`routes[]`	`Route` تحتوي على مصفوفة من المسارات المحسوبة (بحد أقصى ثلاثة) عند تحديد `compute_alternatives_routes`، وتحتوي على مسار واحد فقط عند عدم تحديدها. عندما تحتوي هذه المصفوفة على إدخالات متعددة، يكون الإدخال الأول هو المسار الأكثر اقتراحًا. إذا كانت المصفوفة فارغة، يعني ذلك أنّه لم يتم العثور على أي مسار.
`fallback_info`	`FallbackInfo` في بعض الحالات التي لا يتمكّن فيها الخادم من احتساب نتائج المسار باستخدام جميع الإعدادات المفضّلة المُدخَلة، قد يعود إلى استخدام طريقة احتساب مختلفة. عند استخدام وضع الاسترجاع، يحتوي هذا الحقل على معلومات مفصّلة حول الردّ الاحتياطي. وفي ما عدا ذلك، يكون هذا الحقل غير مضبوط.

routes[]

Route

تحتوي على مصفوفة من المسارات المحسوبة (بحد أقصى ثلاثة) عند تحديد compute_alternatives_routes، وتحتوي على مسار واحد فقط عند عدم تحديدها. عندما تحتوي هذه المصفوفة على إدخالات متعددة، يكون الإدخال الأول هو المسار الأكثر اقتراحًا. إذا كانت المصفوفة فارغة، يعني ذلك أنّه لم يتم العثور على أي مسار.

fallback_info

FallbackInfo

في بعض الحالات التي لا يتمكّن فيها الخادم من احتساب نتائج المسار باستخدام جميع الإعدادات المفضّلة المُدخَلة، قد يعود إلى استخدام طريقة احتساب مختلفة. عند استخدام وضع الاسترجاع، يحتوي هذا الحقل على معلومات مفصّلة حول الردّ الاحتياطي. وفي ما عدا ذلك، يكون هذا الحقل غير مضبوط.

CustomRoute

تتضمّن هذه السمة مسارًا مخصّصًا يتم احتسابه استنادًا إلى هدف المسار الذي يحدّده العميل. يحتوي CustomRoute على مسار ورمز مميّز للمسار، ويمكن تمريرهما إلى NavSDK لإعادة إنشاء المسار المخصّص للتنقّل خطوة بخطوة.

الحقول

الحقول
`route`	`Route` المسار الذي يُعدّ "الأفضل" لهدف المسار المُدخَل
`token`	`string` رمز مميّز للمسار بترميز base64 آمن على الويب يمكن تمريره إلى NavSDK، ما يسمح لـ NavSDK بإعادة إنشاء المسار أثناء التنقّل، وفي حال إعادة التوجيه، يتم الالتزام بالنية الأصلية عند استدعاء `RoutesPreferred` `ComputeCustomRoutes`. على العملاء التعامل مع هذا الرمز المميز على أنّه كائن ثنائي كبير غير شفاف.

route

Route

المسار الذي يُعدّ "الأفضل" لهدف المسار المُدخَل

token

string

رمز مميّز للمسار بترميز base64 آمن على الويب يمكن تمريره إلى NavSDK، ما يسمح لـ NavSDK بإعادة إنشاء المسار أثناء التنقّل، وفي حال إعادة التوجيه، يتم الالتزام بالنية الأصلية عند استدعاء RoutesPreferred ComputeCustomRoutes. على العملاء التعامل مع هذا الرمز المميز على أنّه كائن ثنائي كبير غير شفاف.

FallbackInfo

معلومات ذات صلة بطريقة استخدام نتيجة احتياطية وسبب استخدامها في حال ضبط هذا الحقل، يعني ذلك أنّ الخادم استخدم وضع توجيه مختلفًا عن الوضع المفضّل لديك كخيار احتياطي.

الحقول

الحقول
`routing_mode`	`FallbackRoutingMode` وضع التوجيه المستخدَم للردّ. في حال تم تفعيل وضع احتياطي، قد يختلف الوضع عن إعدادات التوجيه المفضّلة في طلب العميل الأصلي.
`reason`	`FallbackReason` سبب استخدام الردّ الاحتياطي بدلاً من الردّ الأصلي لا تتم تعبئة هذا الحقل إلا عند تفعيل وضع الموافقة الاحتياطية وعرض الرد الاحتياطي.

routing_mode

FallbackRoutingMode

reason

FallbackReason

FallbackReason

أسباب استخدام الرد الاحتياطي

عمليات التعداد
`FALLBACK_REASON_UNSPECIFIED`	لم يتم تحديد سبب احتياطي.
`SERVER_ERROR`	حدث خطأ في الخادم أثناء احتساب المسارات باستخدام وضع التوجيه المفضّل لديك، ولكن تمكّنا من عرض نتيجة تم احتسابها باستخدام وضع بديل.
`LATENCY_EXCEEDED`	لم نتمكّن من إنهاء عملية الاحتساب باستخدام وضع التوجيه المفضّل لديك في الوقت المناسب، ولكن تمكّنا من عرض نتيجة تم احتسابها باستخدام وضع بديل.

FallbackRoutingMode

وضع التوجيه الفعلي المستخدَم للردّ الاحتياطي الذي تم إرجاعه.

عمليات التعداد
`FALLBACK_ROUTING_MODE_UNSPECIFIED`	لم يتم الاستخدام.
`FALLBACK_TRAFFIC_UNAWARE`	تشير إلى أنّه تم استخدام وضع توجيه `TRAFFIC_UNAWARE` لاحتساب الردّ.
`FALLBACK_TRAFFIC_AWARE`	تشير إلى أنّه تم استخدام وضع توجيه `TRAFFIC_AWARE` لاحتساب الردّ.

الموقع الجغرافي

تتضمّن هذه السمة موقعًا جغرافيًا (نقطة جغرافية واتجاهًا اختياريًا).

الحقول

الحقول
`lat_lng`	`LatLng` الإحداثيات الجغرافية لنقطة الطريق
`heading`	`Int32Value` تمثّل هذه السمة اتجاه البوصلة المرتبط باتجاه تدفق حركة المرور. تحدّد هذه القيمة جهة الطريق التي يجب استخدامها للاستلام والتسليم. يمكن أن تتراوح قيم الاتجاه من 0 إلى 360، حيث يشير 0 إلى اتجاه الشمال، ويشير 90 إلى اتجاه الشرق، وهكذا. يمكنك استخدام هذا الحقل فقط لوضعَي التنقّل `DRIVE` و`TWO_WHEELER`.

lat_lng

LatLng

الإحداثيات الجغرافية لنقطة الطريق

heading

Int32Value

تمثّل هذه السمة اتجاه البوصلة المرتبط باتجاه تدفق حركة المرور. تحدّد هذه القيمة جهة الطريق التي يجب استخدامها للاستلام والتسليم. يمكن أن تتراوح قيم الاتجاه من 0 إلى 360، حيث يشير 0 إلى اتجاه الشمال، ويشير 90 إلى اتجاه الشرق، وهكذا. يمكنك استخدام هذا الحقل فقط لوضعَي التنقّل DRIVE وTWO_WHEELER.

المناورة

مجموعة من القيم التي تحدّد إجراء التنقّل الذي يجب اتّخاذه في الخطوة الحالية (على سبيل المثال، الانعطاف إلى اليسار أو الدمج أو الاستمرار في السير بشكل مستقيم)

عمليات التعداد
`MANEUVER_UNSPECIFIED`	لم يتم الاستخدام.
`TURN_SLIGHT_LEFT`	اتّجِه قليلاً نحو اليسار.
`TURN_SHARP_LEFT`	اتّجِه يسارًا بشكل حاد.
`UTURN_LEFT`	يُرجى الدوران للاتجاه المعاكس يسارًا.
`TURN_LEFT`	اتّجه يسارًا.
`TURN_SLIGHT_RIGHT`	اتّجه قليلاً نحو اليمين.
`TURN_SHARP_RIGHT`	انعطِف بشدة إلى اليمين.
`UTURN_RIGHT`	يُرجى الدوران إلى اليمين والعودة إلى الاتجاه المعاكس.
`TURN_RIGHT`	اتّجه يمينًا.
`STRAIGHT`	اتّبِع الطريق المستقيم.
`RAMP_LEFT`	اسلك الطريق المنحدر الأيسر.
`RAMP_RIGHT`	اسلك الطريق المنحدر الأيمن.
`MERGE`	الاندماج في حركة المرور
`FORK_LEFT`	اتّبِعوا الطريق المتفرّع على اليسار.
`FORK_RIGHT`	اتّبِع الطريق المتفرّع على اليمين.
`FERRY`	استقلّ العبّارة.
`FERRY_TRAIN`	استقلّ القطار الذي يؤدي إلى العبّارة.
`ROUNDABOUT_LEFT`	اتّجِه يسارًا عند الدوّار.
`ROUNDABOUT_RIGHT`	اتّجِه يمينًا عند الدوّار.
`DEPART`	المناورة الأولية
`NAME_CHANGE`	تُستخدَم للإشارة إلى تغيير اسم شارع.
`DESTINATION`	تُستخدَم للإشارة إلى الوصول إلى وجهة.

NavigationInstruction

الحقول

maneuver

Maneuver

تتضمّن هذه السمة تعليمات التنقّل الخاصة بالخطوة الحالية (على سبيل المثال، الانعطاف إلى اليسار أو الدمج أو المتابعة بشكل مستقيم). يحدّد هذا الحقل الرمز الذي سيتم عرضه.

instructions

string

تعليمات التنقّل في هذه الخطوة

خط متعدد

تتضمّن هذه الفئة خطًا متعدّد الأضلاع مرمّزًا.

الحقول

الحقول
حقل الربط `polyline_type` تتضمّن هذه السمة نوع الخط المتعدد الأضلاع. القيمة التلقائية هي encoded_polyline. يمكن أن يكون التعليق `polyline_type` إحدى القيم التالية فقط:
`encoded_polyline`	`string` تمثّل هذه السمة الترميز السلسلة لخط متعدد الأضلاع باستخدام خوارزمية ترميز الخطوط المتعددة الأضلاع.
`geo_json_linestring`	`Struct` تحدّد هذه السمة خطًا متعدد الأجزاء باستخدام تنسيق GeoJSON LineString.

حقل الربط polyline_type تتضمّن هذه السمة نوع الخط المتعدد الأضلاع. القيمة التلقائية هي encoded_polyline. يمكن أن يكون التعليق polyline_type إحدى القيم التالية فقط:

encoded_polyline

string

تمثّل هذه السمة الترميز السلسلة لخط متعدد الأضلاع باستخدام خوارزمية ترميز الخطوط المتعددة الأضلاع.

geo_json_linestring

Struct

تحدّد هذه السمة خطًا متعدد الأجزاء باستخدام تنسيق GeoJSON LineString.

PolylineEncoding

تحدّد هذه السمة النوع المفضّل من الخطوط المتعددة الأضلاع المطلوب عرضه.

عمليات التعداد
`POLYLINE_ENCODING_UNSPECIFIED`	لم يتم تحديد أي إعدادات مفضّلة لنوع الخط المتعدد. القيمة التلقائية هي `ENCODED_POLYLINE`.
`ENCODED_POLYLINE`	تحدّد هذه السمة خطًا متعدد الأضلاع تم ترميزه باستخدام خوارزمية ترميز الخطوط المتعددة الأضلاع.
`GEO_JSON_LINESTRING`	تحدّد هذه السمة خطًا متعدد الأجزاء باستخدام تنسيق GeoJSON LineString.

PolylineQuality

مجموعة من القيم التي تحدّد جودة الخط المتعدد الأضلاع.

عمليات التعداد
`POLYLINE_QUALITY_UNSPECIFIED`	لم يتم تحديد أي إعدادات مفضَّلة لجودة الخطوط المتعددة. القيمة التلقائية هي `OVERVIEW`.
`HIGH_QUALITY`	تحدّد هذه السمة خطًا متعدد الأضلاع عالي الجودة، ويتألف من نقاط أكثر من `OVERVIEW`، ولكنّها تؤدي إلى زيادة حجم الردّ. استخدِم هذه القيمة عندما تحتاج إلى دقة أكبر.
`OVERVIEW`	تحدّد هذه السمة خطًا متعدد الأضلاع للّقطة العامة، وهو يتألف من عدد صغير من النقاط. استخدِم هذه القيمة عند عرض نظرة عامة على المسار. يؤدي استخدام هذا الخيار إلى تقليل وقت استجابة الطلب مقارنةً باستخدام الخيار `HIGH_QUALITY`.

مسار

تتضمّن هذه الفئة مسارًا يتألف من سلسلة من مقاطع الطرق المتصلة التي تربط بين نقاط البداية والنهاية ونقاط المرور الوسيطة.

الحقول
`legs[]`	`RouteLeg` مجموعة من الأجزاء (أجزاء المسار بين نقاط المرور) التي تشكّل المسار يتوافق كل جزء مع الرحلة بين نقطتَي `via` غير نقطتَي مرور. على سبيل المثال، يتضمّن المسار الذي لا يحتوي على نقاط طريق وسيطة مرحلة واحدة فقط. يتضمّن المسار الذي يتضمّن نقطة على المسار وسيطة واحدة غير `via` جزأين. يتضمّن المسار الذي يشمل نقطة طريق وسيطة واحدة `via` جزءًا واحدًا. يتطابق ترتيب الأجزاء مع ترتيب نقاط الطريق من `origin` إلى `intermediates` إلى `destination`.
`distance_meters`	`int32` تمثّل هذه السمة مسافة السفر للمسار بالأمتار.
`duration`	`Duration` تمثّل هذه السمة المدة الزمنية اللازمة للتنقّل على طول المسار. إذا ضبطت `routing_preference` على `TRAFFIC_UNAWARE`، ستكون هذه القيمة هي نفسها قيمة `static_duration`. إذا ضبطت `routing_preference` على `TRAFFIC_AWARE` أو `TRAFFIC_AWARE_OPTIMAL`، يتم احتساب هذه القيمة مع أخذ حالة حركة المرور في الاعتبار.
`static_duration`	`Duration` مدة التنقّل عبر المسار بدون أخذ أحوال حركة المرور في الاعتبار
`polyline`	`Polyline` الخطوط المتعددة للمسار بشكل عام هذا الخط المتعدد الأضلاع هو الخط المتعدد الأضلاع المدمج لجميع `legs`.
`description`	`string` تمثّل هذه السمة وصفًا للمسار.
`warnings[]`	`string` مصفوفة من التحذيرات التي يجب عرضها عند عرض المسار
`viewport`	`Viewport` مربّع الحدود الخاص بإطار العرض للخط المتعدد
`travel_advisory`	`RouteTravelAdvisory` معلومات إضافية حول المسار
`optimized_intermediate_waypoint_index[]`	`int32` إذا تم ضبط `ComputeRoutesRequest.optimize_waypoint_order` على "صحيح"، يحتوي هذا الحقل على الترتيب المحسّن لنقاط الطريق الوسيطة، وإلا سيكون هذا الحقل فارغًا. على سبيل المثال، لنفترض أنّ الإدخال هو: نقطة الانطلاق: دبي، نقاط التوقّف الوسيطة: الرياض، جدة، الدمام، نقطة الوصول: القاهرة، وترتيب نقاط التوقّف الوسيطة المحسّن هو: الرياض، جدة، الدمام. بعد ذلك، يحتوي هذا الحقل على القيم [2, 0, 1]. يبدأ الفهرس بالرقم 0 لأول نقطة طريق وسيطة.

RouteLeg

تتضمّن هذه السمة جزءًا بين نقاط طريق غير via.

الحقول
`distance_meters`	`int32` تمثّل هذه السمة مسافة التنقّل في جزء المسار، وذلك بالأمتار.
`duration`	`Duration` مدة الوقت اللازمة للتنقّل في الجزء من الرحلة إذا تم ضبط `route_preference` على `TRAFFIC_UNAWARE`، تكون هذه القيمة هي نفسها `static_duration`. إذا كانت قيمة `route_preference` هي `TRAFFIC_AWARE` أو `TRAFFIC_AWARE_OPTIMAL`، يتم احتساب هذه القيمة مع أخذ حالة حركة المرور في الاعتبار.
`static_duration`	`Duration` تشير هذه السمة إلى مدة التنقّل خلال الجزء من الرحلة، ويتم احتسابها بدون أخذ حالة حركة المرور في الاعتبار.
`polyline`	`Polyline` تمثّل هذه السمة الخط المتعدد الأضلاع العام لهذه الرحلة. ويشمل ذلك الخطوط المتعددة لكل `step`.
`start_location`	`Location` تمثّل هذه السمة الموقع الجغرافي لنقطة بداية هذا الجزء من الرحلة. قد يختلف هذا الرقم عن `origin` المقدَّم. على سبيل المثال، عندما لا يكون `origin` المقدَّم بالقرب من طريق، تكون هذه نقطة على الطريق.
`end_location`	`Location` تمثّل هذه السمة الموقع الجغرافي النهائي لهذه المرحلة. قد يختلف هذا الرقم عن `destination` المقدَّم. على سبيل المثال، عندما لا يكون `destination` المقدَّم بالقرب من طريق، تكون هذه نقطة على الطريق.
`steps[]`	`RouteLegStep` مصفوفة من الخطوات تشير إلى شرائح ضمن هذا الجزء من الرحلة تمثّل كل خطوة تعليمات تنقّل واحدة.
`travel_advisory`	`RouteLegTravelAdvisory` تتضمّن هذه السمة المعلومات الإضافية التي يجب إبلاغ المستخدم بها، مثل القيود المحتملة على منطقة حركة المرور وما إلى ذلك في جزء من مسار.

RouteLegStep

تغليف جزء من RouteLeg تمثّل الخطوة تعليمات تنقّل واحدة. تتكوّن أجزاء المسار من خطوات.

الحقول
`distance_meters`	`int32` تمثّل هذه السمة مسافة التنقّل لهذه الخطوة بالمتر. في بعض الحالات، قد لا يتضمّن هذا الحقل قيمة.
`static_duration`	`Duration` مدة التنقّل خلال هذه الخطوة بدون أخذ حالة حركة المرور في الاعتبار في بعض الحالات، قد لا يتضمّن هذا الحقل قيمة.
`polyline`	`Polyline` تمثّل هذه السمة الخط المتعدد الأضلاع المرتبط بهذه الخطوة.
`start_location`	`Location` تمثّل هذه السمة الموقع الجغرافي لنقطة البداية لهذه الخطوة.
`end_location`	`Location` الموقع الجغرافي النهائي لهذه الخطوة
`navigation_instruction`	`NavigationInstruction` تعليمات التنقّل
`travel_advisory`	`RouteLegStepTravelAdvisory` تتضمّن هذه السمة المعلومات الإضافية التي يجب إبلاغ المستخدم بها، مثل القيود المحتملة على منطقة حركة المرور في خطوة من الرحلة.

RouteLegStepTravelAdvisory

تتضمّن هذه السمة المعلومات الإضافية التي يجب إبلاغ المستخدم بها، مثل القيود المحتملة على منطقة حركة المرور في خطوة من الرحلة.

الحقول

الحقول
`speed_reading_intervals[]`	`SpeedReadingInterval` ملاحظة: هذا الحقل غير مملوء حاليًا.

speed_reading_intervals[]

SpeedReadingInterval

ملاحظة: هذا الحقل غير مملوء حاليًا.

RouteLegTravelAdvisory

تتضمّن هذه السمة المعلومات الإضافية التي يجب إبلاغ المستخدم بها، مثل القيود المحتملة على منطقة حركة المرور وما إلى ذلك في جزء من مسار.

الحقول

الحقول
`toll_info`	`TollInfo` تحتوي هذه السمة على معلومات حول رسوم المرور على `RouteLeg` المحدّد. لا يتم ملء هذا الحقل إلا إذا كنّا نتوقّع وجود رسوم مرور على `RouteLeg`. إذا تم ضبط هذا الحقل ولكن لم تتم تعبئة الحقل الفرعي `estimated_price`، نتوقّع أن يحتوي الطريق على رسوم ولكن لا نعرف السعر المقدّر. إذا لم يكن هذا الحقل متوفّرًا، يعني ذلك أنّه لا توجد رسوم مرور على `RouteLeg`.
`speed_reading_intervals[]`	`SpeedReadingInterval` فواصل القراءة السريعة التي توضّح كثافة حركة المرور ينطبق ذلك في حال إعدادات التوجيه المفضّلة لـ "`TRAFFIC_AWARE`" و"`TRAFFIC_AWARE_OPTIMAL`". تغطّي الفواصل الزمنية خطوطًا متعددة الأضلاع بالكامل في `RouteLeg` بدون تداخل. تكون نقطة بداية فاصل زمني محدّد هي نفسها نقطة نهاية الفاصل الزمني السابق. مثال: `polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).`

toll_info

TollInfo

تحتوي هذه السمة على معلومات حول رسوم المرور على RouteLeg المحدّد. لا يتم ملء هذا الحقل إلا إذا كنّا نتوقّع وجود رسوم مرور على RouteLeg. إذا تم ضبط هذا الحقل ولكن لم تتم تعبئة الحقل الفرعي estimated_price، نتوقّع أن يحتوي الطريق على رسوم ولكن لا نعرف السعر المقدّر. إذا لم يكن هذا الحقل متوفّرًا، يعني ذلك أنّه لا توجد رسوم مرور على RouteLeg.

speed_reading_intervals[]

SpeedReadingInterval

فواصل القراءة السريعة التي توضّح كثافة حركة المرور ينطبق ذلك في حال إعدادات التوجيه المفضّلة لـ "TRAFFIC_AWARE" و"TRAFFIC_AWARE_OPTIMAL". تغطّي الفواصل الزمنية خطوطًا متعددة الأضلاع بالكامل في RouteLeg بدون تداخل. تكون نقطة بداية فاصل زمني محدّد هي نفسها نقطة نهاية الفاصل الزمني السابق.

مثال:

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

RouteMatrixDestination

وجهة واحدة لـ ComputeRouteMatrixRequest

الحقول

الحقول
`waypoint`	`Waypoint` الحقل مطلوب. نقطة طريق الوجهة

waypoint

Waypoint

الحقل مطلوب. نقطة طريق الوجهة

RouteMatrixElement

تتضمّن هذه الفئة معلومات المسار التي تم احتسابها لزوج من نقطتَي الأصل والوجهة في ComputeRouteMatrix API. يمكن بث هذا البروتوكول إلى العميل.

الحقول
`origin_index`	`int32` فهرس مستند إلى الصفر للمصدر في الطلب
`destination_index`	`int32` فهرس الوجهة المستند إلى الصفر في الطلب
`status`	`Status` رمز حالة الخطأ لهذا العنصر.
`condition`	`RouteMatrixElementCondition` تشير هذه السمة إلى ما إذا تم العثور على المسار أم لا. بغض النظر عن الحالة.
`distance_meters`	`int32` تمثّل هذه السمة مسافة السفر للمسار بالأمتار.
`duration`	`Duration` تمثّل هذه السمة المدة الزمنية اللازمة للتنقّل على طول المسار. إذا ضبطت `routing_preference` على `TRAFFIC_UNAWARE`، ستكون هذه القيمة هي نفسها قيمة `static_duration`. إذا ضبطت `routing_preference` على `TRAFFIC_AWARE` أو `TRAFFIC_AWARE_OPTIMAL`، يتم احتساب هذه القيمة مع أخذ حالة حركة المرور في الاعتبار.
`static_duration`	`Duration` تمثّل هذه السمة مدة التنقّل في المسار بدون أخذ أحوال حركة المرور في الاعتبار.
`travel_advisory`	`RouteTravelAdvisory` معلومات إضافية حول المسار على سبيل المثال: معلومات عن الحظر ومعلومات عن رسوم المرور
`fallback_info`	`FallbackInfo` في بعض الحالات التي لا يمكن فيها للخادم احتساب المسار باستخدام الإعدادات المفضّلة المحدّدة لزوج نقطة الانطلاق/نقطة الوصول هذا، قد يعود إلى استخدام طريقة احتساب مختلفة. عند استخدام وضع التراجع، يحتوي هذا الحقل على معلومات مفصّلة حول الردّ الاحتياطي. وفي ما عدا ذلك، يكون هذا الحقل غير مضبوط.

RouteMatrixElementCondition

تمثّل هذه السمة حالة المسار الذي يتم عرضه.

عمليات التعداد
`ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED`	يتم استخدامها فقط عندما تكون قيمة السمة `status` للعنصر غير صالحة.
`ROUTE_EXISTS`	تم العثور على مسار، وتم ملء المعلومات ذات الصلة بالعنصر.
`ROUTE_NOT_FOUND`	لم يتم العثور على أي مسار. لن يتم ملء الحقول التي تحتوي على معلومات المسار، مثل `distance_meters` أو `duration`، في العنصر.

RouteMatrixOrigin

مصدر واحد لـ ComputeRouteMatrixRequest

الحقول

الحقول
`waypoint`	`Waypoint` الحقل مطلوب. نقطة طريق المنشأ
`route_modifiers`	`RouteModifiers` اختيارية: معدِّلات لكل مسار يستخدِم هذا الموقع الجغرافي كأصل

waypoint

Waypoint

الحقل مطلوب. نقطة طريق المنشأ

route_modifiers

RouteModifiers

اختيارية: معدِّلات لكل مسار يستخدِم هذا الموقع الجغرافي كأصل

RouteModifiers

تتضمّن هذه السمة مجموعة من الشروط الاختيارية التي يجب استيفاؤها عند احتساب المسارات.

الحقول
`avoid_tolls`	`bool` عند ضبطها على "صحيح"، يتم تجنُّب الطرق برسوم عبور حيثما كان ذلك معقولاً، مع إعطاء الأولوية للمسارات التي لا تحتوي على طرق برسوم عبور. ينطبق ذلك على وضعَي السفر `DRIVE` و`TWO_WHEELER` فقط.
`avoid_highways`	`bool` عند ضبطها على "صحيح"، يتم تجنُّب الطرق السريعة حيثما كان ذلك معقولاً، مع إعطاء الأولوية للمسارات التي لا تحتوي على طرق سريعة. ينطبق ذلك على وضعَي السفر `DRIVE` و`TWO_WHEELER` فقط.
`avoid_ferries`	`bool` عند ضبطها على "صحيح"، يتم تجنُّب العبّارات حيثما كان ذلك معقولاً، مع إعطاء الأولوية للمسارات التي لا تحتوي على عبّارات. ينطبق ذلك على وضعَي السفر `DRIVE` و`TWO_WHEELER` فقط.
`avoid_indoor`	`bool` عند ضبطها على "صحيح"، يتم تجنُّب التنقّل في الأماكن المغلقة حيثما كان ذلك منطقيًا، مع إعطاء الأولوية للمسارات التي لا تتضمّن التنقّل في الأماكن المغلقة. ينطبق ذلك على `WALK` وضع السفر فقط.
`vehicle_info`	`VehicleInfo` تحدّد هذه السمة معلومات المركبة.
`toll_passes[]`	`TollPass` تتضمّن هذه الفئة معلومات حول بطاقات لرسوم العبور. في حال توفير بطاقات عبور، تحاول واجهة برمجة التطبيقات عرض سعر البطاقة. في حال عدم توفير بطاقات عبور، ستتعامل واجهة برمجة التطبيقات مع بطاقة العبور على أنّها غير معروفة وستحاول عرض السعر النقدي. ينطبق ذلك على وضعَي السفر `DRIVE` و`TWO_WHEELER` فقط.

RouteObjective

تتضمّن هذه السمة هدفًا لتحسين الأداء من خلال ComputeCustomRoutes.

الحقول

الحقول
حقل الربط `objective` هدف المسار يمكن أن يكون التعليق `objective` إحدى القيم التالية فقط:
`rate_card`	`RateCard` هدف RateCard

حقل الربط objective هدف المسار يمكن أن يكون التعليق objective إحدى القيم التالية فقط:

rate_card

RateCard

هدف RateCard

RateCard

تتضمّن هذه السمة هدف مسار RateCard.

الحقول

الحقول
`cost_per_minute`	`MonetaryCost` اختيارية: التكلفة لكل دقيقة
`cost_per_km`	`MonetaryCost` اختيارية: التكلفة لكل كيلومتر
`include_tolls`	`bool` اختيارية: تُستخدَم لتحديد ما إذا كان سيتم تضمين تكلفة المرور في الطرقات التي يتم تحصيل رسوم فيها ضمن التكلفة الإجمالية.

cost_per_minute

MonetaryCost

اختيارية: التكلفة لكل دقيقة

cost_per_km

MonetaryCost

اختيارية: التكلفة لكل كيلومتر

include_tolls

bool

اختيارية: تُستخدَم لتحديد ما إذا كان سيتم تضمين تكلفة المرور في الطرقات التي يتم تحصيل رسوم فيها ضمن التكلفة الإجمالية.

MonetaryCost

تتضمّن هذه السمة التكلفة المستخدَمة في بطاقة الأسعار.

الحقول

الحقول
`value`	`double` الحقل مطلوب. قيمة التكلفة بالعملة المحلية المستنتَجة من الطلب

value

double

الحقل مطلوب. قيمة التكلفة بالعملة المحلية المستنتَجة من الطلب

RouteTravelAdvisory

تتضمّن هذه السمة المعلومات الإضافية التي يجب إبلاغ المستخدم بها، مثل القيود المحتملة على منطقة الزيارات وما إلى ذلك.

الحقول

الحقول
`toll_info`	`TollInfo` تتضمّن هذه السمة معلومات عن رسوم المرور على "المسار". لا يتم ملء هذا الحقل إلا إذا كنّا نتوقّع وجود رسوم مرور على الطريق. إذا تم ضبط هذا الحقل ولكن لم تتم تعبئة الحقل الفرعي `estimated_price`، نتوقّع أن يحتوي الطريق على رسوم ولكن لا نعرف السعر المقدّر. في حال عدم ضبط هذا الحقل، نتوقّع عدم وجود رسوم على "الطريق".
`speed_reading_intervals[]`	`SpeedReadingInterval` فواصل القراءة السريعة التي توضّح كثافة حركة المرور ينطبق ذلك في حال إعدادات التوجيه المفضّلة لـ "`TRAFFIC_AWARE`" و"`TRAFFIC_AWARE_OPTIMAL`". تغطّي الفواصل الزمنية خطوطًا متعددة الأضلاع للمسار بالكامل بدون تداخل. تكون نقطة بداية فاصل زمني محدّد هي نفسها نقطة نهاية الفاصل الزمني السابق. مثال: `polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).`

toll_info

TollInfo

تتضمّن هذه السمة معلومات عن رسوم المرور على "المسار". لا يتم ملء هذا الحقل إلا إذا كنّا نتوقّع وجود رسوم مرور على الطريق. إذا تم ضبط هذا الحقل ولكن لم تتم تعبئة الحقل الفرعي estimated_price، نتوقّع أن يحتوي الطريق على رسوم ولكن لا نعرف السعر المقدّر. في حال عدم ضبط هذا الحقل، نتوقّع عدم وجود رسوم على "الطريق".

speed_reading_intervals[]

SpeedReadingInterval

فواصل القراءة السريعة التي توضّح كثافة حركة المرور ينطبق ذلك في حال إعدادات التوجيه المفضّلة لـ "TRAFFIC_AWARE" و"TRAFFIC_AWARE_OPTIMAL". تغطّي الفواصل الزمنية خطوطًا متعددة الأضلاع للمسار بالكامل بدون تداخل. تكون نقطة بداية فاصل زمني محدّد هي نفسها نقطة نهاية الفاصل الزمني السابق.

مثال:

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

RouteTravelMode

مجموعة من القيم تُستخدَم لتحديد وسيلة النقل.

عمليات التعداد
`TRAVEL_MODE_UNSPECIFIED`	لم يتم تحديد وسيلة النقل. القيمة التلقائية هي `DRIVE`.
`DRIVE`	التنقّل بسيارة ركاب
`BICYCLE`	التنقّل بالدراجة
`WALK`	التنقّل سيرًا على الأقدام
`TWO_WHEELER`	مركبة ذات عجلتين ومزوّدة بمحرّك على سبيل المثال، دراجة نارية. يُرجى العلم أنّ هذا يختلف عن `BICYCLE` وسيلة النقل التي تغطي الوسائل التي تعمل بالطاقة البشرية.
`TAXI`	التنقّل بسيارة أجرة مرخّصة، ما قد يسمح للمركبة بالتنقّل على ممرات مخصّصة لسيارات الأجرة في بعض المناطق ‫TAXI mode هي ميزة تجريبية. إذا طلب العميل مسارًا لسيارة أجرة في مدينة لا تتوفّر فيها بيانات ممرات سيارات الأجرة، سيتم عرض مسار "قيادة".

RoutingPreference

مجموعة من القيم التي تحدّد العوامل التي يجب أخذها في الاعتبار عند احتساب المسار.

عمليات التعداد
`ROUTING_PREFERENCE_UNSPECIFIED`	لم يتم تحديد أي إعدادات مفضّلة للتوجيه. القيمة التلقائية هي `TRAFFIC_AWARE`.
`TRAFFIC_UNAWARE`	تحسب المسارات بدون أخذ حالة حركة المرور في الوقت الفعلي في الاعتبار. هذه الحالة مناسبة عندما لا تكون أحوال حركة المرور مهمة أو لا تنطبق. يؤدي استخدام هذه القيمة إلى تحقيق أقل وقت استجابة. ملاحظة: بالنسبة إلى `RouteTravelMode` DRIVE وTWO_WHEELER، يستند المسار والمدة المحدّدان إلى شبكة الطرق ومتوسط حالة حركة المرور غير المرتبطة بالوقت، وليس إلى حالة الطرق الحالية. نتيجةً لذلك، قد تتضمّن المسارات طرقًا مغلقة مؤقتًا. قد تختلف نتائج طلب معيّن بمرور الوقت بسبب التغييرات في شبكة الطرق، وتعديل متوسط أحوال حركة المرور، وطبيعة الخدمة الموزّعة. قد تختلف النتائج أيضًا بين الطرق المتكافئة تقريبًا في أي وقت أو معدّل تكرار.
`TRAFFIC_AWARE`	تحتسب هذه الدالة المسارات مع أخذ أحوال حركة المرور في الاعتبار. على عكس `TRAFFIC_AWARE_OPTIMAL`، يتم تطبيق بعض التحسينات لتقليل وقت الاستجابة بشكل كبير.
`TRAFFIC_AWARE_OPTIMAL`	تحسب هذه الطريقة المسارات مع أخذ حالة حركة المرور في الاعتبار، بدون تطبيق معظم تحسينات الأداء. يؤدي استخدام هذه القيمة إلى حدوث أعلى وقت استجابة.

SpeedReadingInterval

مؤشر كثافة حركة المرور على جزء متجاور من خط متعدد أو مسار بالنظر إلى مسار يتضمّن النقاط P_0 وP_1 و... وP_N (فهرس يبدأ من الصفر)، يحدّد SpeedReadingInterval فاصلًا زمنيًا ويصف حركة المرور فيه باستخدام الفئات التالية.

الحقول

الحقول
`start_polyline_point_index`	`int32` فهرس بداية هذا الفاصل الزمني في الخط المتعدد الأضلاع في JSON، عندما يكون الفهرس 0، يبدو الحقل فارغًا.
`end_polyline_point_index`	`int32` فهرس نهاية هذا الفاصل الزمني في الخط المتعدد الأضلاع في JSON، عندما يكون الفهرس 0، يبدو الحقل فارغًا.
`speed`	`Speed` سرعة حركة المرور في هذه الفترة

start_polyline_point_index

int32

فهرس بداية هذا الفاصل الزمني في الخط المتعدد الأضلاع في JSON، عندما يكون الفهرس 0، يبدو الحقل فارغًا.

end_polyline_point_index

int32

فهرس نهاية هذا الفاصل الزمني في الخط المتعدد الأضلاع في JSON، عندما يكون الفهرس 0، يبدو الحقل فارغًا.

speed

Speed

سرعة حركة المرور في هذه الفترة

السرعة

تصنيف سرعة الخطوط المتعددة استنادًا إلى بيانات حركة المرور

عمليات التعداد
`SPEED_UNSPECIFIED`	القيمة التلقائية هذه القيمة غير مستخدَمة.
`NORMAL`	السرعة عادية، ولم يتم رصد أي تباطؤ.
`SLOW`	تم رصد تباطؤ في حركة المرور، ولكن لم يحدث ازدحام مروري.
`TRAFFIC_JAM`	تم رصد ازدحام مروري.

TollInfo

تغليف معلومات رسوم المرور على Route أو RouteLeg

الحقول

الحقول
`estimated_price[]`	`Money` تمثّل هذه السمة المبلغ النقدي لرسوم المرور الخاصة بالمركبة `Route` أو `RouteLeg`. تحتوي هذه القائمة على مبلغ مالي لكل عملة من المتوقع أن يتم تحصيلها من محطات تحصيل الرسوم. تحتوي هذه القائمة عادةً على عنصر واحد فقط للمسارات التي تتضمّن رسومًا بعملة واحدة. بالنسبة إلى الرحلات الدولية، قد تحتوي هذه القائمة على عناصر متعددة لعرض رسوم المرور بعملات مختلفة.

estimated_price[]

Money

تمثّل هذه السمة المبلغ النقدي لرسوم المرور الخاصة بالمركبة Route أو RouteLeg. تحتوي هذه القائمة على مبلغ مالي لكل عملة من المتوقع أن يتم تحصيلها من محطات تحصيل الرسوم. تحتوي هذه القائمة عادةً على عنصر واحد فقط للمسارات التي تتضمّن رسومًا بعملة واحدة. بالنسبة إلى الرحلات الدولية، قد تحتوي هذه القائمة على عناصر متعددة لعرض رسوم المرور بعملات مختلفة.

TollPass

قائمة ببطاقات لرسوم العبور حول العالم التي نتيح استخدامها

عمليات التعداد
`TOLL_PASS_UNSPECIFIED`	لم يتم الاستخدام. في حال استخدام هذه القيمة، سيتعذّر تنفيذ الطلب.
`AU_ETOLL_TAG`	أحد مقدّمي خدمات بطاقات المرور على الطرق السريعة في سيدني https://www.myetoll.com.au
`AU_EWAY_TAG`	أحد مقدّمي خدمات بطاقات المرور على الطرق السريعة في سيدني https://www.tollpay.com.au/
`AU_LINKT`	بطاقة لرسوم العبور صالحة في جميع أنحاء أستراليا يمكنك الاطّلاع على تفاصيل إضافية على https://www.linkt.com.au/.
`AR_TELEPASE`	بطاقة لرسوم العبور في الأرجنتين يمكنك الاطّلاع على تفاصيل إضافية على الرابط https://telepase.com.ar
`BR_AUTO_EXPRESO`	بطاقة رسوم العبور في البرازيل يمكنك الاطّلاع على تفاصيل إضافية على https://www.autoexpreso.com
`BR_CONECTCAR`	بطاقة لرسوم العبور في البرازيل يمكنك الاطّلاع على تفاصيل إضافية على https://conectcar.com.
`BR_MOVE_MAIS`	بطاقة لرسوم العبور في البرازيل يمكنك الاطّلاع على تفاصيل إضافية على https://movemais.com.
`BR_PASSA_RAPIDO`	بطاقة رسوم العبور في البرازيل يمكنك الاطّلاع على تفاصيل إضافية على الرابط https://pasorapido.gob.do/
`BR_SEM_PARAR`	بطاقة رسوم العبور في البرازيل يمكنك الاطّلاع على تفاصيل إضافية على https://www.semparar.com.br.
`BR_TAGGY`	بطاقة رسوم العبور في البرازيل يمكنك الاطّلاع على تفاصيل إضافية على الرابط https://taggy.com.br.
`BR_VELOE`	بطاقة رسوم العبور في البرازيل يمكنك الاطّلاع على تفاصيل إضافية على الرابط https://veloe.com.br/site/onde-usar.
`CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD`	معبر الحدود بين كندا والولايات المتحدة
`CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD`	معبر الحدود بين كندا والولايات المتحدة
`CA_US_BLUE_WATER_EDGE_PASS`	معبر حدودي من أونتاريو، كندا إلى ميشيغان، الولايات المتحدة
`CA_US_CONNEXION`	معبر حدودي من أونتاريو، كندا إلى ميشيغان، الولايات المتحدة
`CA_US_NEXUS_CARD`	معبر الحدود بين كندا والولايات المتحدة
`ID_E_TOLL`	إندونيسيا بطاقة إلكترونية مقدَّمة من عدة مصارف تُستخدَم لدفع رسوم المرور يتم تحصيل الرسوم نفسها على جميع البطاقات الإلكترونية من خلال البنوك، لذا لا يلزم سوى قيمة تعداد واحدة. مثلاً: Bank Mandiri https://www.bankmandiri.co.id/e-money وBCA https://www.bca.co.id/flazz وBNI https://www.bni.co.id/id-id/ebanking/tapcash
`IN_FASTAG`	India.
`IN_LOCAL_HP_PLATE_EXEMPT`	الهند، إعفاء لوحات المركبات في ولاية هيماشال براديش
`JP_ETC`	نظام ETC في اليابان: نظام لاسلكي إلكتروني لجمع رسوم المرور https://www.go-etc.jp/
`JP_ETC2`	اليابان ETC2.0. إصدار جديد من نظام ETC يوفّر خصمًا إضافيًا ويتيح التواصل في اتجاهين بين الأجهزة في المركبات والهوائيات على الطريق. https://www.go-etc.jp/etc2/index.html
`MX_IAVE`	المكسيك https://iave.capufe.gob.mx/#/
`MX_PASE`	المكسيك https://www.pase.com.mx
`MX_QUICKPASS`	المكسيك https://operadoravial.com/quick-pass/
`MX_SISTEMA_TELEPEAJE_CHIHUAHUA`	المكسيك http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
`MX_TAG_IAVE`	المكسيك
`MX_TAG_TELEVIA`	شركة بطاقات رسوم العبور في المكسيك وهي إحدى الشركات العديدة التي تعمل في مكسيكو سيتي. يمكنك الاطّلاع على تفاصيل إضافية على https://www.televia.com.mx.
`MX_TELEVIA`	شركة بطاقات رسوم العبور في المكسيك أحد العديد من المشغّلين في مكسيكو سيتي. https://www.televia.com.mx
`MX_VIAPASS`	بطاقة لرسوم العبور في المكسيك يمكنك الاطّلاع على تفاصيل إضافية على https://www.viapass.com.mx/viapass/web_home.aspx.
`US_AL_FREEDOM_PASS`	ألاباما، الولايات المتحدة الأمريكية
`US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS`	ألاسكا، الولايات المتحدة الأمريكية
`US_CA_FASTRAK`	كاليفورنيا، الولايات المتحدة الأمريكية
`US_CA_FASTRAK_CAV_STICKER`	تشير إلى أنّ السائق لديه أي بطاقة FasTrak بالإضافة إلى ملصق Clean Air Vehicle (CAV) الصادر عن إدارة المركبات (DMV). https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
`US_CO_EXPRESSTOLL`	كولورادو، الولايات المتحدة الأمريكية
`US_CO_GO_PASS`	كولورادو، الولايات المتحدة الأمريكية
`US_DE_EZPASSDE`	ألمانيا والولايات المتحدة
`US_FL_BOB_SIKES_TOLL_BRIDGE_PASS`	فلوريدا، الولايات المتحدة الأمريكية
`US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD`	فلوريدا، الولايات المتحدة الأمريكية
`US_FL_EPASS`	فلوريدا، الولايات المتحدة الأمريكية
`US_FL_GIBA_TOLL_PASS`	فلوريدا، الولايات المتحدة الأمريكية
`US_FL_LEEWAY`	فلوريدا، الولايات المتحدة الأمريكية
`US_FL_SUNPASS`	فلوريدا، الولايات المتحدة الأمريكية
`US_FL_SUNPASS_PRO`	فلوريدا، الولايات المتحدة الأمريكية
`US_IL_EZPASSIL`	إلينوي، الولايات المتحدة الأمريكية
`US_IL_IPASS`	إلينوي، الولايات المتحدة الأمريكية
`US_IN_EZPASSIN`	IN, USA.
`US_KS_BESTPASS_HORIZON`	كانساس، الولايات المتحدة الأمريكية
`US_KS_KTAG`	كانساس، الولايات المتحدة الأمريكية
`US_KS_NATIONALPASS`	كانساس، الولايات المتحدة الأمريكية
`US_KS_PREPASS_ELITEPASS`	كانساس، الولايات المتحدة الأمريكية
`US_KY_RIVERLINK`	كنتاكي، الولايات المتحدة الأمريكية
`US_LA_GEAUXPASS`	LA, USA.
`US_LA_TOLL_TAG`	LA, USA.
`US_MA_EZPASSMA`	ماساتشوستس، الولايات المتحدة الأمريكية
`US_MD_EZPASSMD`	ماريلاند، الولايات المتحدة الأمريكية
`US_ME_EZPASSME`	مين، الولايات المتحدة الأمريكية
`US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD`	ميشيغان، الولايات المتحدة الأمريكية
`US_MI_BCPASS`	ميشيغان، الولايات المتحدة الأمريكية
`US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG`	ميشيغان، الولايات المتحدة الأمريكية
`US_MI_IQ_PROX_CARD`	ميشيغان، الولايات المتحدة الأمريكية تم إيقاف هذا النوع من البطاقات نهائيًا. تم إيقاف هذا العنصر نهائيًا.
`US_MI_IQ_TAG`	ميشيغان، الولايات المتحدة الأمريكية
`US_MI_MACKINAC_BRIDGE_MAC_PASS`	ميشيغان، الولايات المتحدة الأمريكية
`US_MI_NEXPRESS_TOLL`	ميشيغان، الولايات المتحدة الأمريكية
`US_MN_EZPASSMN`	مينيسوتا، الولايات المتحدة الأمريكية
`US_NC_EZPASSNC`	كارولاينا الشمالية، الولايات المتحدة الأمريكية
`US_NC_PEACH_PASS`	كارولاينا الشمالية، الولايات المتحدة الأمريكية
`US_NC_QUICK_PASS`	كارولاينا الشمالية، الولايات المتحدة الأمريكية
`US_NH_EZPASSNH`	نيو هامبشير، الولايات المتحدة الأمريكية
`US_NJ_DOWNBEACH_EXPRESS_PASS`	نيوجيرسي، الولايات المتحدة الأمريكية
`US_NJ_EZPASSNJ`	نيوجيرسي، الولايات المتحدة الأمريكية
`US_NY_EXPRESSPASS`	نيويورك، الولايات المتحدة الأمريكية
`US_NY_EZPASSNY`	نيويورك، الولايات المتحدة الأمريكية
`US_OH_EZPASSOH`	أوهايو، الولايات المتحدة الأمريكية
`US_PA_EZPASSPA`	بنسلفانيا، الولايات المتحدة الأمريكية
`US_RI_EZPASSRI`	رود آيلاند، الولايات المتحدة
`US_SC_PALPASS`	كارولاينا الجنوبية، الولايات المتحدة الأمريكية
`US_TX_AVI_TAG`	تكساس، الولايات المتحدة الأمريكية
`US_TX_BANCPASS`	تكساس، الولايات المتحدة الأمريكية
`US_TX_DEL_RIO_PASS`	تكساس، الولايات المتحدة الأمريكية
`US_TX_EFAST_PASS`	تكساس، الولايات المتحدة الأمريكية
`US_TX_EAGLE_PASS_EXPRESS_CARD`	تكساس، الولايات المتحدة الأمريكية
`US_TX_EPTOLL`	تكساس، الولايات المتحدة الأمريكية
`US_TX_EZ_CROSS`	تكساس، الولايات المتحدة الأمريكية
`US_TX_EZTAG`	تكساس، الولايات المتحدة الأمريكية
`US_TX_FUEGO_TAG`	تكساس، الولايات المتحدة الأمريكية
`US_TX_LAREDO_TRADE_TAG`	تكساس، الولايات المتحدة الأمريكية
`US_TX_PLUSPASS`	تكساس، الولايات المتحدة الأمريكية
`US_TX_TOLLTAG`	تكساس، الولايات المتحدة الأمريكية
`US_TX_TXTAG`	تكساس، الولايات المتحدة الأمريكية
`US_TX_XPRESS_CARD`	تكساس، الولايات المتحدة الأمريكية
`US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD`	يوتا، الولايات المتحدة الأمريكية
`US_VA_EZPASSVA`	VA، الولايات المتحدة الأمريكية
`US_WA_BREEZEBY`	واشنطن، الولايات المتحدة الأمريكية
`US_WA_GOOD_TO_GO`	واشنطن، الولايات المتحدة الأمريكية
`US_WV_EZPASSWV`	WV, USA.
`US_WV_MEMORIAL_BRIDGE_TICKETS`	WV, USA.
`US_WV_MOV_PASS`	WV, USA
`US_WV_NEWELL_TOLL_BRIDGE_TICKET`	WV, USA.

الوحدات

مجموعة من القيم التي تحدّد وحدة القياس المستخدَمة في العرض.

عمليات التعداد
`UNITS_UNSPECIFIED`	لم يتم تحديد وحدات القياس. يتم ضبط القيمة التلقائية على وحدة القياس المستنتَجة من الطلب.
`METRIC`	وحدات القياس المترية
`IMPERIAL`	وحدات القياس الإنجليزية

VehicleEmissionType

مجموعة من القيم التي تصف نوع انبعاثات المركبة ينطبق ذلك على وضع السفر "بالسيارة" فقط.

عمليات التعداد
`VEHICLE_EMISSION_TYPE_UNSPECIFIED`	لم يتم تحديد نوع الانبعاثات. القيمة التلقائية هي GASOLINE.
`GASOLINE`	مركبة تعمل بالبنزين
`ELECTRIC`	مركبة تعمل بالكهرباء
`HYBRID`	مركبة تعمل بالوقود الهجين (مثل البنزين والكهرباء)

VehicleInfo

تتضمّن معلومات المركبة، مثل نوع انبعاثات المركبة.

الحقول

الحقول
`emission_type`	`VehicleEmissionType` تصف هذه السمة نوع الانبعاثات للمركبة. ينطبق ذلك على `DRIVE` `RouteTravelMode` فقط.

emission_type

VehicleEmissionType

تصف هذه السمة نوع الانبعاثات للمركبة. ينطبق ذلك على DRIVE RouteTravelMode فقط.

النقطة الوسيطة

تغليف نقطة طريق تحدّد نقاط الطريق بداية المسار ونهايته، وتشمل محطات التوقّف الوسيطة على طول المسار.

الحقول
`via`	`bool` تضع هذه السمة علامة على نقطة الطريق هذه للإشارة إلى أنّها معلم رئيسي وليس نقطة توقّف. بالنسبة إلى كل نقطة على المسار غير نقطة المرور في الطلب، يضيف الردّ إدخالاً إلى مصفوفة `legs` لتقديم تفاصيل عن محطات التوقف في هذا الجزء من الرحلة. اضبط هذه القيمة على "صحيح" عندما تريد أن يمر المسار بنقطة الطريق هذه بدون التوقف فيها. لا تؤدي نقاط المرور إلى إضافة إدخال إلى مصفوفة `legs`، ولكنّها توجّه الرحلة عبر نقطة المرور. يمكنك ضبط هذه القيمة فقط على نقاط الطريق التي تكون وسيطة. سيفشل الطلب إذا ضبطت هذا الحقل على نقاط الطريق النهائية. إذا تم ضبط `ComputeRoutesRequest.optimize_waypoint_order` على "صحيح"، لا يمكن ضبط هذا الحقل على "صحيح"، وإلا سيفشل الطلب.
`vehicle_stopover`	`bool` تشير إلى أنّ نقطة على المسار مخصّصة لتوقّف المركبات، حيث يكون الهدف إما استلام أو تسليم. عند ضبط هذه القيمة، لن يتضمّن المسار المحسوب نقاط على المسار غير `via` على الطرق غير المناسبة للاستلام والتسليم. لا يعمل هذا الخيار إلا مع وسيلتَي النقل `DRIVE` و`TWO_WHEELER`، وعندما تكون قيمة `location_type` هي `location`.
`side_of_road`	`bool` تشير إلى أنّ الموقع الجغرافي لنقطة على المسار هذه يهدف إلى أن تفضّل المركبة التوقف على جانب معيّن من الطريق. عند ضبط هذه القيمة، سيمر المسار بالموقع الجغرافي لكي تتمكّن المركبة من التوقف على جانب الطريق الذي يميل إليه الموقع الجغرافي من وسط الطريق. لا يعمل هذا الخيار إلا مع وسيلتَي النقل "القيادة" و"المركبة ذات العجلتين".
حقل الربط `location_type` طرق مختلفة لتمثيل موقع جغرافي يمكن أن يكون التعليق `location_type` إحدى القيم التالية فقط:
`location`	`Location` تمثّل هذه السمة نقطة محدّدة باستخدام الإحداثيات الجغرافية، بما في ذلك عنوان اختياري.
`place_id`	`string` تمثّل هذه السمة رقم تعريف المكان الخاص بنقطة الاهتمام المرتبط بنقطة على المسار.

Package google.maps.routes.v1 تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

الفهرس

RoutesPreferred

ComputeCustomRoutesRequest

ComputeCustomRoutesResponse

FallbackInfo

FallbackRouteObjective

ComputeRouteMatrixRequest

ComputeRoutesRequest

ComputeRoutesResponse

CustomRoute

FallbackInfo

FallbackReason

FallbackRoutingMode

الموقع الجغرافي

المناورة

NavigationInstruction

خط متعدد

PolylineEncoding

PolylineQuality

مسار

RouteLeg

RouteLegStep

RouteLegStepTravelAdvisory

RouteLegTravelAdvisory

RouteMatrixDestination

RouteMatrixElement

RouteMatrixElementCondition

RouteMatrixOrigin

RouteModifiers

RouteObjective

RateCard

MonetaryCost

RouteTravelAdvisory

RouteTravelMode

RoutingPreference

SpeedReadingInterval

السرعة

TollInfo

TollPass

الوحدات

VehicleEmissionType

VehicleInfo

النقطة الوسيطة

Package google.maps.routes.v1