คุณสามารถใช้ Places SDK สำหรับ Android เพื่อขอรูปภาพสถานที่ที่จะแสดงในแอปพลิเคชันของคุณ รูปภาพที่ส่งมาจากบริการรูปภาพนั้นมาจากแหล่งที่มาที่หลากหลาย ซึ่งรวมถึงเจ้าของธุรกิจและรูปภาพที่ผู้ใช้ส่งมา
เลือกรูปแบบรูปภาพ
Places SDK สำหรับ Android รองรับรูปภาพที่ขอ 2 รูปแบบ ดังนี้
- Places SDK ทั้งหมดสำหรับ Android เวอร์ชัน: แสดงผลรูปภาพบิตแมป รูปภาพบิตแมปต้องมีขนาดไม่เกิน 1600 x 1600 พิกเซล
- Places SDK for Android (ใหม่) เวอร์ชัน 3.4 ขึ้นไป: แสดงผล URI ไปยังรูปภาพบิตแมป ภาพบิตแมปต้องมีขนาดไม่เกิน 4800 x 4800 พิกเซล
กระบวนการดึงข้อมูลรูปภาพ
หากต้องการเรียกรูปภาพของสถานที่ ให้ทำดังนี้
- ใช้รายละเอียดสถานที่เพื่อดึงข้อมูลออบเจ็กต์
Place
(ใช้fetchPlace()
หรือfindCurrentPlace()
) ตรวจสอบว่าได้รวมช่องPlace.Field PHOTO_METADATAS
ไว้ในรายการช่องที่จะรวมในออบเจ็กต์Place
ของการตอบกลับแล้ว - ใน
OnSuccessListener
สำหรับFetchPlaceResponse
หรือFindCurrentPlaceResponse
- ใช้
Place.getPhotoMetadas()
เพื่อรับออบเจ็กต์ข้อมูลเมตาของรูปภาพที่ประเภทPhotoMetadata
จากออบเจ็กต์Place
ของการตอบกลับ - วิธีดูรูปภาพบิตแมป
- สร้างออบเจ็กต์
FetchPhotoRequest
โดยจะระบุความสูงและความกว้างสูงสุด (เป็นพิกเซล) หรือไม่ก็ได้ รูปภาพมีความกว้างหรือความสูงได้สูงสุด 1600 พิกเซล - ใช้
PlacesClient.fetchPhoto()
เพื่อขอบิตแมปของรูปภาพ - เพิ่ม
OnSuccessListener
และรับรูปภาพจากFetchPhotoResponse
- สร้างออบเจ็กต์
- วิธีดู URI รูปภาพ
- สร้างออบเจ็กต์
FetchResolvedPhotoUriRequest
เพื่อสร้างคำขอ รูปภาพมีความกว้างหรือความสูงได้สูงสุด 4,800 พิกเซล - ใช้
PlacesClient.fetchResolvedPhotoUri()
เพื่อขอ URI รูปภาพ - เพิ่ม
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
พร้อมการระบุแหล่งที่มาของผู้เขียน คุณต้องดำเนินการดังนี้
- เปิดใช้ SDK ใหม่เมื่อตั้งค่าโปรเจ็กต์ Google Cloud
- เริ่มต้น SDK ใหม่ภายในกิจกรรมหรือ Fragment
- ใส่
Place.Field.PHOTO_METADATAS
ในรายการช่องของคำขอรายละเอียดสถานที่ - เรียก
PlacesClient.fetchPlace()
เพื่อรับออบเจ็กต์Place
และPlace.getPhotoMetadas()
เพื่อรับออบเจ็กต์PhotoMetadata
PlacesClient.findCurrentPlace()
ไม่รองรับช่องการระบุแหล่งที่มาของผู้เขียน - ใช้
PhotoMetadata.getAuthorAttributions()
เพื่อดูการระบุแหล่งที่มาของผู้เขียน
รับรูปภาพ
ส่วนนี้จะอธิบายวิธีการเรียกรูปภาพเป็นบิตแมปหรือเป็น URI
รับรูปภาพสถานที่เป็นบิตแมป
ตัวอย่างต่อไปนี้แสดงการรับรูปภาพสถานที่ในแบบบิตแมป
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. } }); });
รับ 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()
ดูรายละเอียดได้ในหน้าการใช้งานและการเรียกเก็บเงิน