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