تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

نصائح لإنشاء أفضل تجربة للمستخدم عند الانتقال إلى المواقع الجغرافية باستخدام سيارة

يتوفر إصدار أحدث من هذا المستند يتضمّن أمثلة على كيفية استخدام واجهتَي برمجة التطبيقات Places API وRoutes API الجديدة.

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

مخطّط بياني للأنظمة على مستوى عالٍ — **[سياق النظام] أنظمة التنقّل ذات المستوى العالي**
عرض مبسط للأنظمة المعنيّة عند توجيه السائق إلى موقع جغرافي باستخدام سيارة

سنوضّح كيفية استخدام Places API وDirections API بالتسلسل أو بالاشتراك لتحديد الموقع الجغرافي المناسب لإيقاف سيارتك بجانب وجهتك. يهدف هذا الحل إلى إزالة عدم اليقين والتفاعلات المتعدّدة للعثور على مكان مناسب للوقوف أثناء القيادة عند الاقتراب من الوجهة النهائية. لنلقِ نظرة على مثالَين على كيفية تنفيذ هذه الحالات بالتفصيل.

المثال 1: معلم سياحي لا يتضمّن موقف سيارات

لنختار موقعًا جغرافيًا غير مرتبط مباشرةً بطريق جانبي، ما يتطلّب استرجاع مسار بشكل منفصل. الوجهة هي كاتدرائية نوتردام في باريس، ونقطة البداية هي محطة القطار Gare de l’Est (48.87697775149635, 2.3592247806755564).

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

طلب Places API

يستخدم هذا المثال لطلب Places API ميزة "البحث عن نص" للعثور على كنيسة نوتردام. اطّلِع على مستندات المطوّرين للحصول على التفاصيل. يشير الرمز "YOUR_KEY" في هذه الأمثلة إلى مفتاح واجهة برمجة التطبيقات الذي تملكه لواجهات برمجة التطبيقات "الأماكن" و"الاتجاهات" في "منصة خرائط Google" والمفعَّلة في Google Cloud Console. للحصول على شرح أكثر تفصيلاً، يُرجى الاطّلاع على مستندات البدء في استخدام منصة Google Maps.

https://maps.googleapis.com/maps/api/place/textsearch/json?query=notre_dame&location=48.864716%2C2.349014&region=fr&key=YOUR_KEY

