RoutingParameters

مَعلمات لضبط عمليات احتساب المسار إلى الأماكن الواردة في الردّ، على طول المسار (حيث سيتأثر ترتيب النتائج) ولحساب أوقات السفر في النتائج

تمثيل JSON 
{
  "origin": {
    object (LatLng)
  },
  "travelMode": enum (TravelMode),
  "routeModifiers": {
    object (RouteModifiers)
  },
  "routingPreference": enum (RoutingPreference)
}
الحقول
origin

object (LatLng)

اختياريّ. مصدر توجيه صريح يتجاوز المصدر المحدّد في الخطوط المتعددة. ويتم تلقائيًا استخدام مصدر الخطوط المتعددة.
travelMode

enum (TravelMode)

اختياريّ. وضع السفر.
routeModifiers

object (RouteModifiers)

اختياريّ. مفاتيح تعديل المسار.
routingPreference

enum (RoutingPreference)

اختياريّ. تحدِّد هذه السياسة طريقة حساب ملخّصات التوجيه. يحاول الخادم استخدام تفضيل التوجيه المحدد لاحتساب المسار. لا يتوفّر خيار "المسارات التي تراعي حركة المرور" إلا في DRIVE أو TWO_WHEELER travelMode.

TravelMode

خيارات وضع السفر. وتتطابق هذه الخيارات مع ما تقدّمه واجهة برمجة التطبيقات Routes API.

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

RouteModifiers

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

تمثيل JSON 
{
  "avoidTolls": boolean,
  "avoidHighways": boolean,
  "avoidFerries": boolean,
  "avoidIndoor": boolean
}
الحقول
avoidTolls

boolean

اختياريّ. عند ضبطها على "صحيح"، يتم تجنُّب الطرق ذات رسوم العبور كلما أمكن ذلك، مع إعطاء الأولوية للطرق التي لا تتضمّن طرقًا ذات رسوم عبور. ينطبق هذا الإعداد على DRIVE وTWO_WHEELER TravelMode فقط.
avoidHighways

boolean

اختياريّ. عند ضبط هذا الخيار على "صحيح"، يتم تجنُّب الطرق السريعة كلما أمكن ذلك، مع إعطاء الأولوية للمسارات التي لا تحتوي على طرق سريعة. لا تنطبق هذه السياسة إلّا على DRIVE وTWO_WHEELER TravelMode.
avoidFerries

boolean

اختياريّ. عند ضبط هذه السياسة على "صحيح"، يتم تجنُّب العبّارات حيثما كان ذلك معقولاً، مع إعطاء الأولوية للمسارات التي لا تحتوي على عبّارات. لا تنطبق هذه السياسة إلّا على DRIVE وTWO_WHEELER TravelMode.
avoidIndoor

boolean

اختياريّ. عند ضبطها على "صحيح"، يتم تجنُّب التنقّل داخل المباني حيثما أمكن، مع إعطاء الأولوية للمسارات التي لا تتضمّن التنقّل داخل المباني. ينطبق فقط على WALK TravelMode.

RoutingPreference

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

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