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