نظرة عامة

مزايا استخدام 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