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

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

Places SDK สำหรับ Android จะแสดงผลรูปภาพบิตแมปขนาดสูงสุด 1600 x 1600 พิกเซล

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

วิธีเรียกข้อมูลรูปภาพสำหรับสถานที่

1. ใช้รายละเอียดสถานที่เพื่อดึงข้อมูลออบเจ็กต์ Place (ใช้ fetchPlace() หรือ findCurrentPlace()) อย่าลืมใส่ช่อง Place.Field PHOTO_METADATAS ในรายการช่องที่จะรวมไว้ในออบเจ็กต์ Place ของคำตอบ
2. ใน OnSuccessListener สำหรับ FetchPlaceResponse หรือ FindCurrentPlaceResponse ให้ใช้ Place.getPhotoMetadas() เพื่อรับออบเจ็กต์ข้อมูลเมตาของรูปภาพประเภท PhotoMetadata จากออบเจ็กต์ Place ของการตอบกลับ
3. สร้างออบเจ็กต์ FetchPhotoRequest โดยระบุความสูงและความกว้างสูงสุด (เป็นพิกเซล) (ไม่บังคับ) รูปภาพมีความกว้างหรือสูงได้สูงสุด 1,600 พิกเซล
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.
        }
    });
});

      

หมายเหตุ: ดูข้อมูลเพิ่มเติมเกี่ยวกับการเริ่มต้น PlacesClient ได้ที่เริ่มต้นไคลเอ็นต์ Places API

คุณสามารถใช้ CancellationToken เพื่อพยายามยกเลิกคำขอไปยังคลาสคำขอใดก็ได้ (เช่น FetchPlaceRequest) การยกเลิกจะดำเนินการอย่างดีที่สุด เมื่อส่งคำขอยกเลิกแล้ว ระบบจะไม่แสดงการตอบกลับ การออกโทเค็นการยกเลิกไม่ได้รับประกันว่าคำขอหนึ่งๆ จะถูกยกเลิก และระบบอาจยังคงเรียกเก็บเงินสำหรับคำขอนั้นแม้ว่าจะไม่มีการตอบกลับก็ตาม

การระบุแหล่งที่มา

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

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

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

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

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