توفر واجهة Places API (الجديدة) أداءً محسنًا ونموذجًا جديدًا للأسعار، ما يجعل من المفيد تحديث التطبيقات التي تستخدم Places API. لمزيد من التفاصيل حول مقارنة الميزات، يرجى الاطّلاع على اختيار واجهة برمجة التطبيقات.
استخدم هذا الدليل لفهم الاختلافات الرئيسية في Places API (الجديدة) مقارنةً بـ Places API، إلى جانب كيفية التعامل مع التغييرات اللازمة.
تفعيل Places API (جديدة)
لاستخدام ميزات Places API (الجديدة)، عليك أولاً تفعيل Places API (جديدة) في مشروعك على Google Cloud. لمزيد من المعلومات، يمكنك الاطّلاع على إعداد مشروع Google Cloud.
يجب عليك بعد ذلك التأكّد من أنّك أضفت Places API (جديدة) إلى مفتاح واجهة برمجة التطبيقات الذي يستخدمه تطبيقك. ولمزيد من المعلومات، يُرجى الاطّلاع على استخدام مفاتيح واجهة برمجة التطبيقات.
التغييرات العامة
تتضمن بعض التغييرات العامة التي تنطبق على واجهات برمجة تطبيقات متعددة ما يلي:
- تتيح جميع واجهات برمجة التطبيقات الجديدة استخدام الرموز المميزة لكل من مفاتيح واجهة برمجة التطبيقات والرموز المميزة OAuth كآلية للمصادقة.
- يمكن استخدام JSON فقط كتنسيق للاستجابة.
- يجب إخفاء الحقول من خلال "تفاصيل المكان" (جديد) والبحث عن قرب (جديد) والبحث النصي (جديد) لتحديد الحقول التي تريد عرضها في الرد. للحصول على مزيد من المعلومات، يُرجى الاطّلاع على FieldMask.
- تعرض الآن واجهات برمجة تطبيقات البحث عن قرب (جديد) والبحث النصي (جديد) تفاصيل المكان الكاملة لمطابقة تفاصيل المكان التي تعرضها تفاصيل المكان (جديد).
- تم تغيير تنسيق استجابة JSON لواجهات برمجة التطبيقات تفاصيل المكان (جديد) والبحث عن قرب (جديد) والبحث النصي (جديد) لم يتم تغييره من تنسيق واجهات برمجة التطبيقات الحالية. لمزيد من التفاصيل، يمكنك الاطّلاع على نقل الردّ على Places API.
التغييرات الخاصة بواجهة برمجة التطبيقات
يتضمّن هذا القسم أدلة نقل البيانات التالية لكل واجهة برمجة تطبيقات: