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

تجد حزمة تطوير البرامج (SDK) الخاصة بخدمة Navigation API لنظام التشغيل 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()