Package google.maps.routing.v2

الفهرس

• Routes (واجهة)
• ComputeRouteMatrixRequest (رسالة)
• ComputeRouteMatrixRequest.ExtraComputation (تعداد)
• ComputeRoutesRequest (رسالة)
• ComputeRoutesRequest.ExtraComputation (تعداد)
• ComputeRoutesRequest.ReferenceRoute (تعداد)
• ComputeRoutesResponse (رسالة)
• FallbackInfo (رسالة)
• FallbackReason (تعداد)
• FallbackRoutingMode (تعداد)
• GeocodedWaypoint (رسالة)
• GeocodingResults (رسالة)
• LocalizedTime (رسالة)
• Location (رسالة)
• Maneuver (تعداد)
• NavigationInstruction (رسالة)
• Polyline (رسالة)
• PolylineDetails (رسالة)
• PolylineDetails.BridgeInfo (رسالة)
• PolylineDetails.FlyoverInfo (رسالة)
• PolylineDetails.NarrowRoadInfo (رسالة)
• PolylineDetails.PolylinePointIndex (رسالة)
• PolylineDetails.RestrictionInfo (رسالة)
• PolylineDetails.RoadFeatureState (تعداد)
• PolylineDetails.SkywayInfo (رسالة)
• PolylineDetails.TunnelInfo (رسالة)
• PolylineEncoding (تعداد)
• PolylineQuality (تعداد)
• Route (رسالة)
• Route.RouteLocalizedValues (رسالة)
• RouteLabel (تعداد)
• RouteLeg (رسالة)
• RouteLeg.RouteLegLocalizedValues (رسالة)
• RouteLeg.StepsOverview (رسالة)
• RouteLeg.StepsOverview.MultiModalSegment (رسالة)
• RouteLegStep (رسالة)
• RouteLegStep.RouteLegStepLocalizedValues (رسالة)
• RouteLegStepTransitDetails (رسالة)
• RouteLegStepTransitDetails.TransitDetailsLocalizedValues (رسالة)
• RouteLegStepTransitDetails.TransitStopDetails (رسالة)
• RouteLegStepTravelAdvisory (رسالة)
• RouteLegTravelAdvisory (رسالة)
• RouteMatrixDestination (رسالة)
• RouteMatrixElement (رسالة)
• RouteMatrixElement.LocalizedValues (رسالة)
• RouteMatrixElementCondition (تعداد)
• RouteMatrixOrigin (رسالة)
• RouteModifiers (رسالة)
• RouteTravelAdvisory (رسالة)
• RouteTravelMode (تعداد)
• RoutingPreference (تعداد)
• SpeedReadingInterval (رسالة)
• SpeedReadingInterval.Speed (تعداد)
• TollInfo (رسالة)
• TollPass (تعداد)
• TrafficModel (تعداد)
• TransitAgency (رسالة)
• TransitLine (رسالة)
• TransitPreferences (رسالة)
• TransitPreferences.TransitRoutingPreference (تعداد)
• TransitPreferences.TransitTravelMode (تعداد)
• TransitStop (رسالة)
• TransitVehicle (رسالة)
• TransitVehicle.TransitVehicleType (تعداد)
• Units (تعداد)
• VehicleEmissionType (تعداد)
• VehicleInfo (رسالة)
• VehicleInfo.HazardousGoodsType (تعداد)
• VehicleInfo.TrailerInfo (رسالة)
• Waypoint (رسالة)

المسارات

‫Routes API

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 على استخدام قناع حقل الردّ الخاص بأحرف البدل (*) للأسباب التالية: يساعد اختيار الحقول التي تحتاج إليها فقط خادمَنا في توفير دورات الحوسبة، ما يسمح لنا بعرض النتيجة لك بزمن استجابة أقل. يضمن اختيار الحقول التي تحتاج إليها فقط في مهمة الإنتاج تحقيق أداء مستقر من حيث وقت الاستجابة. قد نضيف المزيد من حقول الردود في المستقبل، وقد تتطلّب هذه الحقول الجديدة وقتًا إضافيًا للمعالجة. إذا اخترت جميع الحقول، أو إذا اخترت جميع الحقول على المستوى الأعلى، قد ينخفض الأداء لأنّ أي حقل جديد نضيفه سيتم تضمينه تلقائيًا في الردّ. يؤدي اختيار الحقول التي تحتاج إليها فقط إلى تقليل حجم الردّ، وبالتالي زيادة سرعة معالجة البيانات على الشبكة.

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)، وذلك للأسباب التالية: يساعد اختيار الحقول التي تحتاج إليها فقط خادمَنا في توفير دورات الحوسبة، ما يسمح لنا بعرض النتيجة لك بزمن استجابة أقل. يضمن اختيار الحقول التي تحتاج إليها فقط في مهمة الإنتاج تحقيق أداء مستقر من حيث وقت الاستجابة. قد نضيف المزيد من حقول الردود في المستقبل، وقد تتطلّب هذه الحقول الجديدة وقتًا إضافيًا للمعالجة. إذا اخترت جميع الحقول، أو إذا اخترت جميع الحقول على المستوى الأعلى، قد ينخفض الأداء لأنّ أي حقل جديد نضيفه سيتم تضمينه تلقائيًا في الردّ. يؤدي اختيار الحقول التي تحتاج إليها فقط إلى تقليل حجم الردّ، وبالتالي زيادة سرعة معالجة البيانات على الشبكة.

ComputeRouteMatrixRequest

رسالة طلب ComputeRouteMatrix

