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

اختيار النظام الأساسي: Android iOS خدمة الويب

تتيح لك صور الأماكن (جديد) إضافة محتوى فوتوغرافي عالي الجودة إلى التطبيق. تتيح لك صور الأماكن الوصول إلى ملايين الصور المخزنة في قاعدة بيانات الأماكن. تعرض ميزة "صور المكان" معرِّف الموارد المنتظم (URI) لصورة نقطية. الصورة النقطية يبلغ حجم الصورة 4800 × 4800 بكسل كحدّ أقصى.

طلبات "صور الأماكن"

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

  1. استخدِم تفاصيل المكان (جديد) لجلب عنصر Place باستخدام fetchPlace() تأكَّد من تضمين الحقل Place.Field PHOTO_METADATAS في قائمة الحقول تضمين في كائن Place الردّ.
  2. في جلسة المعمل، OnSuccessListener لـ FetchPlaceResponse، اتصل بالرقم Place.getPhotoMetadas() للحصول على كائن البيانات الوصفية للصور من النوع PhotoMetadata من كائن الاستجابة Place.
  3. يمكنك إنشاء عنصر FetchResolvedPhotoUriRequest لإنشاء الطلب وتمرير كائن البيانات الوصفية للصورة، بالإضافة إلى قيم الحد الأقصى للارتفاع أو الحد الأقصى للعرض أو كليهما.
  4. استخدام PlacesClient.fetchResolvedPhotoUri() لطلب عنوان URI للصورة.
  5. إضافة OnSuccessListener والحصول على عنوان URI للصورة من FetchResolvedPhotoUriResponse الخاص بك.

المعلمات المطلوبة

المعلمات المطلوبة FetchResolvedPhotoUriRequest هي:

  • البيانات الوصفية للصور

    كائن البيانات الوصفية للصورة المطلوب عرضه.

  • الحد الأقصى للارتفاع أو الحد الأقصى للعرض

    تحدِّد الحد الأقصى لارتفاع وعرض الصورة بالبكسل المطلوب عرضها. إذا كانت الصورة أصغر من القيم المحددة، فسيتم عرض الصورة الأصلية. وإذا كانت الصورة أكبر في أي بُعد، سيتم تغيير حجمها لتتطابق مع حجم الصورة الأصغر حجمًا، أي مع نسبة العرض إلى الارتفاع الأصلية. تقبل كل من خاصيتي الارتفاع والحد الأقصى للعرض عددًا صحيحًا بين 1 و4800. يجب تحديد الحد الأقصى للارتفاع أو الحد الأقصى للعرض أو كليهما.

    • لضبط الحد الأقصى للارتفاع، يمكنك طلب الطريقة setMaxHeight() عند إنشاء الكائن FetchResolvedPhotoUriRequest.
    • لضبط مَعلمة الحدّ الأقصى للعرض، يمكنك طلب الطريقة setMaxWidth() عند إنشاء الكائن FetchResolvedPhotoUriRequest.

أمثلة على صور الأماكن

يوضح المثال التالي الحصول على عنوان URI لصورة المكان.

// 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 and author attributions.
    final String attributions = photoMetadata.getAttributions();
    final AuthorAttributions authorAttributions = photoMetadata.getAuthorAttributions();

    // Create a FetchResolvedPhotoUriRequest.
    final FetchResolvedPhotoUriRequest photoRequest = FetchResolvedPhotoUriRequest.builder(photoMetadata)
        .setMaxWidth(500)
        .setMaxHeight(300)
        .build();

    // Request the photo URI
    placesClient.fetchResolvedPhotoUri(photoRequest).addOnSuccessListener((fetchResolvedPhotoUriResponse) -> {
        Uri uri = fetchResolvedPhotoUriResponse.getUri();
        RequestOptions requestOptions = new RequestOptions().override(Target.SIZE_ORIGINAL);
        Glide.with(this).load(uri).apply(requestOptions).into(imageView);
    }).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 المعروض يتضمّن أيًّا من نوعَي تحديد المصدر، عليك تضمين الإسناد في تطبيقك أينما تعرض الصورة. لمزيد من المعلومات راجع عرض عمليات تحديد المصدر.