نقل إلى صورة المكان (جديد)

تتوافق حزمة تطوير البرامج (SDK) لنظام التشغيل Android مع صورة المكان الحالية. إذا كنت على دراية بالميزات الحالية في "صورة المكان"، يُجري الإصدار الجديد من "صورة المكان" التغييرات التالية:

  • يستخدم نموذج أسعار جديدًا. للحصول على معلومات حول أسعار جميع واجهات برمجة التطبيقات، يُرجى الاطّلاع على حزمة تطوير البرامج (SDK) لنظام التشغيل Android من Places (جديد).

  • تعرض "صورة المكان" الحالية صورة نقطية. تُعرِض سمة "صورة المكان (جديد)" معرّفًا لمورد منتظم (URI) للصورة.

  • كانت الصورة الحالية للمكان تتيح استخدام صور بحجم 1600 x ‏1600 بكسل كحد أقصى. تتيح ميزة "وضع صورة" (جديد) استخدام أحجام تصل إلى 4,800 × 4,800 بكسل.

  • لتقديم طلب، يمكنك استدعاء الأسلوب الجديد PlacesClient.fetchResolvedPhotoUri().

  • لا يمكنك استدعاء الأسلوب PlacesClient.fetchPhoto() إلا إذا فعّلت Places API. لا تتوفّر هذه الطريقة عند تفعيل Places API (الإصدار الجديد) فقط.

    لمزيد من المعلومات، يُرجى الاطّلاع على استخدام مفاتيح واجهة برمجة التطبيقات.

  • نقْل عنصر من فئة FetchResolvedPhotoUriRequest الجديدة إلى الطلب.

  • يتم تمثيل كل صورة في الاستجابة بعنصر PhotoMetadata. بالنسبة إلى حزمة تطوير البرامج (SDK) بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android (الإصدار الجديد)، يحتوي العنصر PhotoMetadata على أسلوب جديد PhotoMetadata.getAuthorAttributions() يعرض عنصرًا من النوع AuthorAttributions.

    إذا كان عنصر PhotoMetadata المعروض يتضمّن أيّ إحالات أو إحالة مؤلف، يجب تضمين هذه الإحالات في تطبيقك أينما عرضت الصورة. راجِع المستندات حول عمليات تحديد المصدر.

  • للوصول إلى الإحالات الجديدة للمؤلفين في PhotoMetadata، عليك بدء تطبيقك من خلال استدعاء الأسلوب Places.initializeWithNewPlacesApiEnabled(). لمزيد من المعلومات عن اختيار خدمة Places API، يُرجى الاطّلاع على مقالة إعداد مشروعك على Google Cloud.

مثال على الطلب

للحصول على مثال كامل، يُرجى الاطّلاع على مقالة إضافة صورة مكان (ميزة جديدة).