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

เลือกแพลตฟอร์ม: Android iOS บริการบนเว็บ

นักพัฒนาแอปในเขตเศรษฐกิจยุโรป (EEA)

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

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

ขอรูปภาพ

คุณขอรูปภาพสำหรับสถานที่ได้สูงสุด 10 รูป โดยทำดังนี้

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

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

  3. ใช้ออบเจ็กต์ GMSPlacePhotoMetadata เพื่อสร้าง GMSFetchPhotoRequest รวมถึงขนาดสูงสุดของรูปภาพที่ขอ

  4. สำหรับออบเจ็กต์ GMSPlacePhotoMetadata แต่ละรายการในอาร์เรย์ ให้เรียกใช้ [GMSPlacesClient fetchPhotoWithRequest:callback:] โดยส่งออบเจ็กต์ GMSFetchPhotoRequest เมธอดนี้เรียกใช้แฮนเดิล GMSFetchPhotoResultCallback พร้อมรูปภาพบิตแมปที่ใช้ได้เป็น UIImage

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

โค้ดตัวอย่าง

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

Places Swift SDK

// 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
}

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

การแคช

[GMSPlacesClient loadPlacePhoto:callback:] หรือ [GMSPlacesClient loadPlacePhoto:constrainedToSize:scale:callback:] จะแคชรูปภาพที่โหลดโดยใช้ทั้งในดิสก์และในหน่วยความจำโดยระบบการโหลด URL ของ Foundation ใน NSURLCache ที่แชร์

หากต้องการกำหนดค่าลักษณะการทำงานของการแคช คุณสามารถเปลี่ยนแคช URL ที่แชร์ได้โดยใช้ [NSURLCache setSharedURLCache:] ในเมธอด application:didFinishLaunchingWithOptions: ของตัวแทนแอปพลิเคชัน

หากไม่ต้องการให้แอปพลิเคชันแชร์ NSURLCache กับ Places SDK สำหรับ iOS คุณสามารถสร้าง NSURLCache ใหม่และใช้ NSURLCache นี้เฉพาะภายในแอปโดยไม่ต้องตั้งค่าเป็นแคชที่แชร์

การระบุแหล่งที่มา

ในกรณีส่วนใหญ่ คุณสามารถใช้รูปภาพสถานที่ได้โดยไม่ต้องระบุแหล่งที่มา หรือรูปภาพจะมี การระบุแหล่งที่มาที่จำเป็นเป็นส่วนหนึ่งของรูปภาพ อย่างไรก็ตาม หากอินสแตนซ์ที่ส่งคืน GMSPlacePhotoMetadata มี attributions หรือ authorAttribution คุณต้องระบุการระบุแหล่งที่มาเหล่านี้ในแอปพลิเคชันทุกที่ที่คุณแสดงรูปภาพ ดูเอกสารประกอบเกี่ยวกับการระบุแหล่งที่มา