تحسين الاكتشاف المحلي باستخدام واجهة برمجة تطبيقات البحث عن قرب (الجديدة)

في هذا المستند، ستتعرّف على كيفية استخدام واجهة برمجة التطبيقات Nearby Search (New) API لإنشاء تجربة بحث بسيطة وفعّالة من حيث التكلفة.

تجربة الاكتشاف المحلي

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

نموذج "الاكتشاف المحلي"

حالات الاستخدام

لنلقِ نظرة الآن على عناصر دمج ميزة "الاقتراحات" داخل التطبيق التي تحقّق قيمة مضافة للمستخدمين:

  • الاكتشاف: يمكنك تقديم نظرة عامة للمستخدمين حول ما يحيط بموقع جغرافي واحد من خلال عرض الأماكن ذات الصلة بأنواع مختلفة.

  • التفاعل: إتاحة اختيار مكان وإعادة تحميل البيانات ديناميكيًا للمستخدمين

    بالنسبة إلى ذلك المكان.

  • العرض المرئي: تقديم مراجعات عن الأماكن وصور لها

    ووقت المشي والمسافة للمستخدمين لفهم ما إذا كان يتناسب مع احتياجاتهم بسرعة.

البنية المرجعية

alt_text

استكشاف المحتوى على الجهاز

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

تطبيق نموذجي

نموذج جولة تفصيلية

ستجد في الجدول أدناه نموذج التطبيق مقسمًا إلى خطوات مع وصف للتنفيذ الفني باستخدام واجهات برمجة تطبيقات النظام الأساسي لخرائط Google.

1. البحث عن الموقع الجغرافي باستخدام ميزة "الإكمال التلقائي"

  • حمِّل Maps JavaScript API.
  • أدخِل طلب بحث في ميزة الإكمال التلقائي للأماكن أو اختَر موقعًا جغرافيًا على الخريطة.

نموذج الإكمال التلقائي

2. عرض نقاط الاهتمام المحلية باستخدام واجهة برمجة التطبيقات Nearby Search (New) API

  • ترتيب حسب مدى الرواج (النتائج الأكثر صلة) أو ترتيب حسب المسافة
  • includedTypes، excludedTypes : إذا كنت فندقًا، يمكنك استبعاد نوع "lodging"، وتضمين الأنواع المناسبة فقط، مثل: "restaurant, cafe, park, tourit_attraction".
  • يمكنك الاستفادة من includedPrimaryTypes وexcludedPrimaryTypes للتحكم بشكلٍ أكبر في النتائج.
  • `locationRestriction to avoid insufficient number of results or too far away places ; in case of ZERO results, broaden the circle / rectangle size prior to display results.

نماذج للأماكن المجاورة

نموذج طلب بحث عند حجز فندق مع حقول البيانات المطلوبة:

  • الخيارات الأساسية (displayName وtypes وopeningHours وformattedAddress)
  • جهة الاتصال (websiteUri، nationalPhoneNumber، internationalPhoneNumber)
  • المفضّل (reviews وpriceLevel وuserRatingCount)
 { "includedTypes": ["restaurant","cafe","park"], "excludedTypes":
["lodging","convenience_store"], "includedPrimaryTypes":
["restaurant","tourist_attraction","airport"], "excludedPrimaryTypes":
["lodging"], "maxResultCount": 20, "locationRestriction": { "circle": {
"center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } } }

نموذج طلب البحث عند البحث عن عقارات باستخدام حقول البيانات المطلوبة:

  • الخيارات الأساسية (displayName وtypes وopeningHours وformattedAddress)
 { "includedTypes": ["school","transport","bus","convenience_store"],
"excludedTypes": ["lodging"], "includedPrimaryTypes":
["restaurant","tourist_attraction","airport"], "excludedPrimaryTypes":
["lodging"], "maxResultCount": 20, "locationRestriction": { "circle": {
"center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } } }

3- إضافة تفاعل باستخدام واجهة برمجة التطبيقات Dynamic Maps and Directions API

نماذج للاتّجاهات

4. عرض معلومات تفصيلية عن المكان عند التفاعل معه

  1. الوصف: displayName وtypes وrating وuserRatingCount priceLevel

    الوقت: من طلب البحث السابق من Directions API

  2. المراجعات: reviews[i].author وreviews[i].rating وreviews[i].text

  3. الصور: أثناء استخدام واجهة المعاينة غير المحدودة لواجهة برمجة التطبيقات الخاصة بالبحث عن الأجهزة المجاورة (الجديدة)، سيكون عليك طلب البحث عن تفاصيل الأماكن باستخدام place.id للحصول على photo_reference لإجراء طلب بحث واحد تلو الآخر في تجربتك

تفاصيل الأماكن

عدد طلبات البحث والتكلفة المرتبطة

الخاتمة

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

الخطوات التالية

مراجع إضافية مقترَحة:

المساهمون

المؤلفون الرئيسيون:

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