توفّر حزمة تطوير البرامج (SDK) لنظام التشغيل Android (الإصدار الجديد) أداءً محسّنًا وأحد نماذج التسعير الجديدة، ما يجعل من المفيد تحديث التطبيقات التي تستخدم حزمة تطوير البرامج (SDK) لنظام التشغيل 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
العنصر، مثل الصور والمراجعات، يجب أن يعرض التطبيق أيضًا الإسنادات المطلوبة.لمزيد من المعلومات، يُرجى الاطّلاع على المستندات المتعلّقة بموضوع الإحالات.
التغييرات المتعلّقة بواجهة برمجة التطبيقات
يتضمّن هذا القسم أدلة نقل البيانات التالية لكل واجهة برمجة تطبيقات: