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