คุณสามารถใช้ Places SDK สำหรับ iOS (ใหม่) เพื่อขอรูปภาพสถานที่ที่จะแสดงในแอปพลิเคชันของคุณได้ รูปภาพที่ส่งมาจากบริการรูปภาพนั้นมาจากแหล่งที่มาที่หลากหลาย ทั้งเจ้าของธุรกิจและรูปภาพที่ผู้ใช้ส่งมา
รูปภาพเป็นรูปภาพบิตแมปที่แสดงด้วยออบเจ็กต์ UIImage รูปภาพบิตแมปมีขนาดสูงสุด 4,800 x 4800 พิกเซล
ขอรูปภาพ
คุณสามารถขอรูปภาพสถานที่ได้สูงสุด 10 ภาพ
โทรหา
[GMSPlacesClient lookUpPhotosForPlaceID]
โดยส่งรหัสสถานที่และGMSPlacePhotoMetadataResultCallback
Callback คำขอนี้เรียกใช้ CallbackGMSPlacePhotoMetadataResultCallback
ที่มีออบเจ็กต์GMSPlacePhotoMetadataList
จากออบเจ็กต์
GMSPlacePhotoMetadataList
ใน Callback พร็อพเพอร์ตี้อาร์เรย์results
จะมีรูปภาพ โดยที่แต่ละรูปภาพแทนด้วยออบเจ็กต์GMSPlacePhotoMetadata
สำหรับออบเจ็กต์
GMSPlacePhotoMetadata
แต่ละรายการในอาร์เรย์ ให้เรียกใช้[GMSPlacesClient loadPlacePhoto:callback:]
หรือ[GMSPlacesClient loadPlacePhoto:constrainedToSize:scale:callback:]
วิธีการเหล่านี้เรียกใช้ 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 = photos.first else { return } // Request individual photos in the response list let fetchPhotoRequest = GMSFetchPhotoRequest(metadata: photoMetadata, maxSize: CGSizeMake(4800, 4800) placesClient.fetchPhoto(fetchPhotoRequest: fetchPhotoRequest, callback: { (photoURL: URL?, error: Error?) in guard let photoURL, error == nil else { return } print("Photo URL: \(photoURL)") }) };
Objective-C
// A hotel in Saigon with an attribution. NSString *placeID = @"ChIJV4k8_9UodTERU5KXbkYpSYs"; [placesClient lookUpPhotosForPlaceID:placeID callback: (GMSPlacePhotoMetadataList *list, NSError *error) { GMSPlacePhotoMetadata *photoMetadata = [list firstObject]; if (photoMetadata == nil) { return } // Request individual photos in the response list GMSFetchPhotoRequest *fetchPhotoRequest = [[GMSFetchPhotoRequest alloc] initWithPhotoMetadata:photoMetadata maxSize:CGSizeMake(4800, 4800)]; [placesClient fetchPhoto:fetchPhotoRequest, callback: ^(NSURL *_Nullable photoURL, NSError *_Nullable error) { if (error == null) { NSLog(@"Photo URL: %@", photoURL) } }]; }];
GooglePlacesSwift
// 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
คุณต้องใส่การระบุแหล่งที่มาเหล่านี้ในแอปพลิเคชันทุกครั้งที่แสดงรูปภาพดังกล่าว ดูเอกสารเกี่ยวกับ
การระบุแหล่งที่มา