คุณสามารถใช้ Places SDK สำหรับ iOS (ใหม่) เพื่อขอรูปภาพสถานที่ไปยัง แสดงในแอปพลิเคชัน รูปภาพที่บริการรูปภาพแสดงผลมาจากแหล่งที่มาที่หลากหลาย ซึ่งรวมถึงเจ้าของธุรกิจและรูปภาพที่ผู้ใช้ส่งเข้ามา
รูปภาพคือรูปภาพบิตแมปที่แสดงโดยออบเจ็กต์ UIImage รูปภาพบิตแมปมีขนาดสูงสุด 4,800 x 4800 พิกเซล
ขอรูปภาพ
คุณสามารถขอรูปภาพสถานที่ได้สูงสุด 10 ภาพ
โทร
[GMSPlacesClient lookUpPhotosForPlaceID]
การส่งรหัสสถานที่และ การติดต่อกลับGMSPlacePhotoMetadataResultCallback
คำขอนี้เรียก CallbackGMSPlacePhotoMetadataResultCallback
ที่มีGMSPlacePhotoMetadataList
ออบเจ็กต์จากออบเจ็กต์
GMSPlacePhotoMetadataList
ใน Callback แอตทริบิวต์results
พร็อพเพอร์ตี้อาร์เรย์ประกอบด้วยรูปภาพ ซึ่งแต่ละรูปจะแสดงด้วยGMSPlacePhotoMetadata
ออบเจ็กต์ใช้ออบเจ็กต์
GMSPlacePhotoMetadata
เพื่อสร้างGMSFetchPhotoRequest
รวมถึงระบุขนาดสูงสุดของรูปภาพที่ขอสำหรับออบเจ็กต์
GMSPlacePhotoMetadata
แต่ละรายการในอาร์เรย์ ให้เรียก[GMSPlacesClient fetchPhotoWithRequest:callback:]
กำลังส่งออบเจ็กต์GMSFetchPhotoRequest
เมธอดนี้เรียกเมธอดGMSFetchPhotoResultCallback
Callback ที่มีรูปภาพบิตแมปที่ใช้ได้เป็น UIImage
อีกวิธีในการขอรูปภาพสำหรับสถานที่หนึ่งๆ คือการส่งคำขอรายละเอียดสถานที่ (ใหม่) โดยระบุ GMSPlacePropertyPhotos
ในรายการช่อง ข้อดีของการสร้าง
การตอบกลับว่า "รายละเอียดสถานที่"
GMSPlace
สามารถมีรูปภาพและฟิลด์ข้อมูลอื่นๆ ที่คุณต้องการ
สถานที่นั้น
โค้ดตัวอย่าง
วิธีการตัวอย่างต่อไปนี้จะใช้รหัสสถานที่และได้รับรูปภาพแรกใน รายการที่ส่งคืน คุณสามารถใช้เมธอดนี้เป็นเทมเพลตสำหรับเมธอดที่คุณจะ สร้างในแอปของคุณเอง
Swift
// A hotel in Saigon with an attribution. let placeID = "ChIJV4k8_9UodTERU5KXbkYpSYs" // Request list of photos for a place placesClient.lookUpPhotos(forPlaceID: placeID) { (photos, error) in guard let photoMetadata: GMSPlacePhotoMetadata = photos?.results[0] else { return } // Request individual photos in the response list let fetchPhotoRequest = GMSFetchPhotoRequest(photoMetadata: photoMetadata, maxSize: CGSizeMake(4800, 4800)) self.client.fetchPhoto(with: fetchPhotoRequest, callback: { (photoImage: UIImage?, error: Error?) in guard let photoImage, error == nil else { print("Handle photo error: ") return } print("Display photo Image: ") } ) }
Objective-C
// A hotel in Saigon with an attribution. NSString *placeID = @"ChIJV4k8_9UodTERU5KXbkYpSYs"; [placesClient lookUpPhotosForPlaceID:placeID callback: ^(GMSPlacePhotoMetadataList *list, NSError *error) { GMSPlacePhotoMetadata *photoMetadata = [list results][0]; // Request individual photos in the response list GMSFetchPhotoRequest *fetchPhotoRequest = [[GMSFetchPhotoRequest alloc] initWithPhotoMetadata:photoMetadata maxSize:CGSizeMake(4800, 4800)]; [placesClient fetchPhotoWithRequest:fetchPhotoRequest callback: ^(UIImage *_Nullable photoImage, NSError *_Nullable error) { if (error == nil) { // Display photo } }]; }];
Places Swift SDK สำหรับ iOS (เวอร์ชันตัวอย่าง)
// First fetch place details // A hotel in Saigon with an attribution. let placeID = "ChIJV4k8_9UodTERU5KXbkYpSYs" let fetchPlaceRequest = FetchPlaceRequest( placeID: placeID, placeProperties: [ . name, .website ] ) var fetchedPlace: Place switch await placesClient.fetchPlace(with: fetchPlaceRequest) { case .success(let place): fetchedPlace = place case .failure(let placesError): // Handle error } // Use the place details to fetch a photo's image. guard let photo = fetchedPlace.photos?.first else { // Handle place without photos. } let fetchPhotoRequest = FetchPhotoRequest(photo: photo, maxSize: CGSizeMake(4800, 4800)) switch await placesClient.fetchPhoto(with: fetchPhotoRequest) { case .success(let uiImage): // Handle image. case .failure(let placesError): // Handle error }
การแคช
รูปภาพโหลดโดยใช้ [GMSPlacesClient loadPlacePhoto:callback:]
หรือ [GMSPlacesClient loadPlacePhoto:constrainedToSize:scale:callback:]
มีการแคชทั้งบนดิสก์และในหน่วยความจำโดยระบบการโหลด URL พื้นฐาน
ใน NSURLCache
ที่แชร์
หากต้องการกำหนดค่าลักษณะการแคช คุณสามารถเปลี่ยนแคชของ URL ที่แชร์ได้โดยใช้
[NSURLCache setSharedURLCache:]
ใน application:didFinishLaunchingWithOptions:
ของตัวแทนแอปพลิเคชัน
หากไม่ต้องการให้แอปพลิเคชันแชร์ NSURLCache
กับ
Places SDK สำหรับ iOS คุณสามารถสร้าง NSURLCache
ใหม่และใช้
ภายในแอปของคุณเท่านั้นโดยไม่ตั้งค่าเป็นแคชที่แชร์
การระบุแหล่งที่มา
ในกรณีส่วนใหญ่ รูปภาพสถานที่สามารถใช้ได้โดยไม่ต้องมีที่มา หรือจะมี
จำเป็นต้องมีการแสดงที่มาไว้เป็นส่วนหนึ่งของรูปภาพ อย่างไรก็ตาม หากอินสแตนซ์GMSPlacePhotoMetadata
ที่แสดงผลมีattributions
หรือauthorAttribution
คุณต้องใส่การระบุแหล่งที่มาเหล่านี้ในแอปพลิเคชันทุกที่ที่คุณแสดงรูปภาพ ดูเอกสารใน
การระบุแหล่งที่มา