الحقول
origins[]	RouteMatrixOrigin الحقل مطلوب. مصفوفة المصادر التي تحدّد صفوف مصفوفة الردّ. تنطبق العديد من القيود على حجم عدد القيم الفريدة للمصادر والوجهات: يجب ألا يزيد مجموع عدد المصادر وعدد الوجهات المحدّدة على النحو place_id أو address عن 50. يجب ألا يزيد ناتج عدد نقاط البداية × عدد نقاط الوجهة عن 625 في أي حالة. يجب ألا يزيد ناتج عدد نقاط الأصل × عدد نقاط الوجهة عن 100 إذا تم ضبط routing_preference على TRAFFIC_AWARE_OPTIMAL. يجب ألا يزيد ناتج عدد نقاط البداية × عدد نقاط النهاية عن 100 إذا تم ضبط travel_mode على TRANSIT.
destinations[]	RouteMatrixDestination الحقل مطلوب. مصفوفة الوجهات التي تحدّد أعمدة مصفوفة الردّ.
travel_mode	RouteTravelMode اختيارية: تحدّد هذه السمة وسيلة النقل.
routing_preference	RoutingPreference اختيارية: تحدّد هذه السمة كيفية احتساب المسار. يحاول الخادم استخدام خيار التوجيه المفضّل المحدّد لاحتساب المسار. إذا أدّى خيار التوجيه إلى حدوث خطأ أو تأخير طويل جدًا، سيتم عرض رسالة خطأ. يمكنك تحديد هذا الخيار فقط عندما تكون قيمة travel_mode هي DRIVE أو TWO_WHEELER، وإلا سيفشل الطلب.
departure_time	Timestamp اختيارية: وقت المغادرة في حال عدم ضبط هذه القيمة، يتم ضبطها تلقائيًا على الوقت الذي أرسلت فيه الطلب. ملاحظة: يمكنك تحديد departure_time في الماضي فقط عندما يكون RouteTravelMode مضبوطًا على TRANSIT.
arrival_time	Timestamp اختيارية: وقت الوصول ملاحظة: لا يمكن ضبط هذا الخيار إلا عندما يكون RouteTravelMode مضبوطًا على TRANSIT. يمكنك تحديد departure_time أو arrival_time، ولكن ليس كليهما.
language_code	string اختيارية: رمز اللغة المستخدَمة وفق المعيار BCP-47، مثل "en-US" أو "sr-Latn" لمزيد من المعلومات، يُرجى الاطّلاع على معرّف اللغة Unicode. اطّلِع على اللغات المتاحة للحصول على قائمة باللغات المتاحة. عندما لا تقدّم هذه القيمة، يتم استنتاج لغة العرض من الموقع الجغرافي للمصدر الأول.
region_code	string اختيارية: رمز المنطقة، ويتم تحديده كقيمة مكوّنة من حرفَين ضمن ccTLD ("نطاق المستوى الأعلى"). لمزيد من المعلومات، يُرجى الاطّلاع على نطاقات المستوى الأعلى التي يتم ترميزها حسب البلد.
units	Units اختيارية: تحدّد هذه السمة وحدات القياس لحقول العرض.
extra_computations[]	ExtraComputation اختيارية: قائمة بعمليات حسابية إضافية يمكن استخدامها لإكمال الطلب. ملاحظة: قد تؤدي هذه العمليات الحسابية الإضافية إلى عرض حقول إضافية في الردّ. يجب أيضًا تحديد هذه الحقول الإضافية في قناع الحقل ليتم عرضها في الردّ.
traffic_model	TrafficModel اختيارية: تحدّد هذه السمة الافتراضات التي يجب استخدامها عند احتساب الوقت المستغرَق في الزيارات. يؤثّر هذا الإعداد في القيمة المعروضة في حقل المدة في RouteMatrixElement الذي يحتوي على الوقت المتوقّع في حركة المرور استنادًا إلى المتوسطات السابقة. لا تتوفّر ميزة TrafficModel إلا للطلبات التي تم ضبط RoutingPreference على TRAFFIC_AWARE_OPTIMAL وRouteTravelMode على DRIVE. يتم ضبط القيمة تلقائيًا على BEST_GUESS في حال طلب الزيارات وعدم تحديد TrafficModel.
transit_preferences	TransitPreferences اختيارية: تحدّد هذه السمة الإعدادات المفضّلة التي تؤثّر في المسار الذي يتم عرضه للمسارات من النوع TRANSIT. ملاحظة: لا يمكنك تحديد transit_preferences إلا عندما يكون RouteTravelMode مضبوطًا على TRANSIT.

ExtraComputation

عمليات حسابية إضافية يجب إجراؤها أثناء إكمال الطلب

عمليات التعداد
EXTRA_COMPUTATION_UNSPECIFIED	لم يتم الاستخدام. ولن يتم تنفيذ الطلبات التي تحتوي على هذه القيمة.
TOLLS	معلومات الرسوم الخاصة بعناصر المصفوفة.

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 اختيارية: وقت المغادرة في حال عدم ضبط هذه القيمة، يتم ضبطها تلقائيًا على الوقت الذي أرسلت فيه الطلب. ملاحظة: يمكنك تحديد departure_time في الماضي فقط عندما يكون RouteTravelMode مضبوطًا على TRANSIT. تتوفّر رحلات النقل العام لمدة تصل إلى 7 أيام في الماضي أو 100 يوم في المستقبل.
arrival_time	Timestamp اختيارية: وقت الوصول ملاحظة: يتم تجاهل هذا الحقل عندما تحدّد الطلبات قيمة RouteTravelMode غير TRANSIT. يمكنك تحديد departure_time أو arrival_time، ولكن ليس كليهما. تتوفّر رحلات النقل العام لمدة تصل إلى 7 أيام في الماضي أو 100 يوم في المستقبل.
compute_alternative_routes	bool اختيارية: تحدّد هذه السمة ما إذا كان سيتم احتساب المسارات البديلة بالإضافة إلى المسار. لا يتم عرض طرق بديلة للطلبات التي تتضمّن نقاط توقّف وسيطة.
route_modifiers	RouteModifiers اختيارية: مجموعة من الشروط التي يجب استيفاؤها وتؤثر في طريقة احتساب المسارات
language_code	string اختيارية: رمز اللغة المستخدَمة وفق المعيار BCP-47، مثل "en-US" أو "sr-Latn" لمزيد من المعلومات، يُرجى الاطّلاع على معرّف اللغة Unicode. اطّلِع على اللغات المتاحة للحصول على قائمة باللغات المتاحة. عندما لا تقدّم هذه القيمة، يتم استنتاج لغة العرض من الموقع الجغرافي لطلب المسار.
region_code	string اختيارية: رمز المنطقة، ويتم تحديده كقيمة مكوّنة من حرفَين ضمن ccTLD ("نطاق المستوى الأعلى"). لمزيد من المعلومات، يُرجى الاطّلاع على نطاقات المستوى الأعلى التي يتم ترميزها حسب البلد.
units	Units اختيارية: تحدّد هذه السمة وحدات القياس لحقول العرض. تشمل هذه الحقول الحقل instruction في NavigationInstruction. لا تتأثر وحدات القياس المستخدَمة للمسار والجزء والخطوة والمسافة والمدة بهذه القيمة. في حال عدم تقديم هذه القيمة، يتم استنتاج وحدات العرض من الموقع الجغرافي للمصدر الأول.
optimize_waypoint_order	bool اختيارية: إذا تم ضبطها على "صحيح"، تحاول الخدمة تقليل التكلفة الإجمالية للمسار من خلال إعادة ترتيب نقاط المرور الوسيطة المحدّدة. يتعذّر تنفيذ الطلب إذا كانت أي من نقاط الطريق الوسيطة هي نقطة طريق via. استخدِم ComputeRoutesResponse.routes.optimized_intermediate_waypoint_index للعثور على الترتيب الجديد. إذا لم يتم طلب ComputeRoutesResponse.routes.optimized_intermediate_waypoint_index في العنوان X-Goog-FieldMask، سيتعذّر تنفيذ الطلب. في حال ضبط optimize_waypoint_order على "خطأ"، سيكون ComputeRoutesResponse.optimized_intermediate_waypoint_index فارغًا.
requested_reference_routes[]	ReferenceRoute اختيارية: تحدّد هذه السمة مسارات المراجع التي سيتم احتسابها كجزء من الطلب بالإضافة إلى المسار التلقائي. المسار المرجعي هو مسار يختلف عن المسار التلقائي في الهدف من حساب المسار. على سبيل المثال، تأخذ عملية حساب FUEL_EFFICIENT مسار مرجعي في الاعتبار مَعلمات مختلفة من شأنها إنشاء مسار مثالي موفّر للوقود. عند استخدام هذه الميزة، ابحث عن route_labels في المسارات الناتجة.
extra_computations[]	ExtraComputation اختيارية: قائمة بعمليات حسابية إضافية يمكن استخدامها لإكمال الطلب. ملاحظة: قد تؤدي هذه العمليات الحسابية الإضافية إلى عرض حقول إضافية في الردّ. يجب أيضًا تحديد هذه الحقول الإضافية في قناع الحقل ليتم عرضها في الردّ.
traffic_model	TrafficModel اختيارية: تحدّد هذه السمة الافتراضات التي يجب استخدامها عند احتساب الوقت المستغرَق في الزيارات. يؤثّر هذا الإعداد في القيمة المعروضة في حقل المدة في Route وRouteLeg الذي يحتوي على الوقت المتوقّع في حركة المرور استنادًا إلى المتوسطات السابقة. لا تتوفّر ميزة TrafficModel إلا للطلبات التي تم ضبط RoutingPreference على TRAFFIC_AWARE_OPTIMAL وRouteTravelMode على DRIVE. يتم ضبط القيمة تلقائيًا على BEST_GUESS في حال طلب الزيارات وعدم تحديد TrafficModel.
transit_preferences	TransitPreferences اختيارية: تحدّد هذه السمة الإعدادات المفضّلة التي تؤثّر في المسار الذي يتم عرضه للمسارات من النوع TRANSIT. ملاحظة: لا يمكنك تحديد transit_preferences إلا عندما يكون RouteTravelMode مضبوطًا على TRANSIT.

