في هذا المستند، ستتعرف على كيفية استخدام واجهة برمجة تطبيقات البحث عن قرب (الجديدة) إلى لإنشاء منصة بسيطة ومنخفضة التكلفة
تجربة استكشاف محلية.
تجربة استكشاف محلية تعرض للمستخدمين الأماكن الرئيسية التي تهمّهم بالقرب من موقع جغرافي معيّن التي تحددها عند البحث عن فندق أو عقارات. غالبًا ما يتألّف من خريطة تفاعلية، مع لوحة إضافية تحتوي على أداة اختيار الأماكن ومعرض للصور. ستظهر لك منصة مختلفة من "منصة خرائط Google". المنتجات والإمكانات إلى تحسين التجربة من خلال التفاعل.
حالات الاستخدام
دعونا الآن نفهم عناصر دمج الاكتشاف المحلي التي تدفع المستخدم القيمة:
الاستكشاف: يمكنك منح المستخدمين نظرة عامة حول ما يحيط بموقع جغرافي واحد. من خلال عرض الأماكن المناسبة من مختلف الأنواع
التفاعل - تمكين المستخدمين من اختيار مكان وإعادة تحميل البيانات ديناميكيًا
ذات صلة بذلك المكان.
العرض المرئي - تقديم تعليقات وصور حول الأماكن
ووقت المشي والمسافة للمستخدمين حتى يفهموا بسرعة ما إذا كان ذلك مناسبًا واحتياجاتهم.
بنية المرجع
ميزة "الاستكشاف في المنطقة"
تتوفّر عدة طرق لإنشاء تجربة استكشاف محلية. ما يلي: هو مثال مخصص لتجربة المستخدم التي تستفيد المعروفة باسم واجهات برمجة التطبيقات لمنصة Google Maps Platform، بالإضافة إلى بعض الميزات الجديدة المثيرة. إذا كنت إذا كنت ترغب في الحصول على نموذج منهجي لاستكشاف المحتوى المحلي، فيمكنك استخدام الويب المكونات.
تطبيق نموذجي
نموذج الجولة التفصيلية
ستجد في الجدول أسفل نموذج التطبيق مقسمًا إلى خطوات بالإضافة إلى وصف للتنفيذ الفني باستخدام "خرائط Google" واجهات برمجة التطبيقات للنظام الأساسي.
1. البحث عن الموقع باستخدام الإكمال التلقائي للبحث عن الموقع
- حمِّل واجهة برمجة تطبيقات JavaScript للخرائط.
- طلب بحث الإكمال التلقائي للأماكن أو اختيار موقع جغرافي على الخريطة.
2. عرض نقاط الاهتمام المحلية باستخدام واجهة برمجة التطبيقات Nearby Search (New) API
- ترتيب مدى الرواج (نتائج أكثر صلة) أو ترتيب المسافة
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- إضافة تفاعل باستخدام "الخرائط الديناميكية" و"واجهة برمجة التطبيقات للاتجاهات"
- تعديل المسار والخطوات من خلال الاستعلام عن الاتجاهات API. * استخدِم الوقت في القسم التالي.
4. عرض معلومات تفصيلية عن المكان عند التفاعل معه
الوصف:
displayName
،types
،rating
،userRatingCount
،priceLevel
الوقت: مصدره طلب البحث السابق في Directions API.
المراجعات:
reviews[i].author
وreviews[i].rating
وreviews[i].text
الصور: خلال المعاينة غير المحدودة لواجهة برمجة التطبيقات الخاصة بالبحث عن الأجهزة المجاورة (الجديدة)، يمكنك سيضطر إلى الاستعلام عن الأماكن التفاصيل مع
place.id
للحصول على photo_reference ثم الاستعلام واحدًا تلو الآخر في تجربتك
عدد طلبات البحث والتكاليف المرتبطة بها
- JavaScript في "خرائط Google" واجهة برمجة التطبيقات: خريطة واحدة عند تحميل التجربة.
- واجهة برمجة تطبيقات الإكمال التلقائي للأماكن: استعلام واحد يُكتب كل حرف (في حالة استخدام الإكمال التلقائي التطبيق المصغَّر)، يمكن تخصيصها.
- البحث عن الأجهزة المجاورة (جديد) واجهة برمجة التطبيقات: طلب بحث واحد كل 20 مكانًا معروضًا. فوترة مختلفة حسب المكان البيانات التي تشكل جزءًا من استجابة الاستعلام.
- الاتجاهات واجهة برمجة التطبيقات: طلب بحث واحد لكل مكان يختاره المستخدم.
- صورة المكان واجهة برمجة التطبيقات: طلب بحث واحد عن كل صورة معروضة.
الخاتمة
تشكّل تجربة الاكتشاف المحلي طريقة فعّالة لتقديم قيمة للمستخدم. يتضمّن تنفيذ الشرح هذا العديد من الميزات التي من المرجّح أن تُدرِجها عند إنشاء تجربة مماثلة على "منصة خرائط Google" باستخدام إمكانات خاصة من Nearby Search (New) API .
الخطوات التالية
قراءة إضافية مقترَحة:
- مكوّنات الويب في واجهة برمجة تطبيقات JavaScript للخرائط
- تحسين ميزة "الإكمال التلقائي للأماكن"
- خدمات "الأماكن" الأخرى
- يُرجى ترك ملاحظاتك أدناه.
المساهمون
المؤلفون الرئيسيون:
Thomas Anglaret | خرائط Google مهندس حلول الأنظمة الأساسية