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

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

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

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

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

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

الآن، دعنا نفهم عناصر دمج "اقتراحات" المحلية التي تعزّز قيمة المستخدم:

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

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

    ذات صلة بذلك المكان.

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

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

بنية المرجع

alt_text

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

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

تطبيق نموذجي

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

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

1- البحث عن الموقع باستخدام الإكمال التلقائي للبحث عن الموقع

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

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

‫2. إبراز نقاط الاهتمام المحلية باستخدام واجهة برمجة تطبيقات "البحث عن قرب" (الجديدة)

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

عيّنات من الأماكن المجاورة

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

  • الخيارات الأساسية (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. * استخدِم الوقت في القسم التالي.

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

‫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" باستخدام إمكانات خاصة من واجهة برمجة تطبيقات "البحث عن قرب (جديد)" .

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

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

المساهمون

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

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