ExtraComputation

عمليات حسابية إضافية يجب إجراؤها أثناء إكمال الطلب قد تتم إضافة قيم إضافية في المستقبل.

عمليات التعداد
EXTRA_COMPUTATION_UNSPECIFIED	لم يتم الاستخدام. ولن يتم تنفيذ الطلبات التي تحتوي على هذه القيمة.
TOLLS	معلومات رسوم المرور للمسارات
FUEL_CONSUMPTION	استهلاك الوقود المقدَّر للمسارات
TRAFFIC_ON_POLYLINE	خطوط متعددة الأضلاع تراعي حركة المرور للمسارات
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS	NavigationInstruction معروضة كسلسلة نصية منسَّقة بتنسيق HTML. يجب قراءة هذا المحتوى كما هو، وهو مخصّص للعرض فقط. يجب عدم تحليلها آليًا.
FLYOVER_INFO_ON_POLYLINE	معلومات عن المشاهدة الجوية للمسارات يجب تحديد routes.polyline_details.flyover_info fieldmask لعرض هذه المعلومات. في الوقت الحالي، لن يتم ملء هذه البيانات إلا لبعض المناطق المركزية في الهند. هذه الميزة تجريبية، وقد يتغيّر رمز التخزين التعريفي/الرسوم.
NARROW_ROAD_INFO_ON_POLYLINE	معلومات عن الطرق الضيقة للمسارات يجب تحديد routes.polyline_details.narrow_road_info fieldmask لعرض هذه المعلومات. في الوقت الحالي، لن يتم ملء هذه البيانات إلا لبعض المناطق المركزية في الهند. هذه الميزة تجريبية، وقد يتغيّر رمز التخزين التعريفي/الرسوم.
TUNNEL_INFO_ON_POLYLINE	تعرض هذه السمة معلومات عن الأنفاق في المسارات. يجب تحديد routes.polyline_details.tunnel_info fieldmask لعرض هذه المعلومات.
BRIDGE_INFO_ON_POLYLINE	معلومات الجسر للمسارات. يجب تحديد routes.polyline_details.bridge_info fieldmask لعرض هذه المعلومات.
SKYWAY_INFO_ON_POLYLINE	معلومات حول الجسور الجوية للمسارات يجب تحديد routes.polyline_details.skyway_info fieldmask لعرض هذه المعلومات.

ReferenceRoute

مسار مرجعي متوافق في ComputeRoutesRequest

عمليات التعداد
REFERENCE_ROUTE_UNSPECIFIED	لم يتم الاستخدام. لن يتم تنفيذ الطلبات التي تحتوي على هذه القيمة.
FUEL_EFFICIENT	المسار الأقل استهلاكًا للوقود
SHORTER_DISTANCE	المسار الذي يتضمّن مسافة سفر أقصر هذه ميزة تجريبية. بالنسبة إلى طلبات DRIVE، تعطي هذه الميزة الأولوية للمسافة الأقصر على حساب راحة القيادة. على سبيل المثال، قد يفضّل الطرق المحلية بدلاً من الطرق السريعة، أو يسلك طرقًا ترابية، أو يمرّ عبر مواقف السيارات، وما إلى ذلك. ولا تعرض هذه الميزة أي مناورات تعرف "خرائط Google" أنّها غير قانونية. بالنسبة إلى طلبات BICYCLE وTWO_WHEELER، تعرض هذه الميزة طرقًا مشابهة لتلك التي يتم عرضها عند عدم تحديد requested_reference_routes. لا تتوافق هذه الميزة مع أي وسائل نقل أخرى أو نقاط توقّف وسيطة أو optimize_waypoint_order، وستتعذّر معالجة هذه الطلبات. ومع ذلك، يمكنك استخدامه مع أي routing_preference.

ComputeRoutesResponse

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

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

FallbackInfo

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

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

FallbackReason

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

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

FallbackRoutingMode

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

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

GeocodedWaypoint

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

الحقول
geocoder_status	Status تشير إلى رمز الحالة الناتج من عملية الترميز الجغرافي.
type[]	string أنواع النتيجة، في شكل علامات نوع واحدة أو أكثر الأنواع المتوافقة: أنواع العناوين وأنواع مكوّنات العناوين
partial_match	bool تشير إلى أنّ أداة الترميز الجغرافي لم تعرض تطابقًا تامًا مع الطلب الأصلي، على الرغم من أنّها تمكّنت من مطابقة جزء من العنوان المطلوب. ننصحك بمراجعة الطلب الأصلي للتأكّد من عدم وجود أخطاء إملائية و/أو عنوان غير مكتمل.
place_id	string تمثّل هذه السمة رقم تعريف المكان الخاص بهذه النتيجة.
intermediate_waypoint_request_index	int32 فهرس نقطة الطريق الوسيطة المقابلة في الطلب لا تتم تعبئة هذا الحقل إلا إذا كانت نقطة الطريق المقابلة هي نقطة طريق وسيطة.

GeocodingResults

يحتوي على GeocodedWaypoints لنقطة الانطلاق والوجهة ونقاط المرور الوسيطة. تتم تعبئة هذا الحقل لنقاط الطريق التي تتضمّن عناوين فقط.

الحقول
origin	GeocodedWaypoint نقطة على المسار مرمزة جغرافيًا للمصدر
destination	GeocodedWaypoint نقطة على المسار تم ترميزها جغرافيًا للوجهة
intermediates[]	GeocodedWaypoint قائمة بنقاط الطريق الوسيطة التي تم ترميزها جغرافيًا، ويحتوي كل منها على حقل فهرس يتوافق مع الموضع المستند إلى الصفر لنقطة الطريق في الترتيب الذي تم تحديده في الطلب.

LocalizedTime

وصف مترجَم للوقت

الحقول
time	LocalizedText الوقت المحدّد كسلسلة في منطقة زمنية معيّنة
time_zone	string تحتوي هذه السمة على المنطقة الزمنية. القيمة هي اسم المنطقة الزمنية كما هو محدّد في قاعدة بيانات المناطق الزمنية الصادرة عن هيئة أرقام الإنترنت المخصّصة (IANA)، مثل "America/New_York".

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

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

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

المناورة

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

عمليات التعداد
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

تتضمّن هذه السمة تعليمات التنقّل الخاصة بـ RouteLegStep.

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

خط متعدد

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

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

PolylineDetails

تفاصيل تتوافق مع فهرس أو جزء متجاور معيّن من خط متعدد الأضلاع بمعلومية خط متعدد الأضلاع يتضمّن النقاط P_0 وP_1 و... وP_N (فهرس يبدأ من الصفر)، يحدّد PolylineDetails فترة زمنية وبيانات وصفية مرتبطة بها.

