รูปภาพสถานที่

คุณสามารถใช้ Places SDK สำหรับ Android เพื่อขอรูปภาพสถานที่ที่จะแสดงในแอปพลิเคชันของคุณ รูปภาพที่ส่งมาจากบริการรูปภาพนั้นมาจากแหล่งที่มาที่หลากหลาย ซึ่งรวมถึงเจ้าของธุรกิจและรูปภาพที่ผู้ใช้ส่งมา

เลือกรูปแบบรูปภาพ

Places SDK สำหรับ Android รองรับรูปภาพที่ขอ 2 รูปแบบ ดังนี้

• Places SDK ทั้งหมดสำหรับ Android เวอร์ชัน: แสดงผลรูปภาพบิตแมป รูปภาพบิตแมปต้องมีขนาดไม่เกิน 1600 x 1600 พิกเซล
• Places SDK for Android (ใหม่) เวอร์ชัน 3.4 ขึ้นไป: แสดงผล URI ไปยังรูปภาพบิตแมป ภาพบิตแมปต้องมีขนาดไม่เกิน 4800 x 4800 พิกเซล

กระบวนการดึงข้อมูลรูปภาพ

หากต้องการเรียกรูปภาพของสถานที่ ให้ทำดังนี้

1. ใช้รายละเอียดสถานที่เพื่อดึงข้อมูลออบเจ็กต์ Place (ใช้ fetchPlace() หรือ findCurrentPlace()) ตรวจสอบว่าได้รวมช่อง Place.Field PHOTO_METADATAS ไว้ในรายการช่องที่จะรวมในออบเจ็กต์ Place ของการตอบกลับแล้ว
2. ใน OnSuccessListener สำหรับ FetchPlaceResponse หรือ FindCurrentPlaceResponse
   1. ใช้ Place.getPhotoMetadas() เพื่อรับออบเจ็กต์ข้อมูลเมตาของรูปภาพที่ประเภท PhotoMetadata จากออบเจ็กต์ Place ของการตอบกลับ
   2. วิธีดูรูปภาพบิตแมป
      1. สร้างออบเจ็กต์ FetchPhotoRequest โดยจะระบุความสูงและความกว้างสูงสุด (เป็นพิกเซล) หรือไม่ก็ได้ รูปภาพมีความกว้างหรือความสูงได้สูงสุด 1600 พิกเซล
      2. ใช้ PlacesClient.fetchPhoto() เพื่อขอบิตแมปของรูปภาพ
      3. เพิ่ม OnSuccessListener และรับรูปภาพจาก FetchPhotoResponse
   3. วิธีดู URI รูปภาพ
      1. สร้างออบเจ็กต์ FetchResolvedPhotoUriRequest เพื่อสร้างคำขอ รูปภาพมีความกว้างหรือความสูงได้สูงสุด 4,800 พิกเซล
      2. ใช้ PlacesClient.fetchResolvedPhotoUri() เพื่อขอ URI รูปภาพ
      3. เพิ่ม OnSuccessListener และรับ URI รูปภาพจากออบเจ็กต์ FetchResolvedPhotoUriResponse

เข้าถึงข้อมูล PhotoMetadata ที่เพิ่มในเวอร์ชัน 3.3.0 ขึ้นไป

Places SDK สำหรับ Android (ใหม่) จะเพิ่มช่อง AuthorAttributions ลงในคลาส PhotoMetadata หากแอปเปิดใช้ SDK ใหม่ ออบเจ็กต์ PhotoMetadata ที่แสดงผลโดย Place.getPhotoMetadas() อาจมีการระบุแหล่งที่มาของผู้เขียนอย่างน้อย 1 รายการ

เมื่อออบเจ็กต์ PhotoMetadata มีการระบุแหล่งที่มาใดก็ตาม ไม่ว่าจะเป็นการระบุแหล่งที่มาของผู้แต่งใหม่ในเวอร์ชัน 3.3.0 หรือการระบุแหล่งที่มาที่มีอยู่ซึ่งมีอยู่ในเวอร์ชัน 3.2.0 และก่อนหน้า คุณจะต้องแสดงการระบุแหล่งที่มาดังกล่าวพร้อมรูปภาพ ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการการระบุแหล่งที่มาทุกประเภทได้ที่การระบุแหล่งที่มา

หากต้องการเติมข้อมูลออบเจ็กต์ PhotoMetadata พร้อมการระบุแหล่งที่มาของผู้เขียน คุณต้องดำเนินการดังนี้

1. เปิดใช้ SDK ใหม่เมื่อตั้งค่าโปรเจ็กต์ Google Cloud
2. เริ่มต้น SDK ใหม่ภายในกิจกรรมหรือ Fragment
3. ใส่ Place.Field.PHOTO_METADATAS ในรายการช่องของคำขอรายละเอียดสถานที่
4. เรียก PlacesClient.fetchPlace() เพื่อรับออบเจ็กต์ Place และ Place.getPhotoMetadas() เพื่อรับออบเจ็กต์ PhotoMetadata PlacesClient.findCurrentPlace() ไม่รองรับช่องการระบุแหล่งที่มาของผู้เขียน
5. ใช้ PhotoMetadata.getAuthorAttributions() เพื่อดูการระบุแหล่งที่มาของผู้เขียน

รับรูปภาพ

ส่วนนี้จะอธิบายวิธีการเรียกรูปภาพเป็นบิตแมปหรือเป็น URI

รับรูปภาพสถานที่เป็นบิตแมป

ตัวอย่างต่อไปนี้แสดงการรับรูปภาพสถานที่ในแบบบิตแมป

// 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.")
                }
            }
    }

      

// 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.
        }
    });
});

      

รับ URI รูปภาพสถานที่

ตัวอย่างต่อไปนี้แสดงการรับ 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.
    final String attributions = photoMetadata.getAttributions();

    // Create a FetchResolvedPhotoUriRequest.
    final FetchResolvedPhotoUriRequest photoRequest = FetchResolvedPhotoUriRequest.builder(photoMetadata)
        .setMaxWidth(500) // Optional.
        .setMaxHeight(300) // Optional.
        .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 อาจมีการระบุแหล่งที่มาเพิ่มเติมอย่างใดอย่างหนึ่งใน 2 ประเภทต่อไปนี้

• Attributions ซึ่งเป็นสตริงการระบุแหล่งที่มาที่ PhotoMetadata.getAttributions() เข้าถึง
• AuthorAttributions ซึ่งเป็นออบเจ็กต์ AuthorAttributions ที่ PhotoMetadata.getAuthorAttributions() เข้าถึง

หากออบเจ็กต์ PhotoMetadata ที่แสดงผลมีการระบุแหล่งที่มาประเภทใดก็ตาม คุณต้องรวมการระบุแหล่งที่มาไว้ในแอปพลิเคชันด้วยทุกที่ที่แสดงรูปภาพ ดูข้อมูลเพิ่มเติมได้ที่การแสดงการระบุแหล่งที่มา

การใช้งานและการเรียกเก็บเงิน

จะมีการเรียกเก็บเงิน SKU ของ Places Photo สำหรับการโทรไปที่ fetchPhoto() ดูรายละเอียดได้ในหน้าการใช้งานและการเรียกเก็บเงิน