إدارة نقاط الطريق

تجد حزمة تطوير البرامج (SDK) للتنقّل في Android تلقائيًا أسرع مسار إلى نقطة على المسار، ولكن هذا لا يضمن وصول المركبة إلى الجانب الذي ينتظره المستهلك من الطريق أو أنّ مكان الوصول آمن للسائق للتوقف فيه. يوضّح هذا الدليل ميزتَين يمكنك استخدامهما في هذه الحالات:

  • الإعداد المفضّل للتوجيه على جانب الطريق
  • ميزة "محطة توقّف"

الإعدادات المفضّلة للتوجيه إلى جانب الطريق

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

أفضّل الجهة نفسها من الطريق

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

Waypoint waypoint =
   Waypoint.builder()
           .setLatLng(latitude, longitude)
           .setTitle("Somewhere in Sydney")
           .setPreferSameSideOfRoad(true)
           .build()

ضبط عنوان الوصول

عليك تقديم الإحداثيات الجغرافية لنقطة على المسار، ثم تقديم عنوان الوصول (setPreferredHeading) الذي يتطابق مع اتجاه حركة المرور على الجانب نفسه من الطريق الذي ينتظره المستهلك.

Waypoint waypoint =
   Waypoint.builder()
           .setLatLng(latitude, longitude)
           .setTitle("Somewhere in Sydney")
           .setPreferredHeading(preferredHeading)
           .build()

تختار حزمة تطوير البرامج (SDK) الخاصة بخدمة "التنقّل" الجزء من الطريق الأقرب إلى نقطة على المسار، والذي يتضمّن اتجاهًا للمسار يتوافق (في حدود 55 درجة +/-) مع جانب الطريق الذي تقع عليه نقطة على المسار.

ضبط الإعدادات المفضّلة للتوقف

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

آلية العمل

يمكنك ضبط الإعدادات المفضّلة لمكان التوقف عند إنشاء نقطة الطريق لهذا التوقف. لإجراء ذلك، حدِّد الإعداد المفضّل setVehicleStopover كما هو موضّح في المثال التالي:

Waypoint waypoint =
   Waypoint.builder()
           .setLatLng(latitude, longitude)
           .setTitle("Somewhere in Sydney")
           .setVehicleStopover(true)
           .build()