الحقول
tunnel_info[]	TunnelInfo تفاصيل الأنفاق على طول الخط المتعدد يتم ملء هذا الحقل إذا كان الطلب يحدّد معدِّل المسار avoid_tunnels ولم يتمكّن المسار الناتج من تجنُّبها، أو إذا تم تحديد TUNNEL_INFO_ON_POLYLINE في extra_computations وكان المسار يتضمّن أنفاقًا.
restriction_info[]	RestrictionInfo تفاصيل القيود على طول الخط المتعدد لا تتم تعبئة هذا الحقل إلا إذا كان الطلب يحدّد معدِّل المسار vehicle_info وكان المسار الناتج يتضمّن قيودًا سارية. وفي ما عدا ذلك، لا يتم استخدام هذا الحقل.
flyover_info[]	FlyoverInfo تفاصيل التحليق فوق المسار المتعدد الأضلاع
narrow_road_info[]	NarrowRoadInfo تفاصيل الطريق الضيق على طول الخط المتعدد الأضلاع
bridge_info[]	BridgeInfo تفاصيل الجسر على طول الخط المتعدد
skyway_info[]	SkywayInfo تفاصيل الطريق السريع على طول الخط المتعدد الأضلاع

BridgeInfo

تتضمّن هذه السمة معلومات عن الجسور على طول الخط المتعدد.

الحقول
bridge_presence	RoadFeatureState تشير إلى ما إذا كان هناك جسر في جزء معيّن من الخط المتعدد الأضلاع.
polyline_point_index	PolylinePointIndex موقع المعلومات ذات الصلة بالجسر على طول الخط المتعدد

FlyoverInfo

تغليف المعلومات حول التحليقات فوق خطوط متعددة الأضلاع

الحقول
flyover_presence	RoadFeatureState النتائج فقط. تشير إلى ما إذا كان هناك تحليق جوي لجزء معيّن من الخط المتعدد الأضلاع.
polyline_point_index	PolylinePointIndex تمثّل هذه السمة موقع المعلومات ذات الصلة بالتحليق فوق المنطقة على طول الخط المتعدد الأضلاع.

NarrowRoadInfo

تتضمّن هذه السمة معلومات عن الطرق الضيقة على طول الخط المتعدد الأضلاع.

الحقول
narrow_road_presence	RoadFeatureState النتائج فقط. تحدّد هذه السمة ما إذا كانت هناك طريق ضيقة في جزء معيّن من الخط المتعدد الأضلاع.
polyline_point_index	PolylinePointIndex تمثّل هذه السمة موقع المعلومات ذات الصلة بالطرق الضيقة على طول الخط المتعدد.

PolylinePointIndex

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

الحقول
start_index	int32 فهرس بدء هذه التفاصيل في الخط المتعدد الأضلاع
end_index	int32 الفهرس النهائي لهذه التفاصيل في الخط المتعدد الأضلاع.

RestrictionInfo

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

الحقول
restriction_presence	RoadFeatureState النتائج فقط. تشير إلى ما إذا كان هناك قيود على جزء معيّن من الخط المتعدد الأضلاع.
polyline_point_index	PolylinePointIndex تمثّل هذه السمة الموقع الجغرافي للمعلومات ذات الصلة بالقيود على طول الخط المتعدد الأضلاع.
حقل الربط restriction تتضمّن هذه السمة أنواع القيود التي يمكن تطبيقها على جزء معيّن من الخط المتعدد الأضلاع. يمكن أن يكون التعليق restriction إحدى القيم التالية فقط:
restricted_height_mm	int64 تمثّل هذه السمة الحد الأقصى للارتفاع بالملليمتر. يتم ملء هذا الحقل عندما يمنع الارتفاع المحظور المرور أو يؤدي إلى خلوص منخفض للمركبة المحددة.
restricted_weight_kg	int64 الحدّ الأقصى للوزن بالكيلوغرام يتم ملء هذا الحقل عندما يمنع قيد الوزن المرور أو يكون قريبًا من وزن المركبة المحدّدة.
hazardous_goods	bool يتم ضبط هذا الحقل على "صحيح" عندما تكون هناك قيود على نقل السلع الخطرة.
trucks_prohibited	bool يتم ضبط هذا الحقل على "صحيح" عندما تكون الشاحنات محظورة.

RoadFeatureState

تغليف حالات ميزات الطرق على طول جزء من خط متعدد

عمليات التعداد
ROAD_FEATURE_STATE_UNSPECIFIED	لم يتم احتساب حالة ميزة الطريق (القيمة التلقائية).
EXISTS	تتوفّر ميزة الطريق.
DOES_NOT_EXIST	ميزة الطريق غير متوفّرة.

SkywayInfo

تتضمّن هذه السمة معلومات عن الطرق السريعة على طول الخط المتعدد الأضلاع.

الحقول
skyway_presence	RoadFeatureState تشير إلى ما إذا كان هناك جسر علوي لجزء معيّن من الخط المتعدد الأضلاع.
polyline_point_index	PolylinePointIndex تمثّل هذه السمة الموقع الجغرافي للمعلومات ذات الصلة بالجسر العلوي على طول الخط المتعدد الأضلاع.

TunnelInfo

تتضمّن هذه السمة معلومات عن الأنفاق على طول الخط المتعدد الأضلاع.

الحقول
tunnel_presence	RoadFeatureState تشير إلى ما إذا كان هناك نفق لجزء معيّن من الخط المتعدد الأضلاع.
polyline_point_index	PolylinePointIndex موقع المعلومات المتعلّقة بالنفق على طول الخط المتعدد

PolylineEncoding

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

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

PolylineQuality

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

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

مسار

يحتوي على مسار يتألف من سلسلة من مقاطع الطرق المتصلة التي تربط بين نقاط الطريق في البداية والنهاية والمنتصف.

الحقول
route_labels[]	RouteLabel تصنيفات Route مفيدة لتحديد خصائص معيّنة للمسار من أجل مقارنتها بمسارات أخرى.
legs[]	RouteLeg مجموعة من الأجزاء (أجزاء المسار بين نقاط المرور) التي تشكّل المسار. يتوافق كل جزء مع الرحلة بين نقطتَي via Waypoints. على سبيل المثال، يتضمّن المسار الذي لا يحتوي على نقاط طريق وسيطة مرحلة واحدة فقط. يتضمّن المسار الذي يتضمّن نقطة على المسار وسيطة واحدة غير 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 في حال ضبط optimize_waypoint_order على "صحيح"، يحتوي هذا الحقل على الترتيب المحسّن لنقاط المرور الوسيطة. وفي ما عدا ذلك، يكون هذا الحقل فارغًا. على سبيل المثال، إذا أدخلت "نقطة الانطلاق: لوس أنجلوس" و"نقاط التوقف الوسيطة: دالاس، بانغور، فينيكس" و"نقطة الوصول: نيويورك" وكان ترتيب نقاط التوقف الوسيطة المحسّن هو "فينيكس، دالاس، بانغور"، سيحتوي هذا الحقل على القيم [2, 0, 1]. يبدأ الفهرس بالرقم 0 لنقطة الطريق الوسيطة الأولى المقدَّمة في الإدخال.
localized_values	RouteLocalizedValues تمثيلات نصية لسمات Route
route_token	string رمز مميّز غير شفاف يمكن تمريره إلى Navigation SDK لإعادة إنشاء المسار أثناء التنقّل، وفي حال إعادة التوجيه، يتم الالتزام بالنية الأصلية عند إنشاء المسار. يجب التعامل مع هذا الرمز المميز على أنّه كائن ثنائي كبير مبهم. لا تقارِن قيمته بين الطلبات لأنّها قد تتغيّر حتى إذا كانت الخدمة تعرض المسار نفسه بالضبط. ملاحظة: لا تتوفّر Route.route_token إلا للطلبات التي تم ضبط ComputeRoutesRequest.routing_preference فيها على TRAFFIC_AWARE أو TRAFFIC_AWARE_OPTIMAL. لا تتوافق Route.route_token مع الطلبات التي تتضمّن نقاط توقّف.
polyline_details	PolylineDetails تحتوي على معلومات حول التفاصيل على طول الخط المتعدد.

