يمكنك استخدام Places SDK for Android (الإصدار القديم) لطلب صورة مكان لعرضها في تطبيقك. يتم الحصول على الصور التي تعرضها خدمة الصور من مجموعة متنوعة من المصادر، بما في ذلك مالكو الأنشطة التجارية والصور التي يساهم بها المستخدمون.
تعرض حزمة تطوير البرامج (SDK) القديمة الخاصة بـ Places API لنظام التشغيل Android صورة نقطية يبلغ حجمها الأقصى 1600 × 1600 بكسل.
عملية استرداد الصور
لاسترداد صورة لمكان:
- استخدِم تفاصيل المكان (الإصدار القديم) لجلب عنصر
Place(باستخدامfetchPlace()). احرص على تضمين الحقلPlace.Field PHOTO_METADATASفي قائمة الحقول التي تريد تضمينها في عنصرPlaceللاستجابة. - في
OnSuccessListenerالخاصة بـFetchPlaceResponse، استخدِمPlace.getPhotoMetadas()للحصول على عنصر البيانات الوصفية للصور، من النوعPhotoMetadataمن عنصر الاستجابةPlace. - أنشئ عنصر
FetchPhotoRequest، مع تحديد الحد الأقصى للارتفاع والعرض (بالبكسل) بشكل اختياري. يمكن أن يبلغ الحد الأقصى لعرض الصور أو ارتفاعها 1600 بكسل. - استخدِم
PlacesClient.fetchPhoto()لطلب الصورة النقطية. - أضِف
OnSuccessListenerواحصل على الصورة منFetchPhotoResponse.
الحصول على صورة
يوضّح المثال التالي كيفية الحصول على صورة مكان:
Kotlin
// Define a Place ID. val placeId = PlaceIdProvider.getRandomPlaceId() // Specify fields. Requests for photos must always have the PHOTO_METADATAS field. val fields = listOf(Place.Field.PHOTO_METADATAS) // Get a Place object (this example uses fetchPlace(), but you can also use findCurrentPlace()) val placeRequest = FetchPlaceRequest.newInstance(placeId, fields) placesClient.fetchPlace(placeRequest) .addOnSuccessListener { response: FetchPlaceResponse -> val place = response.place // Get the photo metadata. val metadata = place.photoMetadatas if (metadata == null || metadata.isEmpty()) { Log.w(TAG, "No photo metadata.") return@addOnSuccessListener } val photoMetadata = metadata.first() // Get the attribution text. val attributions = photoMetadata?.attributions binding.placePhotosAttributions.text = attributions // Create a FetchResolvedPhotoUriRequest. val photoRequest = FetchResolvedPhotoUriRequest.builder(photoMetadata) .setMaxWidth(500) // Optional. .setMaxHeight(300) // Optional. .build() placesClient.fetchResolvedPhotoUri(photoRequest) .addOnSuccessListener { fetchPhotoResponse -> val photoUri = fetchPhotoResponse.uri Glide.with(this) .load(photoUri) .into(binding.placePhotosResult) }.addOnFailureListener { exception: Exception -> if (exception is ApiException) { Log.e(TAG, "Place not found: " + exception.message) val statusCode = exception.statusCode // TODO: Handle error with given status code. } } }
جافا
// Define a Place ID. final String placeId = PlaceIdProvider.getRandomPlaceId(); // Specify fields. Requests for photos must always have the PHOTO_METADATAS field. final List<Place.Field> fields = Collections.singletonList(Place.Field.PHOTO_METADATAS); // Get a Place object (this example uses fetchPlace(), but you can also use findCurrentPlace()) final FetchPlaceRequest placeRequest = FetchPlaceRequest.newInstance(placeId, fields); placesClient.fetchPlace(placeRequest).addOnSuccessListener((response) -> { final Place place = response.getPlace(); // Get the photo metadata. final List<PhotoMetadata> metadata = place.getPhotoMetadatas(); if (metadata == null || metadata.isEmpty()) { Log.w(TAG, "No photo metadata."); return; } final PhotoMetadata photoMetadata = metadata.get(0); // Get the attribution text. final String attributions = photoMetadata.getAttributions(); binding.placePhotosAttributions.setText(attributions); // Create a FetchResolvedPhotoUriRequest. final FetchResolvedPhotoUriRequest photoRequest = FetchResolvedPhotoUriRequest.builder(photoMetadata) .setMaxWidth(500) // Optional. .setMaxHeight(300) // Optional. .build(); placesClient.fetchResolvedPhotoUri(photoRequest).addOnSuccessListener((fetchPhotoResponse) -> { Glide.with(this) .load(fetchPhotoResponse.getUri()) .into(binding.placePhotosResult); }).addOnFailureListener((exception) -> { if (exception instanceof ApiException) { ApiException apiException = (ApiException) exception; Log.e(TAG, "Place not found: " + exception.getMessage()); final int statusCode = apiException.getStatusCode(); // TODO: Handle error with given status code. } }); });
عمليات تحديد المصدر
في معظم الحالات، يمكن استخدام صور الأماكن بدون الإشارة إلى المصدر، أو سيتم تضمين الإشارة المطلوبة إلى المصدر كجزء من الصورة. ومع ذلك، يمكن أن يحتوي عنصر البيانات الوصفية للصور، من النوع
PhotoMetadata،
على أحد نوعَي الإشارات الإضافية التالية:
- عمليات تحديد المصدر، وهي سلسلة تحديد مصدر يتم الوصول إليها من خلال
PhotoMetadata.getAttributions() - AuthorAttributions، وهو عنصر
AuthorAttributionsيمكن الوصول إليه من خلالPhotoMetadata.getAuthorAttributions()
إذا كان عنصر PhotoMetadata الذي تم عرضه يتضمّن أيًا من نوعَي الإشارة إلى المصدر، عليك تضمين الإشارة إلى المصدر في تطبيقك في أي مكان تعرض فيه الصورة. لمزيد من المعلومات، راجِع مقالة عرض بيانات المصدر.
الاستخدام والفوترة
يتم تحصيل رسوم رمز التخزين التعريفي صور الأماكن (الإصدار القديم) مقابل طلبات البيانات إلى fetchPhoto().
يمكنك الاطّلاع على صفحة الاستخدام والفوترة للحصول على التفاصيل.