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