RouteLocalizedValues

تمثّل هذه السمة السمات النصية لبعض الخصائص.

الحقول
distance	LocalizedText المسافة المقطوعة ممثّلة في شكل نص.
duration	LocalizedText تمثّل هذه السمة المدة في شكل نصي ومعدَّلة بما يتناسب مع المنطقة التي تم فيها طلب البحث. تأخذ أحوال حركة المرور في الاعتبار. ملاحظة: إذا لم تطلب معلومات حول حركة المرور، ستكون هذه القيمة هي نفسها قيمة static_duration.
static_duration	LocalizedText المدة بدون أخذ أحوال حركة المرور في الاعتبار، ويتم عرضها في شكل نص.
transit_fare	LocalizedText تعرض هذه البطاقة أجرة النقل العام في شكل نص.

RouteLabel

تصنيفات Route مفيدة لتحديد خصائص معيّنة للمسار من أجل مقارنتها بمسارات أخرى.

عمليات التعداد
ROUTE_LABEL_UNSPECIFIED	تلقائي - غير مستخدَم
DEFAULT_ROUTE	المسار "الأفضل" التلقائي الذي تم عرضه عند احتساب المسار
DEFAULT_ROUTE_ALTERNATE	مسار بديل للمسار "الأفضل" التلقائي سيتم عرض مسارات مشابهة عند تحديد compute_alternative_routes.
FUEL_EFFICIENT	المسار الأقل استهلاكًا للوقود يتم تحديد المسارات المصنّفة بهذه القيمة على أنّها محسّنة لمَعلمات الوضع الاقتصادي، مثل استهلاك الوقود.
SHORTER_DISTANCE	مسار أقصر من حيث مسافة السفر هذه ميزة تجريبية.

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 يحتوي على المعلومات الإضافية التي يجب إبلاغ المستخدم بها، مثل القيود المحتملة على منطقة الزيارات، في جزء من المسار.
localized_values	RouteLegLocalizedValues تمثيلات نصية لسمات RouteLeg
steps_overview	StepsOverview معلومات عامة حول الخطوات الواردة في RouteLeg هذا لا تتم تعبئة هذا الحقل إلا لمسارات النقل العام.

RouteLegLocalizedValues

تمثّل هذه السمة السمات النصية لبعض الخصائص.

الحقول
distance	LocalizedText المسافة المقطوعة ممثّلة في شكل نص.
duration	LocalizedText تمثّل هذه السمة المدة في شكل نصي ومعدَّلة بما يتناسب مع المنطقة التي تم فيها طلب البحث. تأخذ أحوال حركة المرور في الاعتبار. ملاحظة: إذا لم تطلب معلومات حول حركة المرور، ستكون هذه القيمة هي القيمة نفسها التي تمثّلها static_duration.
static_duration	LocalizedText المدة بدون أخذ أحوال حركة المرور في الاعتبار، ويتم عرضها في شكل نص.

StepsOverview

تقدّم هذه السمة معلومات عامة عن قائمة RouteLegStep.

الحقول
multi_modal_segments[]	MultiModalSegment معلومات موجزة حول الأقسام المختلفة المتعدّدة الوسائط في RouteLeg.steps لا تتم تعبئة هذا الحقل إذا لم تتضمّن RouteLeg أي مقاطع متعددة الوسائط في الخطوات.

MultiModalSegment

تقدّم هذه السمة معلومات موجزة عن شرائح RouteLeg.steps المختلفة المتعددة الوسائط. يتم تعريف المقطع المتعدد الوسائط على أنّه واحد أو أكثر من RouteLegStep المتجاورة التي لها RouteTravelMode نفسه. لا تتم تعبئة هذا الحقل إذا لم تتضمّن RouteLeg أي مقاطع متعددة الوسائط في الخطوات.

الحقول
navigation_instruction	NavigationInstruction NavigationInstruction للجزء المتعدّد الوسائط
travel_mode	RouteTravelMode وسيلة النقل المستخدَمة في الجزء المتعدد الوسائط
step_start_index	int32 فهرس RouteLegStep المقابل الذي يمثّل بداية مقطع متعدد الوسائط.
step_end_index	int32 فهرس RouteLegStep المقابل الذي يمثّل نهاية مقطع متعدد الوسائط.

RouteLegStep

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

الحقول
distance_meters	int32 تمثّل هذه السمة مسافة التنقّل لهذه الخطوة بالمتر. في بعض الحالات، قد لا يتضمّن هذا الحقل قيمة.
static_duration	Duration مدة التنقّل خلال هذه الخطوة بدون أخذ حالة حركة المرور في الاعتبار في بعض الحالات، قد لا يتضمّن هذا الحقل قيمة.
polyline	Polyline تمثّل هذه السمة الخط المتعدد الأضلاع المرتبط بهذه الخطوة.
start_location	Location تمثّل هذه السمة الموقع الجغرافي لنقطة البداية لهذه الخطوة.
end_location	Location الموقع الجغرافي النهائي لهذه الخطوة
navigation_instruction	NavigationInstruction تعليمات التنقّل
travel_advisory	RouteLegStepTravelAdvisory يحتوي على المعلومات الإضافية التي يجب إبلاغ المستخدم بها، مثل القيود المحتملة على منطقة حركة المرور، في خطوة جزء الرحلة.
localized_values	RouteLegStepLocalizedValues تمثيلات نصية لسمات RouteLegStep
transit_details	RouteLegStepTransitDetails تفاصيل متعلقة بهذه الخطوة إذا كان وضع التنقّل هو TRANSIT
travel_mode	RouteTravelMode تمثّل هذه السمة وسيلة النقل المستخدَمة في هذه الخطوة.

RouteLegStepLocalizedValues

تمثّل هذه السمة السمات النصية لبعض الخصائص.

الحقول
distance	LocalizedText المسافة المقطوعة ممثّلة في شكل نص.
static_duration	LocalizedText المدة بدون أخذ أحوال حركة المرور في الاعتبار، ويتم عرضها في شكل نص.

RouteLegStepTransitDetails

معلومات إضافية عن RouteLegStep ذات صلة بمسارات TRANSIT