يقدّم الردّ على الطلب أعلاه إحداثيات خط الطول والعرض التالية:

  "results" : [
      {
        "formatted_address" : "Notre Dame, Paris",
        "geometry" : {
           "location" : {
               "lat" : 48.8527288,
                },
  ...

كما ترى، تشير الإحداثيات إلى موقع كاتدرائية نوتردام.

بصفتك مطوّرًا أو مقدّم خدمة، من الأفضل أن تطلب تلقائيًا من السائق معرفة ما إذا كان يبحث عن مكان لوقوف السيارات بالقرب من Notre Dame. ستكون تجربة المستخدم مختلفة استنادًا إلى الجهاز والشاشة، ولكن من الأفضل في هذه الحالة استخدام نص نافذة منبثقة خفيف يختفي بعد فترة قصيرة. للعثور على مواقف سيارات بالقرب من Notre Dame، يمكنك إجراء بحث نصي في Places API باستخدام النوع "parking" وتحديد المَعلمة radius "300". سيؤدي هذا المثال إلى توجيه النتائج نحو مواقف السيارات في نطاق 300 متر من كنيسة نوتردام.

https://maps.googleapis.com/maps/api/place/textsearch/json?query=parking
&location=48.8527288%2C2.3505635&region=fr&type=parking&radius=300&key=YOUR_KEY

النتيجة الأولى هي "Parking Saemes Maubert-Lagrange" عند 48.850591، 2.3486436. لنستخدم هذا الموقع الجغرافي في الجزء التالي حيث سنُجري طلبًا باستخدام واجهة برمجة التطبيقات Directions API.

طلب Directions API

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

https://maps.googleapis.com/maps/api/directions/json?origin=48.8767903,2.3592251&destination=48.850591%2C2.3486436&key=YOUR_KEY

يحتوي ردّ Direction API عادةً على اقتراحات متعددة للمسارات. يتكوّن كل مسار من عدّة "مراحل" تحتوي على عدّة "خطوات" تعرض المسافة المقطوعة والإحداثيات. للعثور على الإحداثيات النهائية التي يمكن الوصول إليها بالسيارة، استخدِم الحقل "end_location" للخطوة الأخيرة من القسم الأخير في المسار الذي اخترته.

قد يبدو هذا الموقع الجغرافي غير مناسب، ولكن عند الاطّلاع على الخريطة أو "التجوّل الافتراضي" من Google، ستلاحظ أنّ هذا الموقع الجغرافي يقع ضمن مسافة قصيرة جدًا بالمشي، تتراوح بين 6 و7 دقائق تقريبًا، من كاتدرائية نوتردام.

مسار المشي من مواقف السيارات إلى كاتدرائية نوتردام

مسار المشي من منطقة وقوف السيارات إلى كاتدرائية نوتردام

ملخّص للمثال 1

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

طلب Places API للعثور على إحداثيات كاتدرائية نوتردام
طلب Places API للعثور على منطقة مواقف سيارات في نطاق 300 متر من تلك الإحداثيات
طلب Directions API للعثور على مسار إلى منطقة وقوف السيارات

المثال 2: توجيه إلى مبنى في مطار كبير

لنلقِ نظرة على مثال آخر يحاول فيه السائق الوصول إلى منطقة كبيرة تتضمّن مواقع جغرافية أو نقاط اهتمام أو نقاط تسليم محتملة متعددة. يغادر السائق من ملعب ويمبلي، المملكة المتحدة (51.557263604707224، -0.2794575145680608) ويحاول الوصول إلى مبنى الركاب 5 في مطار لندن هيثرو. عادةً ما يبدأ المستخدم في كتابة "مطار دبي الدولي"، وفي معظم الأحيان يختار المستخدم إحدى النتيجة الأولى أو الاثنتين أو الثلاث إذا بدت النتيجة الصحيحة. من نتيجة البحث التي تم اختيارها، يمكنك معرفة أنّ الموقع الجغرافي هو مطار من خلال قراءة قيم حقل "الأنواع". يمكنك الاطّلاع على القائمة الكاملة بالأنواع هنا.

  "types" : [ "airport", "point_of_interest", "establishment" ],

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

  https://maps.googleapis.com/maps/api/place/textsearch/json?query=terminal&location=51.47016927594547%2C-0.45432767852489075&region=gb&key=YOUR_KEY&radius=3000

يمنحنا الطلب أعلاه قائمة بالمحطات ونقاط التسليم الفردية في تلك المحطات. من قائمة النتائج، يمكننا العثور على "مبنى الركّاب 5 في مطار هيثرو في لندن" ورقم تعريف المكان:

 "place_id" : "ChIJtQRd6XVxdkgRTUGZtcsoGNc",

باستخدام المَعلمة place_id، يمكننا إخبار Directions API بأنّنا نحاول الوصول إلى مكان بدلاً من بعض الإحداثيات العشوائية.

  https://maps.googleapis.com/maps/api/directions/json?origin=51.557263604707224,-0.2794575145680608&destination=place_id:ChIJtQRd6XVxdkgRTUGZtcsoGNc&key=YOUR_KEY

مرة أخرى، كما هو الحال في المثال السابق، من خلال قراءة جميع الخطوات في استجابة JSON، ستعثر على الجزء الأخير من الرحلة وموقعَي النهاية اللذَين يمثّلان إحداثيات خط الطول والعرض (51.47079979999999,-0.4896765).

ملخّص للمثال 2

كما هو الحال في المثال السابق، إنّ الجهد المبذول في التطوير لتقديم إرشادات محسّنة للسائق صغير جدًا، ويمكن قياس المزايا التي يحصل عليها السائق من خلال توفير الوقت بسهولة. لقد نفّذنا الطلبات التالية:

طلب Places API للعثور على مطار هيثرو
طلب Places API للعثور على جميع مباني الركاب القريبة من مطار Heathrow coordinates
طلب بيانات من واجهة برمجة التطبيقات Directions API للحصول على مسار إلى المحطة 5

الخاتمة

كما ترى، إنّ الجهد المبذول لتطوير خدمة مميزة لأجل عملائك الذين يسافرون بالسيارة ليس كبيرًا جدًا، ويسمح لك بسهولة بإظهار مدى اهتمامك باحتياجات عملائك.

لأغراض التطوير، يمكنك استخدام العديد من المكتبات والأدوات المتاحة لمساعدتك في إنشاء الخدمات لعملاءك. يمكنك الاطّلاع على مستودع GitHub المتاح للجميع والذي يتضمّن Google Maps Platform.

الإجراءات التالية

المؤلف الرئيسي

ميكو تويفانين | مهندس حلول في "منصة خرائط Google"