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

المطوّرون في المنطقة الاقتصادية الأوروبية

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

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

  • تعرض طريقة Place Photo (القديمة) صورة نقطية. تعرض طريقة Place Photo (جديدة) معرّف URI للصورة.

  • كانت ميزة "وضع الصور" (الإصدار القديم) تتيح الحد الأقصى لحجم الصورة وهو 1600 × 1600 بكسل. تتيح ميزة "صورة المكان" (جديدة) أحجامًا تصل إلى 4800 × 4800 بكسل.

  • لتقديم طلب، اتّصِل بالطريقة الجديدة PlacesClient.fetchResolvedPhotoUri().

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

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

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

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

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

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

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

للاطّلاع على مثال كامل، راجِع صور الأماكن (جديد).