الحقول
stop_details	TransitStopDetails معلومات حول محطات الوصول والمغادرة للخطوة
localized_values	TransitDetailsLocalizedValues تمثيلات نصية لسمات RouteLegStepTransitDetails
headsign	string تحدّد هذه السمة اتجاه التنقّل على هذا الخط كما هو موضّح على المركبة أو في محطة المغادرة. ويكون الاتجاه غالبًا هو محطة الوصول.
headway	Duration تحدّد هذه السمة الوقت المتوقّع كمدة زمنية بين عمليات المغادرة من المحطة نفسها في هذا الوقت. على سبيل المثال، إذا كانت قيمة ثواني الفاصل الزمني 600، من المتوقّع أن تنتظر عشر دقائق إذا فاتتك الحافلة.
transit_line	TransitLine معلومات حول خط النقل العام المستخدَم في هذه الخطوة
stop_count	int32 عدد المحطات من محطة المغادرة إلى محطة الوصول يشمل هذا العدد محطة الوصول، ولكن لا يشمل محطة المغادرة. على سبيل المثال، إذا كان مسارك يبدأ من المحطة A ويمر بالمحطتين B وC ويصل إلى المحطة D، ستعرض stop_count القيمة 3.
trip_short_text	string النص الذي يظهر في الجداول الزمنية ولوحات الإشارات لتحديد رحلة النقل العام للركاب يجب أن يحدّد النص رحلة بشكل فريد خلال يوم الخدمة. على سبيل المثال، "538" هو trip_short_text لقطار Amtrak الذي يغادر سان خوسيه، كاليفورنيا في الساعة 15:10 في أيام الأسبوع إلى ساكرامنتو، كاليفورنيا.

TransitDetailsLocalizedValues

أوصاف مترجَمة للقيم في RouteTransitDetails

الحقول
arrival_time	LocalizedTime الوقت في تمثيله النصي المنسّق مع منطقة زمنية مقابلة
departure_time	LocalizedTime الوقت في تمثيله النصي المنسّق مع منطقة زمنية مقابلة

TransitStopDetails

تعرض هذه السمة تفاصيل حول محطات النقل العام في RouteLegStep.

الحقول
arrival_stop	TransitStop معلومات حول محطة الوصول الخاصة بالخطوة
arrival_time	Timestamp الوقت المقدَّر للوصول إلى الخطوة
departure_stop	TransitStop تمثّل هذه السمة معلومات حول محطة المغادرة للخطوة.
departure_time	Timestamp الوقت المقدَّر للمغادرة في هذه الخطوة

RouteLegStepTravelAdvisory

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

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

RouteLegTravelAdvisory

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

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

RouteMatrixDestination

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

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

RouteMatrixElement

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

الحقول
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 في بعض الحالات التي لا يمكن فيها للخادم احتساب المسار باستخدام الإعدادات المفضّلة المحدّدة لزوج نقطة الانطلاق/نقطة الوصول هذا، قد يعود إلى استخدام طريقة احتساب مختلفة. عند استخدام وضع التراجع، يحتوي هذا الحقل على معلومات مفصّلة حول الردّ الاحتياطي. وفي ما عدا ذلك، يكون هذا الحقل غير مضبوط.
localized_values	LocalizedValues تمثيلات نصية لسمات RouteMatrixElement
origin_index	int32 فهرس مستند إلى الصفر للمصدر في الطلب
destination_index	int32 فهرس الوجهة المستند إلى الصفر في الطلب

LocalizedValues

تمثّل هذه السمة السمات النصية لبعض الخصائص.

الحقول
distance	LocalizedText المسافة المقطوعة ممثّلة في شكل نص.
duration	LocalizedText المدة ممثّلة في شكل نصي مع أخذ أحوال حركة المرور في الاعتبار ملاحظة: إذا لم يتم طلب معلومات حول حركة المرور، ستكون هذه القيمة هي القيمة نفسها التي تم ضبطها في static_duration.
static_duration	LocalizedText المدة ممثّلة في شكل نصي بدون أخذ حالة حركة المرور في الاعتبار.
transit_fare	LocalizedText تعرض هذه البطاقة أجرة النقل العام في شكل نص.

RouteMatrixElementCondition

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

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

RouteMatrixOrigin

مصدر واحد لـ ComputeRouteMatrixRequest

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

RouteModifiers

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

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

RouteTravelAdvisory

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

الحقول
toll_info	TollInfo تحتوي هذه السمة على معلومات حول رسوم المرور على طول المسار. لا تتم تعبئة هذا الحقل إلا إذا كان من المتوقّع فرض رسوم على الطريق وتم تضمين TOLLS في ComputeRoutesRequest.extra_computations للطلب. في حال ضبط هذا الحقل، ولكن لم تتم تعبئة الحقل الفرعي estimatedPrice، يعني ذلك أنّ المسار يتضمّن رسومًا، ولكن السعر المقدّر غير معروف. إذا لم يتم ضبط toll_info، يعني ذلك أنّه لا يُتوقّع فرض رسوم على الطريق.
speed_reading_intervals[]	SpeedReadingInterval فواصل القراءة السريعة التي تشير إلى كثافة حركة المرور لا تتم تعبئة هذا الحقل إلا للطلبات التي تتضمّن القيمة TRAFFIC_AWARE أو TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference، ويتم تضمين TRAFFIC_ON_POLYLINE في ComputeRoutesRequest.extra_computations. تغطّي الفواصل الزمنية خطوطًا متعددة الأضلاع للمسار بالكامل بدون تداخل. تكون نقطة بداية فاصل زمني محدّد هي نفسها نقطة نهاية الفاصل الزمني السابق. مثال: polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).
fuel_consumption_microliters	int64 استهلاك الوقود المتوقّع بالميكرولتر لا يتم ملء هذا الحقل إلا عند تضمين FUEL_CONSUMPTION في ComputeRoutesRequest.extra_computations للطلب.
route_restrictions_partially_ignored	bool قد يتضمّن المسار الذي تم عرضه قيودًا لا تتناسب مع طريقة التنقّل أو معدّلات المسار المطلوبة.
transit_fare	Money في حال توفّره، يحتوي على إجمالي تكاليف الأجرة أو التذاكر على هذا المسار. يتم عرض هذه السمة فقط لطلبات TRANSIT وفقط للمسارات التي تتوفّر فيها معلومات الأجرة لجميع خطوات النقل العام.

RouteTravelMode

مجموعة من القيم تُستخدَم لتحديد وسيلة النقل. ملاحظة: إنّ المسارات WALK وBICYCLE وTWO_WHEELER هي في مرحلة الإصدار التجريبي وقد لا تتضمّن أحيانًا أرصفة واضحة أو مسارات للمشاة أو مسارات لركوب الدراجات. يجب عرض هذا التحذير للمستخدم على جميع مسارات المشي وركوب الدراجات والمسارات ذات العجلتين التي تعرضها في تطبيقك.

عمليات التعداد
TRAVEL_MODE_UNSPECIFIED	لم يتم تحديد وسيلة النقل. القيمة التلقائية هي DRIVE.
DRIVE	التنقّل بسيارة ركاب
BICYCLE	التنقّل بالدراجة
WALK	التنقّل سيرًا على الأقدام
TWO_WHEELER	مركبة ذات عجلتين ومزوّدة بمحرّك على سبيل المثال، دراجة نارية. يُرجى العلم أنّ هذا يختلف عن BICYCLE وسيلة النقل التي تغطي الوسائل التي تعمل بالطاقة البشرية.
TRUCK	شاحنة، والتي قد تخضع لقيود تنظيمية أو مادية يجب ملء سمات المركبة في الرسالة VehicleInfo.
TRANSIT	التنقّل باستخدام مسارات النقل العام، حيثما توفّرت

RoutingPreference

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

