في هذا المستند، ستتعرف على كيفية استخدام واجهة برمجة تطبيقات البحث عن قرب (الجديدة) إلى لإنشاء منصة بسيطة ومنخفضة التكلفة
تجربة استكشاف محلية.
تجربة استكشاف محلية تعرض للمستخدمين الأماكن الرئيسية التي تهمّهم بالقرب من موقع جغرافي معيّن التي تحددها عند البحث عن فندق أو عقارات. غالبًا ما تتكون من خريطة تفاعلية، مع لوحة إضافية تحتوي على محدد المكان معرض الصور. سيتم تزويدك بمنصة خرائط Google مختلفة المنتجات والإمكانات إلى تحسين التجربة من خلال التفاعل.
حالات الاستخدام
دعونا الآن نفهم عناصر دمج الاكتشاف المحلي التي تدفع المستخدم القيمة:
الاستكشاف: يمكنك منح المستخدمين نظرة عامة حول ما حول موقع جغرافي واحد. من خلال عرض الأماكن المناسبة من مختلف الأنواع
التفاعل - تمكين المستخدمين من اختيار مكان وإعادة تحميل البيانات ديناميكيًا
ذات صلة بذلك المكان.
العرض المرئي - تقديم تعليقات وصور حول الأماكن
ووقت المشي والمسافة للمستخدمين حتى يفهموا بسرعة ما إذا كان ذلك مناسبًا واحتياجاتهم.
بنية المرجع
استكشاف المحتوى على الجهاز
تتوفّر عدة طرق لإنشاء تجربة استكشاف محلية. ما يلي: هو مثال مخصص لتجربة المستخدم التي تستفيد المعروفة باسم واجهات برمجة التطبيقات لمنصة Google Maps Platform، بالإضافة إلى بعض الميزات الجديدة المثيرة. إذا كنت إذا كنت ترغب في الحصول على نموذج منهجي لاستكشاف المحتوى المحلي، فيمكنك استخدام الويب المكونات.
تطبيق نموذجي
نموذج الجولة التفصيلية
ستجد في الجدول أسفل نموذج التطبيق مقسمًا إلى خطوات بالإضافة إلى وصف للتنفيذ الفني باستخدام "خرائط Google" واجهات برمجة التطبيقات للنظام الأساسي.
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- إضافة تفاعل باستخدام "الخرائط الديناميكية" و"واجهة برمجة التطبيقات للاتجاهات"
- تعديل المسار والخطوات من خلال الاستعلام عن الاتجاهات 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" باستخدام إمكانات خاصة من واجهة برمجة تطبيقات البحث عن قرب (الجديدة) .
الخطوات التالية
قراءة إضافية مقترَحة:
- مكوّنات الويب في واجهة برمجة تطبيقات JavaScript للخرائط
- تحسين الإكمال التلقائي للأماكن
- خدمات أماكن أخرى
- يُرجى ترك ملاحظاتك أدناه.
المساهمون
المؤلفون الرئيسيون:
Thomas Anglaret | خرائط Google مهندس حلول الأنظمة الأساسية