صور الأماكن (الإصدار القديم)

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

يمكنك استخدام "حزمة تطوير البرامج (SDK) للأماكن" في Android (الإصدار القديم) لطلب صورة مكان لعرضها في تطبيقك. يتم الحصول على الصور التي تعرضها خدمة الصور من مجموعة متنوعة من المصادر، بما في ذلك مالكي المؤسسات والصور التي يساهم بها المستخدمون.

تعرض "حزمة تطوير البرامج (SDK) للأماكن لنظام التشغيل Android (الإصدار القديم)" صورة نقطية بحجم أقصى يبلغ 1600 × 1600 بكسل.

عملية استرداد الصور

لاسترداد صورة لمكان:

  1. استخدِم تفاصيل المكان (الإصدار القديم) لجلب عنصر Place (باستخدام fetchPlace()). تأكَّد من تضمين الحقل Place.Field PHOTO_METADATAS في قائمة الحقول التي يجب تضمينها في عنصر Place للاستجابة.
  2. في OnSuccessListener لـ FetchPlaceResponse، استخدِم Place.getPhotoMetadas() للحصول على عنصر البيانات الوصفية للصورة من النوع PhotoMetadata من عنصر الاستجابة Place.
  3. أنشئ عنصر FetchPhotoRequest، وحدِّد الحد الأقصى للارتفاع والعرض (بالبكسل) إذا أردت ذلك. يمكن أن يبلغ الحد الأقصى لعرض الصور أو ارتفاعها 1600 بكسل.
  4. استخدِم PlacesClient.fetchPhoto() لطلب الصورة النقطية.
  5. أضِف 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 الذي تم عرضه يتضمّن أيًا من نوعَي الإحالة، يجب تضمين الإحالة في تطبيقك في أي مكان تعرض فيه الصورة. لمزيد من المعلومات، يُرجى الاطّلاع على عرض معلومات تحديد المصدر.

الاستخدام والفوترة

يتم تحصيل رسوم رمز التخزين التعريفي Place Photos (Legacy) مقابل طلبات البيانات إلى fetchPhoto(). يُرجى الاطّلاع على صفحة الاستخدام والفوترة لمزيد من التفاصيل.