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