รูปภาพสถานที่ (ใหม่) ช่วยให้คุณเพิ่มเนื้อหาภาพถ่ายคุณภาพสูงลงในแอปพลิเคชันของคุณได้ Place Photos ช่วยให้คุณเข้าถึงรูปภาพนับล้านที่เก็บอยู่ใน ฐานข้อมูลของ Places รูปภาพสถานที่ส่งคืน URI ไปยังรูปภาพบิตแมป ภาพบิตแมปมีขนาดสูงสุด 4,800 x 4800 พิกเซล
คำขอรูปภาพสถานที่
วิธีเรียกรูปภาพของสถานที่
- ใช้รายละเอียดสถานที่ (ใหม่) เพื่อดึงข้อมูลออบเจ็กต์
Place
โดยใช้fetchPlace()
อย่าลืมรวมช่องPlace.Field PHOTO_METADATAS
ไว้ในรายการช่องที่จะรวมไว้ในออบเจ็กต์Place
ของการตอบกลับ - ใน
OnSuccessListener
สำหรับFetchPlaceResponse
ให้เรียกใช้Place.getPhotoMetadas()
เพื่อรับออบเจ็กต์ข้อมูลเมตาของรูปภาพประเภทPhotoMetadata
จากออบเจ็กต์Place
ตอบกลับ - สร้างออบเจ็กต์
FetchResolvedPhotoUriRequest
เพื่อสร้างคำขอและส่งออบเจ็กต์ข้อมูลเมตาของรูปภาพ รวมถึงค่าสำหรับความสูงสูงสุด ความกว้างสูงสุด หรือทั้ง 2 อย่าง - ใช้
PlacesClient.fetchResolvedPhotoUri()
เพื่อขอ URI รูปภาพ - เพิ่ม
OnSuccessListener
และรับ URI รูปภาพจากออบเจ็กต์FetchResolvedPhotoUriResponse
พารามิเตอร์ที่จำเป็น
พารามิเตอร์ที่จำเป็นสำหรับ FetchResolvedPhotoUriRequest
มีดังนี้
-
ข้อมูลเมตาของรูปภาพ
ออบเจ็กต์ข้อมูลเมตาของรูปภาพที่จะแสดงผล
-
ความสูงสูงสุดหรือความกว้างสูงสุด
ระบุความสูงและความกว้างสูงสุดของรูปภาพที่ต้องการให้แสดง หน่วยเป็นพิกเซล หากรูปภาพมีขนาดเล็กกว่าค่าที่ระบุ ระบบจะแสดงผลรูปภาพต้นฉบับ หากรูปภาพมีขนาดใหญ่ขึ้นในมิติใดมิติหนึ่ง จะมีการปรับขนาดให้ตรงกับขนาดที่เล็กลงโดยจำกัดไว้ที่สัดส่วนภาพเดิม ทั้งคุณสมบัติความสูงและความกว้างสูงสุดจะยอมรับจำนวนเต็มระหว่าง 1 ถึง 4800 คุณต้องระบุความสูงสูงสุด ความกว้างสูงสุด หรือทั้ง 2 อย่าง
- หากต้องการตั้งค่าพารามิเตอร์ความสูงสูงสุด ให้เรียกเมธอด
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
สามารถระบุแหล่งที่มาเพิ่มเติมได้ 2 ประเภทดังนี้
- การระบุแหล่งที่มา ซึ่งเป็นสตริงการระบุแหล่งที่มาที่
PhotoMetadata.getAttributions()
เข้าถึง - AuthorAttributions ซึ่งเป็นออบเจ็กต์
AuthorAttributions
ที่เข้าถึงได้โดยPhotoMetadata.getAuthorAttributions()
หากออบเจ็กต์ PhotoMetadata
ที่แสดงผลมีแอตทริบิวต์ประเภทใดประเภทหนึ่ง คุณจะต้องใส่การระบุแหล่งที่มาในแอปพลิเคชันของคุณด้วยทุกที่ที่แสดงรูปภาพนั้น สำหรับข้อมูลเพิ่มเติม
ดูการแสดงการระบุแหล่งที่มา