장소 사진

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

iOS용 Places SDK를 사용하여 애플리케이션에 표시할 장소 사진을 요청할 수 있습니다. 사진 서비스에서 반환되는 사진은 비즈니스 소유자 및 사용자가 제공한 사진을 비롯한 다양한 소스에서 가져온 것입니다. 장소의 사진을 검색하려면 다음 단계를 따라야 합니다.

  1. [GMSPlacesClient fetchPlaceFromPlaceId]를 호출하여 장소 ID 문자열과 콜백을 전달합니다. 그러면 GMSPlacePhotoMetadataList 객체가 포함된 콜백이 호출됩니다.
  2. GMSPlacePhotoMetadataList 객체에서 results 속성에 액세스하고 배열에서 로드할 사진을 선택합니다.
  3. 이 목록에서 로드할 각 GMSPlacePhotoMetadata에 대해 [GMSPlacesClient loadPlacePhoto:callback:] 또는 [GMSPlacesClient loadPlacePhoto:constrainedToSize:scale:callback:]를 호출합니다. 그러면 사용 가능한 UIImage가 포함된 콜백이 호출됩니다. 사진의 최대 너비 또는 높이는 1,600픽셀입니다.

샘플 코드

다음 예시 메서드는 장소 ID를 취하고 반환되는 목록에서 첫 번째 사진을 가져옵니다. 이 메서드를 앱에서 생성할 메서드의 템플릿으로 사용할 수 있습니다.

Swift

// Specify the place data types to return (in this case, just photos).
let fields: GMSPlaceField = GMSPlaceField(rawValue: UInt(GMSPlaceField.photos.rawValue))!

placesClient?.fetchPlace(fromPlaceID: "INSERT_PLACE_ID_HERE",
                         placeFields: fields,
                         sessionToken: nil, callback: {
  (place: GMSPlace?, error: Error?) in
  if let error = error {
    print("An error occurred: \(error.localizedDescription)")
    return
  }
  if let place = place {
    // Get the metadata for the first photo in the place photo metadata list.
    let photoMetadata: GMSPlacePhotoMetadata = place.photos![0]

    // Call loadPlacePhoto to display the bitmap and attribution.
    self.placesClient?.loadPlacePhoto(photoMetadata, callback: { (photo, error) -> Void in
      if let error = error {
        // TODO: Handle the error.
        print("Error loading photo metadata: \(error.localizedDescription)")
        return
      } else {
        // Display the first image and its attributions.
        self.imageView?.image = photo;
        self.lblText?.attributedText = photoMetadata.attributions;
      }
    })
  }
})

Objective-C

// Specify the place data types to return (in this case, just photos).
GMSPlaceField fields = (GMSPlaceFieldPhotos);

NSString *placeId = @"INSERT_PLACE_ID_HERE";

[_placesClient fetchPlaceFromPlaceID:placeId placeFields:fields sessionToken:nil callback:^(GMSPlace * _Nullable place, NSError * _Nullable error) {
  if (error != nil) {
    NSLog(@"An error occurred %@", [error localizedDescription]);
    return;
  }
  if (place != nil) {
    GMSPlacePhotoMetadata *photoMetadata = [place photos][0];
    [self->_placesClient loadPlacePhoto:photoMetadata callback:^(UIImage * _Nullable photo, NSError * _Nullable error) {
      if (error != nil) {
        NSLog(@"Error loading photo metadata: %@", [error localizedDescription]);
        return;
      } else {
        // Display the first image and its attributions.
        self->imageView.image = photo;
        self->lblText.attributedText = photoMetadata.attributions;
      }
    }];
  }
}];

캐싱

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

캐싱 동작을 구성하려면 애플리케이션 대리자의 application:didFinishLaunchingWithOptions: 메서드에서 [NSURLCache setSharedURLCache:]를 사용하여 공유 URL 캐시를 변경하면 됩니다.

애플리케이션에서 NSURLCache를 iOS용 Places SDK와 공유하지 않으려면 새 NSURLCache를 만들어 공유 캐시로 설정하지 않고 앱에서 독점적으로 사용할 수 있습니다.

기여 분석

대부분의 경우 장소 사진은 저작자 표시 없이 사용할 수 있거나 필수 저작자 표시가 이미지의 일부로 포함되어 있습니다. 그러나 반환된 GMSPlacePhotoMetadata 인스턴스에 저작자 표시가 포함된 경우에는 이미지를 표시할 때마다 애플리케이션에 추가 저작자 표시를 포함해야 합니다. 저작자 표시의 링크는 탭할 수 있어야 합니다. 기여 분석에 관한 문서를 참고하세요.

사용량 한도

이미지를 검색할 때마다 할당량의 1단위가 사용됩니다. 사진 메타데이터 검색에는 사용 제한이 없습니다. 사용량 및 결제에 대해 자세히 알아보세요.