تتوافق حزمة تطوير برامج الأماكن لأجهزة Android مع صورة المكان الحالية. إذا كنت على دراية بالميزات الحالية في "صورة المكان"، يُجري الإصدار الجديد من "صورة المكان" التغييرات التالية:
يستخدم نموذج أسعار جديدًا. للحصول على معلومات حول أسعار جميع واجهات برمجة التطبيقات، يُرجى الاطّلاع على حزمة SDK لتطبيق "الأماكن" لنظام التشغيل Android (جديد).
تعرض "صورة المكان" الحالية صورة نقطية. تعرِض السمة Place Photo (جديد) معرّفًا موحّدًا للموارد (URI) للصورة.
كانت "صورة المكان" الحالية تتيح استخدام صور بحجم 1600 × 1600 بكسل كحد أقصى. تتيح ميزة "صورة المكان" (الإصدار الجديد) استخدام أحجام تصل إلى 4800 × 4800 بكسل.
لتقديم طلب، يمكنك استدعاء الأسلوب الجديد
PlacesClient.fetchResolvedPhotoUri().لا يمكنك طلب الطريقة
PlacesClient.fetchPhoto()إلا إذا فعّلت Places API. لا تتوفّر هذه الطريقة عند تفعيل Places API (الإصدار الجديد) فقط.لمزيد من المعلومات، يُرجى الاطّلاع على استخدام مفاتيح واجهة برمجة التطبيقات.
نقْل إلى الطلب عنصرًا من فئة
FetchResolvedPhotoUriRequestالجديدة.يتم تمثيل كل صورة في الاستجابة باستخدام كائن
PhotoMetadata. بالنسبة إلى حزمة Places SDK لنظام التشغيل Android (الإصدار الجديد)، يحتوي العنصرPhotoMetadataعلى أسلوبPhotoMetadata.getAuthorAttributions()جديد يعرض عنصرًا من النوعAuthorAttributions.إذا كان عنصر
PhotoMetadataالذي تم إرجاعه يتضمّن أيّ إحالات أو إحالة مؤلف، يجب تضمين هذه الإحالات في تطبيقك أينما عرضت الصورة. راجِع المستندات حول عمليات تحديد المصدر.للوصول إلى معلومات الإسناد الجديدة للمؤلفين في
PhotoMetadata، عليك بدء تطبيقك من خلال استدعاء الأسلوبPlaces.initializeWithNewPlacesApiEnabled(). لمزيد من المعلومات عن اختيار خدمة Places API، يُرجى الاطّلاع على مقالة إعداد مشروعك على Google Cloud.
مثال على الطلب
للاطّلاع على مثال كامل، يُرجى الاطّلاع على مقالة وضع صورة (جديد).