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