صور المكان

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

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

تعرض حزمة تطوير البرامج Places 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 = "INSERT_PLACE_ID_HERE"

// 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 metada = place.photoMetadatas
        if (metada == null || metada.isEmpty()) {
            Log.w(TAG, "No photo metadata.")
            return@addOnSuccessListener
        }
        val photoMetadata = metada.first()

        // Get the attribution text.
        val attributions = photoMetadata?.attributions

        // Create a FetchPhotoRequest.
        val photoRequest = FetchPhotoRequest.builder(photoMetadata)
            .setMaxWidth(500) // Optional.
            .setMaxHeight(300) // Optional.
            .build()
        placesClient.fetchPhoto(photoRequest)
            .addOnSuccessListener { fetchPhotoResponse: FetchPhotoResponse ->
                val bitmap = fetchPhotoResponse.bitmap
                imageView.setImageBitmap(bitmap)
            }.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.")
                }
            }
    }

Java

// Define a Place ID.
final String placeId = "INSERT_PLACE_ID_HERE";

// 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();

    // Create a FetchPhotoRequest.
    final FetchPhotoRequest photoRequest = FetchPhotoRequest.builder(photoMetadata)
        .setMaxWidth(500) // Optional.
        .setMaxHeight(300) // Optional.
        .build();
    placesClient.fetchPhoto(photoRequest).addOnSuccessListener((fetchPhotoResponse) -> {
        Bitmap bitmap = fetchPhotoResponse.getBitmap();
        imageView.setImageBitmap(bitmap);
    }).addOnFailureListener((exception) -> {
        if (exception instanceof ApiException) {
            final 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 الذي تم عرضه يتضمّن أيًا من نوعَي نَسْب العمل، عليك تضمين معلومات نَسْب العمل في تطبيقك في أي مكان تعرض فيه الصورة. لمزيد من المعلومات، راجِع مقالة عرض بيانات المصدر.

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

يتم تحصيل رسوم رمز التخزين التعريفي Places Photo مقابل طلبات البيانات إلى fetchPhoto(). راجِع صفحة الاستخدام والفوترة للحصول على التفاصيل.