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

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

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

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

نموذج ميزة "الاقتراحات"

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

دعونا الآن نفهم عناصر دمج الاكتشاف المحلي التي تدفع المستخدم القيمة:

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

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

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

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

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

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

alt_text

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

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

تطبيق نموذجي

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

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

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

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

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

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

  • ترتيب مدى الرواج (نتائج أكثر صلة) أو ترتيب المسافة
  • 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- إضافة تفاعل باستخدام "الخرائط الديناميكية" و"واجهة برمجة التطبيقات للاتجاهات"

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

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"