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