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

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

لاستكشاف الأماكن المحلية.

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

مثال على اكتشاف الأماكن المحلية

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

لننتقل الآن إلى فهم عناصر عملية دمج تجربة استكشاف الأماكن المحلية التي تزيد من قيمة المستخدم:

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

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

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

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

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

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

alt_text

استكشاف الأماكن المحلية

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

تطبيق نموذجي

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

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

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

  • تحميل Maps JavaScript API
  • طلب الإكمال التلقائي للأماكن أو اختيار موقع جغرافي على الخريطة

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

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

  • الترتيب حسب الشهرة (نتائج أكثر صلة) أو الترتيب حسب المسافة
  • includedTypesوexcludedTypes: إذا كنتم تديرون فندقًا، يمكنكم استبعاد النوع "الإقامة" وتضمين الأنواع المناسبة فقط، مثل "مطعم ومقهى وحديقة ومكان سياحي"
  • الاستفادة من includedPrimaryTypes وexcludedPrimaryTypes للتحكّم بشكل أكبر في النتائج
  • `locationRestriction` لتجنُّب عدم توفّر عدد كافٍ من النتائج أو ظهور أماكن بعيدة جدًا: في حال عدم ظهور أي نتائج، يجب توسيع حجم الدائرة أو المستطيل قبل عرض النتائج

أمثلة على الأماكن المجاورة

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

  • الأساسية (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. إضافة التفاعل باستخدام الخرائط الديناميكية وDirections API

  • الحصول على المراحل والخطوات الحديثة من خلال طلب 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" باستخدام إمكانات خاصة من Nearby Search (New) API .

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

مقالات نقترح قراءتها:

المساهمون

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

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