توفّر حزمة تطوير البرامج (SDK) لأماكن Google لنظام التشغيل Android (الإصدار الجديد) أداءً محسّنًا وأحد نماذج التسعير الجديدة، ما يجعل من المفيد تحديث التطبيقات التي تستخدم حزمة تطوير البرامج (SDK) لأماكن Google لنظام التشغيل Android. لمزيد من التفاصيل حول مقارنة الميزات، يُرجى الاطّلاع على مقالة اختيار حزمة SDK.
استخدِم هذا الدليل للتعرّف على الاختلافات الرئيسية في حزمة تطوير برامج "الأماكن" لنظام التشغيل Android (الإصدار الجديد) مقارنةً بحزمة تطوير برامج "الأماكن" لنظام التشغيل Android، بالإضافة إلى كيفية التعامل مع التغييرات اللازمة.
تفعيل حزمة تطوير برامج "الأماكن" لأجهزة Android (ميزة جديدة)
تعتمد حزمة تطوير برامج "الأماكن" لنظام التشغيل Android على خدمة Places API. لاستخدام ميزات Places SDK لنظام التشغيل Android (الإصدار الجديد)، عليك أولاً تفعيل Places API (الإصدار الجديد) في مشروعك على Google Cloud. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إعداد مشروعك على Google Cloud.
بعد ذلك، عليك التأكّد من إضافة Places API (الإصدار الجديد) إلى مفتاح واجهة برمجة التطبيقات الذي يستخدمه تطبيقك. لمزيد من المعلومات، يُرجى الاطّلاع على استخدام مفاتيح واجهة برمجة التطبيقات.
التغييرات العامة
تشمل بعض التغييرات العامة التي تنطبق على واجهات برمجة تطبيقات متعددة ما يلي:
يستخدم نموذج أسعار جديدًا. للحصول على معلومات حول أسعار جميع واجهات برمجة التطبيقات، يُرجى الاطّلاع على حزمة SDK لتطبيق "الأماكن" لنظام التشغيل Android (جديد).
يجب استخدام قناع الحقول في تفاصيل الأماكن (ميزة جديدة) والبحث في الأماكن القريبة (ميزة جديدة) والبحث النصي (ميزة جديدة) لتحديد الحقول التي تريد عرضها في الاستجابة.
تمت إضافة فئات جديدة لتحديد الطلبات أو لإضافة حقول جديدة إلى الردّ.
يحتوي عنصر الاستجابة
Place
على الطريقة الجديدةgetReviews()
التي تعرض قائمة بالكائناتReview
. عندما يعرض تطبيقك معلومات تم الحصول عليها منPlace
العنصر، مثل الصور والمراجعات، يجب أن يعرض التطبيق أيضًا الإسنادات المطلوبة.لمزيد من المعلومات، يُرجى الاطّلاع على المستندات المتعلّقة بموضوع الإحالات.
التغييرات المتعلّقة بواجهة برمجة التطبيقات
يتضمّن هذا القسم أدلة نقل البيانات التالية لكل واجهة برمجة تطبيقات: