您可以使用 Places SDK for iOS (新版)，要求在應用程式中顯示地點相片。相片服務傳回的相片來自各種來源，包括業主和使用者提供的相片。
相片是以 UIImage 物件表示的點陣圖圖片。點陣圖圖片的尺寸上限為 4800 x 4800 像素。
索取圖片
您最多可為單一地點索取 10 張相片：
呼叫
[GMSPlacesClient lookUpPhotosForPlaceID]，傳遞地點 ID 和GMSPlacePhotoMetadataResultCallback回呼。這項要求會使用GMSPlacePhotoMetadataList物件呼叫GMSPlacePhotoMetadataResultCallback回呼。在回呼中的
GMSPlacePhotoMetadataList物件中，results陣列屬性會包含相片，其中每張相片以GMSPlacePhotoMetadata物件表示。使用
GMSPlacePhotoMetadata物件建立GMSFetchPhotoRequest，包括所要求圖片的大小上限。針對陣列中的每個
GMSPlacePhotoMetadata物件，呼叫[GMSPlacesClient fetchPhotoWithRequest:callback:]傳遞GMSFetchPhotoRequest物件。這個方法會呼叫GMSFetchPhotoResultCallback回呼，並提供可用的點陣圖圖片做為 UIImage。
要求地點相片的另一種方法是發出 Place Details (新版) 要求，包括欄位清單中的 GMSPlacePropertyPhotos。呼叫 Place Details 的好處是，回應 GMSPlace 物件可包含您想用於該地點的相片和其他任何資料欄位。
程式碼範例
下例會擷取地點 ID，並取得傳回清單中的第一張相片。您在自己的應用程式中建立方法時，可以使用此方法做為範本。
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
}
}];
}];
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:] 載入的相片會透過共用的 NSURLCache 中的基礎網址載入系統，在磁碟和記憶體中快取。
如要設定快取行為，您可以在應用程式委派的 application:didFinishLaunchingWithOptions: 方法中使用 [NSURLCache setSharedURLCache:]，變更共用的網址快取。
如果您不希望應用程式與 Places SDK for iOS 共用 NSURLCache，可以建立新的 NSURLCache，然後在應用程式中單獨使用，而不設為共用快取。
出處
在大多數情況下，使用地點相片時無須註明出處，或者圖片會包含必要的作者資訊。不過，如果傳回的 GMSPlacePhotoMetadata 執行個體包含任何 attributions 或 authorAttribution，您就必須在顯示圖片的任何位置，在應用程式中加入這些作者資訊。請參閱歸因說明文件。