عمليات التعداد
ROUTING_PREFERENCE_UNSPECIFIED	لم يتم تحديد أي إعدادات مفضّلة للتوجيه. القيمة التلقائية هي TRAFFIC_UNAWARE.
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 فهرس بداية هذا الفاصل الزمني في الخط المتعدد الأضلاع
end_polyline_point_index	int32 فهرس نهاية هذا الفاصل الزمني في الخط المتعدد الأضلاع
حقل الربط speed_type نوع السرعة في هذه الفترة. يمكن أن يكون التعليق speed_type إحدى القيم التالية فقط:
speed	Speed تمثّل هذه السمة سرعة حركة المرور في هذه الفترة.

السرعة

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

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

TollInfo

تغليف معلومات رسوم المرور على 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_BREAKAWAY	ميشيغان، الولايات المتحدة الأمريكية
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.

TrafficModel

يحدّد هذا الحقل أحد الافتراضات التالية التي يجب استخدامها عند احتساب مدة الرحلة في أحوال حركة المرور، كما هو موضّح في القيم الثابتة أدناه. استنادًا إلى قيمة التعداد التي تم اختيارها، سيختلف الحقل duration في ردّ TrafficModel. تحتوي القيمة على الوقت المتوقّع للوصول إلى الوجهة في حركة المرور، استنادًا إلى المتوسطات السابقة. لا تتوفّر ميزة TrafficModel إلا للطلبات التي تم ضبط RoutingPreference على TRAFFIC_AWARE_OPTIMAL وRouteTravelMode على DRIVE.

عمليات التعداد
TRAFFIC_MODEL_UNSPECIFIED	غير مستخدَمة في حال تحديدها، سيتم ضبط القيمة التلقائية على BEST_GUESS.
BEST_GUESS	تشير إلى أنّ duration المعروض يجب أن يكون أفضل تقدير لمدة الرحلة استنادًا إلى المعلومات المتوفّرة عن كلّ من أحوال حركة المرور السابقة وحركة المرور المباشرة. تزداد أهمية بيانات حركة المرور المباشرة كلما اقترب departure_time من الوقت الحالي.
PESSIMISTIC	تشير إلى أنّ المدة المرتجَعة يجب أن تكون أطول من مدة الرحلة الفعلية في معظم الأيام، على الرغم من أنّ بعض الأيام التي تشهد أحوال حركة مرور سيئة بشكل خاص قد تتجاوز هذه القيمة.
OPTIMISTIC	تشير إلى أنّ المدة المعروضة يجب أن تكون أقصر من مدة الرحلة الفعلية في معظم الأيام، على الرغم من أنّ بعض الأيام التي تكون فيها أحوال حركة المرور جيدة بشكل خاص قد تكون أسرع من هذه القيمة.

TransitAgency

مؤسسة نقل عام تشغّل خط نقل عام

الحقول
name	string تمثّل هذه السمة اسم مؤسسة النقل العام.
phone_number	string رقم الهاتف المنسّق الخاص بمؤسسة النقل العام بما يتوافق مع اللغة المحلية.
uri	string معرّف الموارد المنتظم (URI) لمؤسسة النقل العام

TransitLine

يحتوي على معلومات حول خط النقل العام المستخدَم في هذه الخطوة.

الحقول
agencies[]	TransitAgency مؤسسة (أو مؤسسات) النقل العام التي تشغّل خط النقل العام هذا
name	string الاسم الكامل لخط النقل العام هذا، مثل "الخط المحلي على الجادة 8"
uri	string تمثّل هذه السمة المعرّف الموحّد للموارد (URI) لخط النقل العام هذا كما تقدّمه مؤسسة النقل العام.
color	string اللون المستخدَم عادةً في اللوحات الإرشادية لهذا الخط يتم تمثيله بنظام العد الستة عشري.
icon_uri	string تمثّل هذه السمة معرّف URI للرمز المرتبط بهذا السطر.
name_short	string الاسم المختصر لخط النقل العام هذا. سيكون هذا الاسم عادةً رقم خط، مثل "M7" أو "355".
text_color	string اللون المستخدَم عادةً في النص على اللافتات الخاصة بهذا الخط يتم تمثيله بنظام العد الستة عشري.
vehicle	TransitVehicle تمثّل هذه السمة نوع المركبة التي تعمل على خط النقل العام هذا.

TransitPreferences

الإعدادات المفضّلة للمسارات المستندة إلى TRANSIT والتي تؤثّر في المسار الذي يتم عرضه

الحقول
allowed_travel_modes[]	TransitTravelMode مجموعة من وسائل النقل التي يمكن استخدامها عند الحصول على TRANSIT مسار تكون القيمة التلقائية هي جميع وسائل النقل المتوافقة.
routing_preference	TransitRoutingPreference إعداد مفضّل للمسار يؤثر في المسار TRANSIT الذي يتم عرضه عند تحديده.

TransitRoutingPreference

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

عمليات التعداد
TRANSIT_ROUTING_PREFERENCE_UNSPECIFIED	لم يتم تحديد أي إعدادات مفضَّلة.
LESS_WALKING	تشير إلى أنّ المسار المحسوب يجب أن يفضّل المشي لمسافات محدودة.
FEWER_TRANSFERS	تشير إلى أنّ المسار المحسوب يجب أن يفضّل عددًا محدودًا من عمليات النقل.

TransitTravelMode

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

عمليات التعداد
TRANSIT_TRAVEL_MODE_UNSPECIFIED	لم يتم تحديد وسيلة نقل عام.
BUS	التنقّل بالحافلة
SUBWAY	استخدام مترو الأنفاق
TRAIN	السفر بالقطار
LIGHT_RAIL	استخدِم القطار الخفيف أو الترام.
RAIL	التنقّل بالقطار وهذا يعادل مجموعة من SUBWAY وTRAIN وLIGHT_RAIL.

TransitStop

تمثّل هذه السمة معلومات حول محطة نقل عام.

الحقول
name	string تمثّل هذه السمة اسم محطة النقل العام.
location	Location الموقع الجغرافي للمحطة معبَّرًا عنه بإحداثيات خط العرض/خط الطول

TransitVehicle

معلومات عن مركبة مستخدَمة في مسارات النقل العام

الحقول
name	LocalizedText اسم هذه المركبة، مكتوبًا بالأحرف الكبيرة
type	TransitVehicleType نوع المركبة المستخدَمة
icon_uri	string تمثّل هذه السمة معرّف الموارد المنتظم (URI) لرمز مرتبط بنوع المركبة هذا.
local_icon_uri	string تمثّل هذه السمة معرّف الموارد الموحّد (URI) للرمز المرتبط بنوع المركبة هذا، استنادًا إلى لوحات النقل المحلية.

TransitVehicleType

تعرض هذه السمة نوع المركبات التي تسير على مسارات النقل العام.

عمليات التعداد
TRANSIT_VEHICLE_TYPE_UNSPECIFIED	غير مستخدَمة
BUS	حافلة
CABLE_CAR	مركبة تعمل على كابل، وعادةً ما تكون على الأرض قد تكون العربات المعلقة من النوع GONDOLA_LIFT.
COMMUTER_TRAIN	القطارات السريعة
FERRY	عبّارة
FUNICULAR	مركبة يتم سحبها إلى أعلى منحدر شديد بواسطة كابل يتألف القطار المعلق عادةً من عربتَين، وتعمل كل عربة كوزن موازن للأخرى.
GONDOLA_LIFT	عربة تلفريك معلّقة
HEAVY_RAIL	سكك حديدية ثقيلة
HIGH_SPEED_TRAIN	قطار عالي السرعة
INTERCITY_BUS	حافلة بين المدن
LONG_DISTANCE_TRAIN	قطار مسافات طويلة
METRO_RAIL	نظام النقل بالقطار الخفيف
MONORAIL	قطار بخط حديدي واحد
OTHER	جميع المركبات الأخرى
RAIL	السكك الحديدية
SHARE_TAXI	سيارة الأجرة المشتركة هي نوع من الحافلات يمكنها إقلال الركاب وتوصيلهم في أي مكان على مسارها.
SUBWAY	قطار خفيف تحت الأرض
TRAM	قطار خفيف فوق الأرض
TROLLEYBUS	ترولي باص

