รูปภาพสถานที่ (ใหม่)

คุณสามารถใช้ Places SDK สำหรับ iOS (ใหม่) เพื่อขอรูปภาพสถานที่ที่จะแสดงในแอปพลิเคชันของคุณได้ รูปภาพที่ส่งมาจากบริการรูปภาพนั้นมาจากแหล่งที่มาที่หลากหลาย ทั้งเจ้าของธุรกิจและรูปภาพที่ผู้ใช้ส่งมา

รูปภาพเป็นรูปภาพบิตแมปที่แสดงด้วยออบเจ็กต์ UIImage รูปภาพบิตแมปมีขนาดสูงสุด 4,800 x 4800 พิกเซล

ขอรูปภาพ

คุณสามารถขอรูปภาพสถานที่ได้สูงสุด 10 ภาพ

1. โทรหา [GMSPlacesClient lookUpPhotosForPlaceID] โดยส่งรหัสสถานที่และ GMSPlacePhotoMetadataResultCallback Callback คำขอนี้เรียกใช้ Callback GMSPlacePhotoMetadataResultCallback ที่มีออบเจ็กต์ GMSPlacePhotoMetadataList

2. จากออบเจ็กต์ GMSPlacePhotoMetadataList ใน Callback พร็อพเพอร์ตี้อาร์เรย์ results จะมีรูปภาพ โดยที่แต่ละรูปภาพแทนด้วยออบเจ็กต์ GMSPlacePhotoMetadata

3. สำหรับออบเจ็กต์ GMSPlacePhotoMetadata แต่ละรายการในอาร์เรย์ ให้เรียกใช้ [GMSPlacesClient loadPlacePhoto:callback:] หรือ [GMSPlacesClient loadPlacePhoto:constrainedToSize:scale:callback:] วิธีการเหล่านี้เรียกใช้ Callback ที่มีรูปภาพบิตแมปที่ใช้ได้เป็น UIImage

อีกวิธีหนึ่งในการขอรูปภาพของสถานที่คือการขอรายละเอียดสถานที่ (ใหม่) โดยรวม GMSPlacePropertyPhotos ในรายการช่องด้วย ข้อดีของการเรียก รายละเอียดสถานที่คือออบเจ็กต์ GMSPlace การตอบกลับจะมีรูปภาพและช่องข้อมูลอื่นๆ ที่คุณต้องการสำหรับ สถานที่นั้นๆ

รหัสตัวอย่าง

วิธีการตัวอย่างต่อไปนี้จะใช้รหัสสถานที่และรับรูปภาพแรกในรายการที่ส่งคืน คุณสามารถใช้วิธีการนี้เป็นเทมเพลตสำหรับวิธีสร้างในแอปของคุณเอง

// 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)")
  })
};

// 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)
    }
  }];
}];

// 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 คุณต้องใส่การระบุแหล่งที่มาเหล่านี้ในแอปพลิเคชันทุกครั้งที่แสดงรูปภาพดังกล่าว ดูเอกสารเกี่ยวกับ การระบุแหล่งที่มา