تحديد مسار باستخدام رموز نقاط التنقّل

المطوّرون في المنطقة الاقتصادية الأوروبية

تتيح لك رموز نقاط التنقّل إرسال معلومات سياقية رئيسية حول وجهة معيّنة إلى حزمة تطوير البرامج للتنقّل على أجهزة Android أو حزمة تطوير البرامج للتنقّل على أجهزة iOS أو Routes API لتحسين تجربة السائقين وتوجيههم. ويُعدّ ذلك مفيدًا في حالات مثل توصيل الطعام أو مشاركة الرحلات، حيث قد تكون نقطة الاستلام أو التوصيل غامضة بدون إدخال المستخدم.

لإنشاء رمز مميّز لنقطة التنقّل وتمريره، استخدِم طريقة Destinations في Geocoding API للسماح للمستخدمين باختيار موقع جغرافي مفضَّل من قائمة نقاط التنقّل. يصبح اختيار المستخدم نقطة تنقّل تعرضها طريقة Destinations في Geocoding API.

يمكنك بعد ذلك تمرير الرمز المميّز لنقطة التنقّل، الذي يحتوي على إحداثيات الوجهة والمعلومات السياقية، إلى حزمة تطوير البرامج للتنقّل على أجهزة Android أو حزمة تطوير البرامج للتنقّل على أجهزة iOS أو Routes API، حيث يتم إنشاء نقطة على المسار لتحديد المسار بدقة. سيتم تمييز الوجهة للسائق من خلال حزمة تطوير البرامج (SDK) الخاصة بالتنقّل استنادًا إلى المكان المرتبط بالرمز المميّز.

مثال: حالة استخدام خدمة مشاركة الرحلات

نظرة عامة

يوضّح هذا المثال كيفية الجمع بين Geocoding API وRoutes API وNavigation SDK لنظامَي التشغيل iOS أو Android لإنشاء تطبيق لمشاركة الرحلات يحسب سعر المسار ويوجه السائقين إلى نقطة الالتقاء الصحيحة.

في ما يلي الخطوات بشكل عام:

  1. استرداد رمز مميّز لنقطة التنقّل من خلال Geocoding API
  2. استخدِم Routes API لاحتساب مسار وترميزه في رمز مميّز للمسار.
  3. مرِّر كلاً من رمز نقطة التنقّل المميّز ورمز المسار المميّز إلى حزمة تطوير البرامج (SDK) للتنقّل.
  4. استخدِم حزمة Navigation SDK لتوجيه السائق إلى نقطة الالتقاء الصحيحة.

يمكنك الاطّلاع على قسم مزيد من المعلومات للحصول على روابط تؤدي إلى مستندات Routes API و"حزمة تطوير البرامج للتنقّل" لنظام التشغيل iOS و"حزمة تطوير البرامج للتنقّل" لنظام التشغيل Android.

يوضّح هذا المخطّط البياني كيف يمكن لتطبيق توصيل أو مشاركة رحلات استخدام Geocoding API وRoutes API وNavigation SDK لنظام التشغيل iOS أو Android لتوجيه السائق باستخدام رمز مميّز للمسار ورمز مميّز لنقطة التنقّل:

مخطّط بياني لحالة استخدام خدمات النقل التشاركي أو التوصيل
مخطّط بياني لحالة استخدام خدمة توصيل أو مشاركة رحلات

مثال على مشاركة الرحلات

تخيَّل سيناريو لمشاركة الرحلات حيث يوجد تطبيق للمستهلك لحجز الرحلة، وتطبيق ثانٍ للسائق لتلقّي إشعار بالرحلة ومعلومات المسار إلى الوجهة.

تعرض هذه الصورة أمثلة على تطبيق لمشاركة الرحلات للمستهلكين يتم فيه اختيار نقطة التنقّل، وتطبيق للسائقين يستخدم حزمة Navigation SDK لنظام التشغيل Android لتوجيه السائق بدقة.

أمثلة على تطبيقات المستهلكين والسائقين

عندما يفتح المستهلك تطبيق المستهلك، يستدعي التطبيق طريقة الوجهات في Geocoding API و يقدّم للمستهلك مجموعة من نقاط التنقّل المحتملة:

مستهلك يختار نقطة تسليم

يختار المستخدم النقطة المفضّلة لديه، وهي واحدة من مصفوفة navigationPoints في نص الاستجابة لطلب SearchDestinations:

"navigationPoints": [
    {
      "navigationPointToken": <encoded navigation point token>,
      "displayName": "South Entrance",
      "travelModes": ["DRIVE"],
      "usages": ["PICKUP","DROPOFF"],
      "location": {
        "lat": 37.3940894,
        "lng": -122.0788389
      }
    }
]

يوفّر الخلفية للتطبيق الرمز المميّز لنقطة التنقّل إلى Routes API لاحتساب المسار واسترداد الرمز المميّز للمسار.

أخيرًا، يتم تمرير كل من الرمز المميّز لنقطة التنقّل والرمز المميّز للمسار إلى تطبيق السائق على الأجهزة الجوّالة الذي يستخدم حزمة تطوير البرامج (SDK) للتنقّل على أجهزة iOS أو Android لإنشاء نقطة على المسار لتوجيه السائق إلى نقطة الركوب الصحيحة.

محتوى إضافي للقراءة