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

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

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

تعرِض تجربة الاكتشاف المحلي للمستخدمين الأماكن الرئيسية المثيرة للاهتمام بالقرب من موقع جغرافي معين تحدّده عند البحث عن فندق أو عقار. غالبًا ما يتألّف من خريطة تفاعلية، مع لوحة إضافية تحتوي على أداة اختيار الأماكن ومعرض للصور. سيتم تقديم منتجات وإمكانات مختلفة في "منصّة خرائط 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. الصور: خلال الإصدار التجريبي غير المحدود لواجهة برمجة التطبيقات Nearby Search (New) API، عليك إجراء طلب بحث عن Details باستخدام place.id للحصول على photo_reference ثم إجراء طلب بحث واحد في كل مرة في تجربتك.

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

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

الخاتمة

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

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

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

المساهمون

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

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