คุณสามารถใช้ Places SDK สำหรับ Android เพื่อขอรูปภาพสถานที่เพื่อ แสดงในแอปพลิเคชัน รูปภาพที่บริการรูปภาพส่งคืนมาจาก แหล่งข้อมูลที่หลากหลาย ซึ่งรวมถึงเจ้าของธุรกิจและรูปภาพที่ผู้ใช้ส่งมา
Places SDK สำหรับ Android จะแสดงภาพบิตแมปที่มีขนาดสูงสุด ขนาด 1600 x 1600 พิกเซล
กระบวนการเรียกดูรูปภาพ
วิธีเรียกรูปภาพของสถานที่
- ใช้รายละเอียดสถานที่เพื่อเรียกออบเจ็กต์
Place
(ใช้อย่างใดอย่างหนึ่งfetchPlace()
หรือfindCurrentPlace()
) ตรวจสอบว่าได้รวมช่องPlace.Field PHOTO_METADATAS
ไว้ในรายการช่องเพื่อ รวมในออบเจ็กต์Place
การตอบสนอง - ใน
OnSuccessListener
สำหรับFetchPlaceResponse
หรือFindCurrentPlaceResponse
ใช้Place.getPhotoMetadas()
เพื่อรับวัตถุข้อมูลเมตาของรูปภาพ ชนิดPhotoMetadata
จากออบเจ็กต์Place
การตอบสนอง - สร้างออบเจ็กต์
FetchPhotoRequest
(ไม่บังคับ) ระบุความสูงและความกว้างสูงสุด (เป็นพิกเซล) รูปภาพสามารถมี มีความกว้างหรือความสูงได้ไม่เกิน 1600 พิกเซล - ใช้
PlacesClient.fetchPhoto()
เพื่อขอบิตแมปรูปภาพ - เพิ่ม
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
สามารถมีการระบุแหล่งที่มาเพิ่มเติมประเภทใดประเภทหนึ่งจาก 2 ประเภท
- การระบุแหล่งที่มา ซึ่งเป็นสตริงการระบุแหล่งที่มาที่เข้าถึงโดย
PhotoMetadata.getAttributions()
- AuthorAttributions
AuthorAttributions
เข้าถึงโดยPhotoMetadata.getAuthorAttributions()
หากออบเจ็กต์ PhotoMetadata
ที่แสดงผลมีแอตทริบิวต์อย่างใดอย่างหนึ่ง คุณต้อง
ระบุแหล่งที่มาในแอปพลิเคชันของคุณในทุกที่ที่คุณแสดงภาพ สำหรับข้อมูลเพิ่มเติม
ดูการแสดงการระบุแหล่งที่มา
การใช้งานและการเรียกเก็บเงิน
ระบบจะเรียกเก็บเงิน SKU ของ Places Photo สำหรับการโทรไปยัง fetchPhoto()
ดูรายละเอียดได้ที่หน้าการใช้งานและการเรียกเก็บเงิน