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

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

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

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

يمكنك بعد ذلك تمرير الرمز المميّز لنقطة التنقّل، الذي يحتوي على إحداثيات الوجهة والمعلومات السياقية، إلى الـ حزمة تطوير البرامج (SDK) للتنقّل لنظام التشغيل Android أو الـ حزمة تطوير البرامج (SDK) للتنقّل لنظام التشغيل iOS أو الـ Routes API، حيث يتم إنشاء نقطة على المسار لتحديد أفضل مسار دقيق. سيُعلِم Navigation SDK السائق بالوجهة استنادًا إلى المكان المرتبط بالرمز المميّز.

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

نظرة عامة

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

فيما يلي خطوات إجراء ذلك بشكل عام:

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

راجِع قسم "مزيد من القراءة " للاطّلاع على روابط تؤدي إلى المستندات ذات الصلة بـ Routes API وNavigation SDK لنظام التشغيل iOS و Navigation SDK لنظام التشغيل Android.

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

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

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

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

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

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

عندما يفتح المستهلك التطبيق، يستدعي التطبيق طريقة Destinations في 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 لحساب المسار واسترداد رمز مميّز للمسار.

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

مزيد من القراءة