مميزات استخدام Places API
إنشاء ميزات تدرك الموقع لإتاحة بيانات الموقع التفصيلية بسهولة للمستخدمين. يتم إنشاء البيانات المتوفرة من خلال Places API على أساس واحد من أكثر الأنظمة دقة نماذج الأماكن الشاملة من العالم الحقيقي. في ما يلي أمثلة على حالات الاستخدام الخاصة بالتطبيقات:
- اعرض وحدات سكنية للاستئجار في المناطق الحضرية الكبرى مع نتائج تستهدف المدن على وجه التحديد.
- أدرِج تفاصيل المكان في تعديل حالة استلام الطلب أو التسليم.
- يمكنك عرض قائمة بالمنتزهات في منطقة ما إلى جانب صور ومراجعات أرسلها المستخدمون.
- قدِّم للأشخاص الذين يخطّطون للرحلات معلومات الاتصال والمراجعات ومستويات الأسعار للمنشآت أثناء التنقّل.
الإجراءات التي يمكنك اتّخاذها باستخدام Places API
يمكنك استخدام Places API لتضمين الميزات التالية في التطبيقات:
- تقديم نتائج البحث عن الأماكن من أنواع مختلفة من طلبات بحث المستخدمين، مثل إدخال النص والمواقع القريبة، وطلبات البحث الغامضة أو الفئوية للمستخدمين.
- تفعيل ميزات الإكمال التلقائي لأنواع البحث المختلفة، إمّا لطلبات بحث نصية محدّدة أو الاستعلامات الفئوية.
- يمكنك تحسين نوع التفاصيل التي يتم عرضها عن مكان ما، مثل ساعات العمل والملخص ومراجعات المستخدمين وصورة.
- أضِف صورًا عالية الجودة إلى المواقع الجغرافية التي يعرضها تطبيقك.
تتوافق العديد من واجهات برمجة التطبيقات في Google Maps Platform أرقام تعريف الأماكن، حيث يتم إدخال رقم تعريف المكان بشكلٍ فريد يحدد مكانًا في قاعدة بيانات أماكن Google وعلى خرائط Google. هناك العديد من الطرق للحصول على رقم تعريف المكان، بما في ذلك من Places API، ولكن أيضًا من Geocoding API وRoutes API وAddress Validation API.
عند حصولك على رقم تعريف المكان، يمكنك استخدام Places API لطلب مزيد من التفاصيل منشأة معيّنة أو نقطة اهتمام معيّنة، مثل العنوان الكامل أو رقم الهاتف وتقييم المستخدم والمراجعات.
اختيار الإصدار الذي تستخدمه من Places API
تدعم Places API إصدارين من واجهة برمجة التطبيقات: Places API هي واجهة برمجة التطبيقات واجهات برمجة التطبيقات الحالية وPlaces API (جديد) هي إصدارات الجيل التالي من واجهات برمجة التطبيقات.
مع إصدار واجهة برمجة تطبيقات الأماكن (جديدة)، فإن مهمتك الأولى هي تحديد مجموعة من واجهات برمجة التطبيقات لاستخدامها. هذا صحيح إذا كنت عميلاً جديدًا أو عميلاً حاليًا عميل يستخدم واجهات برمجة التطبيقات بالفعل. استخدام هذا الدليل لمعرفة ما الاختلافات بين واجهتَي برمجة التطبيقات.
آلية عمل Places API
Places API (جديدة)
تقبل Places API (الجديدة) الطلبات على أنّها عنوان URL عادي مع عنوان URL
نقطة نهاية الخدمة، مثل /places
أو places:searchText
وتعرض استجابة JSON. تدعم Places API (جديدة) التفويض من خلال
مفتاح واجهة برمجة التطبيقات ورمز OAuth المميز.
يقدم المثال التالي طلب تفاصيل مكان لعرض مكونات العنوان
معرّف المكان باستخدام مفتاح واجهة برمجة التطبيقات:
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key=YOUR_API_KEY
واجهة برمجة تطبيقات الأماكن
تقبل واجهة Places API الطلبات على أنها عنوان URL عادي مع عنوان URL
نقطة نهاية الخدمة، مثل /place
أو /photo
. نقاط النهاية أيضًا
قبول نوع التنسيق المحدد في الطلب، إما JSON أو XML. الخدمة
الطلب يستخدم معلمات ذات صلة بنقطة النهاية المحددة هذه لتحسين البيانات المعروضة.
يقدم المثال التالي طلب تفاصيل مكان لعرض مكونات العنوان
رقم تعريف المكان بتنسيق JSON:
https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJrTLr-GyuEmsRBfy61i59si0 &fields=address_components &key=YOUR_API_KEY
في هذه الحالة، تستخدم الخدمة معرّف المكان المقدَّم للعثور على المكان المطلوب إرجاع مكونات العنوان بتنسيق JSON.
الموارد
يلخص الجدول التالي الموارد المتاحة من خلال Places API.
واجهة برمجة تطبيقات الأماكن | Places API (جديدة) | ملاحظة |
---|---|---|
البحث عن مكان | البحث النصي (جديد) | لا يوجد إصدار جديد من "البحث عن مكان". وقد تم استبداله باستخدام البحث النصي (جديد). |
البحث عن الأجهزة المجاورة | البحث عن الأجهزة المجاورة (جديد) | يجب استخدام واجهة برمجة التطبيقات الحالية التي تتضمّن طلب بحث نصيًا في جميع الطلبات البحث النصي (جديد) لأنّ البحث عن قرب (جديد) لا يتيح إدخال النص. |
البحث النصي | البحث النصي (جديد) | |
تفاصيل المكان | تفاصيل المكان (جديد) | |
صورة المكان | صورة المكان (جديدة) | |
الإكمال التلقائي للأماكن | الإكمال التلقائي (جديد) | |
الإكمال التلقائي لطلبات البحث | الإكمال التلقائي (جديد) | الإمكانات المُضافة إلى الإكمال التلقائي (جديدة) |
كيفية استخدام Places API
تتناول الخطوات التالية سيناريو نموذجي لحالة استخدام لاستخدام خدمة Places API. أثناء إنشاء من الحل، يمكنك استخدام نقاط نهاية إضافية، مثل البحث عن مكان قريب وصور الأماكن.1 | البدء | ابدأ بـ إعداد مشروع Google Cloud وأكمل تعليمات الإعداد التي تلي ذلك، تعرَّف على كيفية استخدام مفتاح واجهة برمجة التطبيقات. بالنسبة إلى Places API (الجديدة)، يمكنك أيضًا استخدام رموز OAuth المميزة. |
2 | جرِّب البحث النصي الأساسي | إجراء بحث نصي بسيط باستخدام ميزة البحث النصي (جديد) أو البحث النصي. |
3 | استخدام رقم تعريف المكان للحصول على مزيد من التفاصيل | وتعرِض العديد من واجهات برمجة التطبيقات في "منصة خرائط Google" رقم تعريف مكان كجزء من الردّ. يمكنك استخدام معرّف المكان للحصول على تفاصيل حول مكان. اطّلِع على تفاصيل المكان (جديد) وتفاصيل المكان. |
4 | الحصول على صورة لمكان معيّن | تتيح لك خدمة "صور المكان" الوصول إلى ملايين الصور المخزنة في "الأماكن" قاعدة البيانات. استخدام صورة المكان (جديدة) أو تفاصيل المكان للوصول إلى صور أحد الأماكن. |