장소 사진 (신규)

플랫폼 선택: Android iOS 웹 서비스

iOS용 Places SDK (신규)를 사용하여 장소 사진을 요청할 수 있습니다. 표시할 수 있습니다. 사진 서비스에서 반환된 사진은 비즈니스 소유자, 사용자 제공 사진 등 다양한 출처의 데이터가 포함됩니다.

사진은 UIImage 객체로 표현되는 비트맵 이미지입니다. 비트맵 이미지의 최대 크기는 4800x4800픽셀입니다.

이미지 요청

한 장소에 대해 최대 10장의 사진을 요청할 수 있습니다.

  1. 전화걸기 [GMSPlacesClient lookUpPhotosForPlaceID]님, 장소 ID 및 GMSPlacePhotoMetadataResultCallback 콜백을 사용합니다. 이 요청은 GMSPlacePhotoMetadataResultCallback 콜백을 호출하고 GMSPlacePhotoMetadataList 객체를 지정합니다.

  2. 콜백의 GMSPlacePhotoMetadataList 객체에서 results 배열 속성에는 사진이 포함되며 각 사진은 GMSPlacePhotoMetadata 객체로 표시됩니다.

  3. GMSPlacePhotoMetadata 객체를 사용하여 GMSFetchPhotoRequest, 요청된 이미지의 최대 크기 포함

  4. 배열의 각 GMSPlacePhotoMetadata 객체에 대해 다음을 호출합니다. [GMSPlacesClient fetchPhotoWithRequest:callback:] GMSFetchPhotoRequest 객체를 전달합니다. 이 메서드는 사용 가능한 비트맵 이미지를 UIImage로 사용하여 GMSFetchPhotoResultCallback 콜백을 호출합니다.

장소 사진을 요청하는 또 다른 방법은 Place Details (New) 요청 필드 목록에 GMSPlacePropertyPhotos 포함 kubectl 명령어 자체의 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
    }
  }];
}];

iOS용 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
}

캐싱

[GMSPlacesClient loadPlacePhoto:callback:]를 사용하여 로드된 사진 또는 [GMSPlacesClient loadPlacePhoto:constrainedToSize:scale:callback:] Foundation URL 로딩 시스템에 의해 디스크와 메모리 내 모두에 캐시됩니다. 공유 NSURLCache에서

캐싱 동작을 구성하려면 다음을 사용하여 공유 URL 캐시를 변경할 수 있습니다. [NSURLCache setSharedURLCache:] 드림 애플리케이션 대리자의 application:didFinishLaunchingWithOptions: 메서드를 사용하여 축소하도록 요청합니다.

애플리케이션이 NSURLCache를 iOS용 Places SDK를 만들 때 새 NSURLCache를 만들어 공유 캐시로 설정하지 않고 앱 내에서만 할 수 있습니다.

기여 분석

대부분의 경우 장소 사진은 저작자 표시 없이 사용할 수 있거나 필수 저작자 표시가 이미지의 일부로 포함되어 있습니다. 그러나 GMSPlacePhotoMetadata 드림 인스턴스에는 attributions 또는 authorAttribution, 애플리케이션을 표시할 때마다 애플리케이션에 이미지 기여 분석에 관한 문서를 참고하세요.