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

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

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

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

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

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

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

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

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

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

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

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

بنية المرجع

alt_text

الاكتشاف المحلي

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

تطبيق نموذجي

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

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

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

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

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

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

  • الترتيب حسب مدى الرواج (نتائج أكثر صلة) أو ترتيب المسافة
  • includedTypes، excludedTypes، إذا كان نشاطك التجاري فندقًا، يمكنك استبعاد نوع "الإقامة" وتضمين الأنواع المناسبة فقط، مثل: "مطعم، مقهى، متنزه، tourit_attraction".
  • يمكنك الاستفادة من 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. * استخدِم الوقت في القسم التالي.

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

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"