Places SDK for iOS 支援地點相片 (舊版)。如果您熟悉 Place Photo (舊版), Place Photo (新版) 會進行下列變更:
採用新的定價模式。如要瞭解所有 API 的價格資訊,請參閱「Places SDK for iOS (新版) 的價格」。
Place Photo (舊版) 支援的相片大小上限為 1600 x 1600 像素。新版地點相片支援的最大尺寸為 4800 x 4800 像素。
如要發出要求,請呼叫新的
GMSPlacesClient fetchPhotoWithRequest:callback:
方法。傳遞至要求:
新
GMSFetchPhotoRequest
類別的執行個體,定義所有要求參數,包括圖片大小上限。GMSPlacePhotoMetadataResultCallback
類型的回呼,用於處理回應。
每張相片都會以
GMSPlacePhotoMetadata
執行個體表示。對於 Places SDK for iOS (新版),GMSPlacePhotoMetadata
執行個體包含以新GMSPlaceAuthorAttribution
類別表示的新authorAttribution
欄位。如果傳回的
GMSPlacePhotoMetadata
執行個體包含attributions
或authorAttribution
,您每次顯示圖片時就必須在應用程式中加入這些出處資訊。請參閱出處資訊說明文件。
要求範例
下列範例方法會取得地點 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 } }]; }];