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