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 تحسب المسارات مع وضع ظروف حركة المرور المباشرة في الاعتبار، بدون تطبيق معظم تحسينات الأداء. ويؤدي استخدام هذه القيمة إلى الحصول على أعلى وقت استجابة.