الوحدات

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

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

VehicleEmissionType

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

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

VehicleInfo

تحتوي على معلومات المركبة، مثل نوع انبعاثات المركبة.

الحقول
emission_type	VehicleEmissionType تصف هذه السمة نوع الانبعاثات للمركبة. ينطبق ذلك على DRIVE RouteTravelMode فقط.
total_height_mm	int64 ارتفاع المركبة، بما في ذلك ارتفاع أي مقطورات متصلة بها يجب ضبط هذا الخيار على "نقل البضائع" أو "سحب المقطورات" لتفعيل الميزة. لا يتوفّر هذا الحقل في ComputeRouteMatrix عندما تكون قيمة RouteTravelMode هي DRIVE.
total_length_mm	int64 طول المركبة، بما في ذلك طول أي مقطورات متصلة بها يجب ضبط هذا الخيار على "نقل البضائع" أو "سحب المقطورات" لتفعيل الميزة. لا يتوفّر هذا الحقل في ComputeRouteMatrix عندما تكون قيمة RouteTravelMode هي DRIVE.
total_width_mm	int64 عرض المركبة، بما في ذلك عرض أي مقطورات ملحقة يجب ضبط هذا الخيار على "نقل البضائع" أو "سحب المقطورات" لتفعيل الميزة. لا يتوفّر هذا الحقل في ComputeRouteMatrix عندما تكون قيمة RouteTravelMode هي DRIVE.
total_weight_kg	int64 وزن المركبة، بما في ذلك وزن أي مقطورات متصلة بها يشير الوزن في هذا السياق إلى الوزن الفعلي، وليس إلى التقييم حسب الوزن. يجب ضبط هذا الخيار على "نقل البضائع" أو "سحب المقطورات" لتفعيل الميزة. لا يتوفّر هذا الحقل في ComputeRouteMatrix عندما تكون قيمة RouteTravelMode هي DRIVE.
trailer_info[]	TrailerInfo يحتوي على إدخال واحد لكل مقطع دعائي. في حال توفُّر معلومات المقطع الدعائي، يجب ضبط قيمة RoutingPreference على TRAFFIC_AWARE_OPTIMAL. لا يتوفّر هذا الحقل في ComputeRouteMatrix عندما تكون قيمة RouteTravelMode هي DRIVE.
hazardous_goods_types[]	HazardousGoodsType قائمة بالمواد الخطرة المنقولة في المركبة، إن وُجدت

HazardousGoodsType

أنواع المواد الخطرة المختلفة

عمليات التعداد
HAZARDOUS_GOODS_TYPE_UNSPECIFIED	لم يتم تحديد نوع السلع الخطرة.
EXPLOSIVES	السلع المتفجرة
GASES	الغازات
FLAMMABLE	السلع القابلة للاشتعال
COMBUSTIBLE	السلع القابلة للاشتعال
ORGANIC	منتجات عضوية
POISON	السلع السامة
RADIOACTIVE	السلع المشعّة
CORROSIVE	السلع الآكلة
ASPIRATION_HAZARD	السلع الخطرة التي قد تؤدي إلى استنشاق مواد سامة
ENVIRONMENTAL_HAZARD	السلع الخطرة البيئية
OTHER	أنواع أخرى من السلع

TrailerInfo

تعرض هذه السمة معلومات عن المقطورات الفردية المرفقة بالمركبة. يجب توفير أطوال أي مقطورات لنقل البضائع بالشاحنات. أما السمات الأخرى، فهي اختيارية. يجب أن تشمل السمات الإجمالية سمات أي مقطورات. على سبيل المثال، يجب أن تكون قيمة total_height_mm أكبر من أو تساوي قيمة trailer_info.height_mm.

الحقول
height_mm	int64 تمثّل هذه السمة ارتفاع المقطع الدعائي.
length_mm	int64 طول المقطع الدعائي
width_mm	int64 تمثّل هذه السمة عرض المقطورة.
weight_kg	int64 وزن المقطورة يشير الوزن في هذا السياق إلى الوزن الفعلي، وليس إلى التقييم حسب الوزن.

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

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

الحقول
via	bool تضع هذه السمة علامة على نقطة الطريق هذه للإشارة إلى أنّها معلم رئيسي وليس نقطة توقّف. بالنسبة إلى كل نقطة على المسار غير نقطة المرور في الطلب، يضيف الردّ إدخالاً إلى مصفوفة legs لتقديم تفاصيل عن محطات التوقف في هذا الجزء من الرحلة. اضبط هذه القيمة على "صحيح" عندما تريد أن يمر المسار بنقطة الطريق هذه بدون التوقف فيها. لا تؤدي نقاط المرور إلى إضافة إدخال إلى مصفوفة legs، ولكنّها توجّه الرحلة عبر نقطة المرور. يمكنك ضبط هذه القيمة فقط على نقاط الطريق التي تكون وسيطة. سيفشل الطلب إذا ضبطت هذا الحقل على نقاط الطريق النهائية. إذا تم ضبط ComputeRoutesRequest.optimize_waypoint_order على "صحيح"، لا يمكن ضبط هذا الحقل على "صحيح"، وإلا سيفشل الطلب.
vehicle_stopover	bool تشير إلى أنّ نقطة على المسار مخصّصة لتوقّف المركبات، حيث يكون الهدف إما استلام أو تسليم. عند ضبط هذه القيمة، لن يتضمّن المسار المحسوب نقاط على المسار غير via على الطرق غير المناسبة للاستلام والتسليم. لا يعمل هذا الخيار إلا مع وسيلتَي النقل DRIVE وTWO_WHEELER، وعندما تكون قيمة location_type هي Location.
side_of_road	bool تشير إلى أنّ الموقع الجغرافي لنقطة على المسار هذه يهدف إلى أن تفضّل المركبة التوقف على جانب معيّن من الطريق. عند ضبط هذه القيمة، سيمر المسار بالموقع الجغرافي لكي تتمكّن المركبة من التوقف على جانب الطريق الذي يميل إليه الموقع الجغرافي من وسط الطريق. لا يعمل هذا الخيار إلا مع DRIVE وTWO_WHEELER RouteTravelMode.
حقل الربط location_type طرق مختلفة لتمثيل موقع جغرافي يمكن أن يكون التعليق location_type إحدى القيم التالية فقط:
location	Location تمثّل هذه السمة نقطة محدّدة باستخدام الإحداثيات الجغرافية، بما في ذلك عنوان اختياري.
place_id	string تمثّل هذه السمة رقم تعريف المكان الخاص بنقطة الاهتمام المرتبط بنقطة على المسار.
address	string عنوان يمكن لشخص عادي قراءته أو رمز Plus Code لمزيد من التفاصيل، يُرجى الانتقال إلى https://plus.codes.
navigation_point_token	string رمز مميز يعرّف NavigationPoint، ويتم الحصول عليه من طريقة SearchDestinations في Geocoding API.