GMSPlacesClient 클래스 참조

공개 멤버 함수 | 정적 공개 구성원 함수 | 관련 함수
GMSPlacesClient 클래스 참조

개요

Places SDK의 기본 인터페이스

장소를 검색하고 세부정보를 가져오는 데 사용됩니다. 이 클래스는 [GMSPlacesClient sharedClient] 메서드를 통해 액세스해야 합니다.

GMSPlacesClient 메서드는 기본 스레드에서만 호출해야 합니다. 다른 스레드에서 이러한 메서드를 호출하면 예외 또는 정의되지 않은 동작이 발생합니다. 달리 명시되지 않는 한 모든 콜백은 기본 스레드에서 호출됩니다.

공개 멤버 함수

(무효)- lookUpPlaceID:callback:
 장소에 대한 세부정보를 가져옵니다.
(무효)- lookUpPhotosForPlaceID:callback:
 장소와 연결된 최대 10장의 사진에 대한 메타데이터를 가져옵니다.
(무효)- loadPlacePhoto:콜백:
 특정 사진의 이미지를 최대 크기로 로드합니다.
(무효)- loadPlacePhoto:constrainedToSize:scale:callback:
 지정된 최대 크기에 맞게 조정된 특정 사진의 이미지를 로드합니다.
(무효)- currentPlaceWithCallback:
 현재 기기가 있는 것으로 알려진 장소의 추정치를 반환합니다.
(무효)- findAutocompletePredictionsFromQuery:filter:sessionToken:callback:
 텍스트 쿼리에서 자동 완성 예상 검색어를 찾습니다.
(무효)- fetchPlaceFromPlaceID:placeFields:sessionToken:callback:
 장소에 대한 세부정보를 가져옵니다.
(무효)- findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:callback:
 사용자의 현재 위치를 사용하여 장소 가능성을 찾습니다.

정적 공개 멤버 함수

(인스턴스 유형)+ sharedClient
 필요한 경우 iOS용 Google Places SDK의 GMSPlacesClient 공유 인스턴스를 제공합니다.
(부울)+ provideAPIKey:
 iOS용 Google Places SDK에 API 키를 제공합니다.
(NSString *)+ openSourceLicenseInfo
 iOS용 Google Places SDK의 오픈소스 소프트웨어 라이선스 정보를 반환합니다.
(NSString *)+ SDK 버전
 이 버전의 iOS용 Google Places SDK 버전을 반환합니다.
(NSString *)+ SDKLongVersion
 이 버전의 iOS용 Google Places SDK의 긴 버전을 반환합니다.

참고로, 이러한 함수는 멤버 함수가 아닙니다.

typedef void(^ GMSPlaceResultCallback)(GMSPlace *_Nullable 결과, NSError *_Nullable 오류)
 장소 세부정보 조회를 받기 위한 콜백 유형입니다.
typedef void(^ GMSPlaceLikelihoodListCallback)(GMSPlaceLikelihoodList *_Nullable availabilityList, NSError *_Nullable error)
 장소 일치 가능성 목록을 수신하는 콜백 유형입니다.
typedef void(^ GMSPlaceLikelihoodsCallback )(NSArray< GMSPlaceLikelihood * > *_Nullable 가능성, NSError *_Nullable 오류)
 GMSPlaceLikelihood의 배열을 수신하는 콜백 유형입니다.
typedef void(^ GMSAutocompletePredictionsCallback )(NSArray< GMSAutocompletePrediction * > *_Nullable results, NSError *_Nullable error)
 자동 완성 결과를 수신하는 콜백 유형입니다.
typedef void(^ GMSPlacePhotoMetadataResultCallback)(GMSPlacePhotoMetadataList *_Nullable 사진, NSError *_Nullable 오류)
 장소 사진 결과를 수신하는 콜백 유형입니다.
typedef void(^ GMSPlacePhotoImageResultCallback )(UIImage *_Nullable photo, NSError *_Nullable error)
 GMSPlacePhotoMetadata 객체에서 UIImage 객체를 수신하는 콜백 유형입니다.

멤버 함수 문서

+ (인스턴스 유형) sharedClient

필요한 경우 iOS용 Google Places SDK의 GMSPlacesClient 공유 인스턴스를 제공합니다.

애플리케이션에서 GMSPlacesClient 메서드를 자주 사용하는 경우 이 객체를 직접 보관해야 할 수도 있습니다. 그러지 않으면 Google에 대한 연결이 정기적으로 다시 시작될 수 있습니다.

+ (BOOL) provideAPIKey: (NSString *) 키

iOS용 Google Places SDK에 API 키를 제공합니다.

이 키는 Google Cloud Platform Console을 통해 애플리케이션에 대해 생성되며, 애플리케이션의 번들 ID와 페어링되어 식별합니다. GMSPlacesClient를 사용하기 전에 애플리케이션에서 호출해야 합니다 (예: application:didFinishLaunchingWithOptions:).

반환:
APIKey가 성공적으로 제공된 경우 '예'입니다.
+ (NSString *) openSourceLicenseInfo

iOS용 Google Places SDK의 오픈소스 소프트웨어 라이선스 정보를 반환합니다.

이 정보를 애플리케이션 내에 제공해야 합니다.

+ (NSString *) SDK 버전

이 버전의 iOS용 Google Places SDK 버전을 반환합니다.

예: '1.0.0'

+ (NSString *) SDKLongVersion

이 버전의 iOS용 Google Places SDK의 긴 버전을 반환합니다.

예: '1.0.0(102.1)'

- (void) LookUpPlaceID: (NSString *) 장소 ID
콜백: (GMSPlaceResultCallback) 콜백

장소에 대한 세부정보를 가져옵니다.

이 방법은 비차단형입니다.

매개변수:
장소 ID조회할 장소 ID입니다.
콜백조회 결과로 호출할 콜백입니다.
- (void) LookUpPhotosForPlaceID: (NSString *) 장소 ID
콜백: (GMSPlacePhotoMetadataResultCallback) 콜백

장소와 연결된 최대 10장의 사진에 대한 메타데이터를 가져옵니다.

사진은 비즈니스 소유자 및 Google+ 사용자가 제공한 사진을 비롯하여 다양한 위치에서 제공됩니다. 대부분의 경우 이러한 사진은 저작자 표시 없이 사용할 수 있거나 필수 저작권 표시가 이미지의 일부로 포함되어 있습니다. 그러나 응답에서 attributions 속성을 사용하여 필요한 추가 속성을 검색하고 이미지를 표시할 때마다 애플리케이션에 해당 속성을 표시해야 합니다. 최대 10장의 사진이 반환됩니다.

이 메서드를 여러 번 호출하면 매번 동일한 사진이 반환됩니다. 그러나 이는 기본 데이터가 변경되었을 수 있기 때문에 보장되지 않습니다.

이 메서드는 네트워크 조회를 수행합니다.

매개변수:
장소 ID사진을 조회할 장소 ID입니다.
콜백조회 결과로 호출할 콜백입니다.
- (void) loadPlacePhoto: (GMSPlacePhotoMetadata *) photoMetadata
콜백: (GMSPlacePhotoImageResultCallback) 콜백

특정 사진의 이미지를 최대 크기로 로드합니다.

이미지 데이터는 SDK에서 캐시할 수 있습니다. 요청한 사진이 캐시에 없으면 네트워크 조회가 수행됩니다.

매개변수:
사진 메타데이터UIImage를 로드할 GMSPlacePhotoMetadata.
콜백로드된 UIImage로 호출할 콜백입니다.
- (void) loadPlacePhoto: (GMSPlacePhotoMetadata *) photoMetadata
constrainedToSize: (CGSize) maxSize
있습니다. (CGFloat) 배율
콜백: (GMSPlacePhotoImageResultCallback) 콜백

지정된 최대 크기에 맞게 조정된 특정 사진의 이미지를 로드합니다.

원본 이미지의 가로세로 비율을 유지하면서 지정된 크기에 맞게 크기가 조정됩니다. 이 확장은 서버 측에서 수행됩니다.

scale 매개변수가 1.0이 아니면 maxSize에 이 값을 곱하고, 반환된 UIImage가 지정된 배율을 갖도록 설정됩니다. 화면에 표시할 이미지를 로드하는 경우 이 매개변수를 화면 배율로 설정해야 합니다.

이미지 데이터는 SDK에서 캐시할 수 있습니다. 요청한 사진이 캐시에 없으면 네트워크 조회가 수행됩니다.

참고:
배율 계수를 적용하면 maxSize의 측정기준은 가장 가까운 정수로 반올림된 후 사용됩니다. 사용 가능한 최대 크기보다 큰 이미지가 요청되면 더 작은 이미지가 반환될 수 있습니다.
매개변수:
사진 메타데이터UIImage를 로드할 GMSPlacePhotoMetadata.
최대 크기이미지의 최대 크기입니다.
활용이미지를 로드할 배율입니다.
콜백로드된 UIImage로 호출할 콜백입니다.
- (void) currentPlaceWithCallback: (GMSPlaceLikelihoodListCallback) 콜백

현재 기기가 있는 것으로 알려진 장소의 추정치를 반환합니다.

기기의 마지막 예상 위치를 기반으로 장소 가능성 목록을 생성합니다. 제공된 콜백은 성공 시 이 가능성 목록과 함께 호출되고 오류가 발생하면 NSError로 호출됩니다.

참고:
이 방법을 사용하려면 현재 기기 위치에 액세스할 수 있는 권한이 앱에 필요합니다. 이를 호출하기 전에 [CLLocationManager requestWhenInUseAuthorization] 또는 [CLLocationManager requestAlwaysAuthorization]을 사용하여 사용자 위치에 대한 액세스를 요청해야 합니다. 이 메서드를 호출하지만 앱에 올바른 승인 상태가 없으면 콜백이 오류와 함께 호출됩니다.
매개변수:
콜백장소 유사도 목록과 함께 호출할 콜백입니다.
- (void) findAutocompletePredictionsFromQuery: (NSString *) query
필터: (null을 허용하는 GMSAutocompleteFilter *) filter
sessionToken: (null을 허용하는 GMSAutocompleteSessionToken *) sessionToken
콜백: (GMSAutocompletePredictionsCallback) 콜백

텍스트 쿼리에서 자동 완성 예상 검색어를 찾습니다.

결과는 선택적으로 특정 위치에 편중되거나 특정 지역으로 제한될 수 있습니다. 이 방법은 비차단형입니다.

제공된 콜백은 성공 시 자동 완성 예측 배열과 오류 발생 시 NSError로 호출됩니다.

매개변수:
쿼리자동 완성할 부분 텍스트입니다.
filter결과에 적용할 필터입니다. 이 매개변수는 nil일 수 있습니다.
sessionToken요청을 결제 세션에 연결할 GMSAutocompleteSessionToken.
콜백예측으로 호출할 콜백입니다.
- (void) fetchPlaceFromPlaceID: (NSString *) 장소 ID
placeFields: (GMSPlaceField) placeField
sessionToken: (null을 허용하는 GMSAutocompleteSessionToken *) sessionToken
콜백: (GMSPlaceResultCallback) 콜백

장소에 대한 세부정보를 가져옵니다.

이 방법은 비차단형입니다.

매개변수:
장소 ID조회할 장소 ID입니다.
placeField목록의 장소 객체에 대해 요청된 개별 장소 필드입니다.
sessionToken요청을 결제 세션에 연결할 GMSAutocompleteSessionToken.
콜백조회 결과로 호출할 콜백입니다.
- (void) findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (GMSPlaceField) placeField
콜백: (GMSPlaceLikelihoodsCallback) 콜백

사용자의 현재 위치를 사용하여 장소 가능성을 찾습니다.

이 방법은 비차단형입니다.

제공된 콜백은 성공 시 가능성 점수와 오류 발생 시 NSError가 있는 장소의 배열과 함께 호출됩니다.

매개변수:
placeField목록의 장소 객체에 대해 요청된 개별 장소 필드입니다.
콜백장소 일치 여부를 사용하여 호출할 콜백입니다.
- (typedef void(^ GMSPlaceResultCallback)(GMSPlace *_Nullable result, NSError *_Nullable error)) [related]

장소 세부정보 조회를 받기 위한 콜백 유형입니다.

오류가 발생하면 result가 nil이며 error에 오류에 대한 정보가 포함됩니다.

매개변수:
결과반환된 GMSPlace입니다.
오류발생한 오류입니다(있는 경우).
- (typedef void(^ GMSPlaceLikelihoodListCallback)(GMSPlaceLikelihoodList *_Nullable availabilityList, NSError *_Nullable error)) [related]

장소 일치 가능성 목록을 수신하는 콜백 유형입니다.

오류가 발생하면 likelihoodList가 nil이며 error에 오류에 대한 정보가 포함됩니다.

매개변수:
가능성 목록예상 장소 목록입니다.
오류발생한 오류입니다(있는 경우).
- (typedef void(^ GMSPlaceLikelihoodsCallback)(NSArray< GMSPlaceLikelihood * > *_Nullable가능성, NSError *_Nullable error)) [related]

GMSPlaceLikelihood의 배열을 수신하는 콜백 유형입니다.

오류가 발생한 경우 배열은 nil이며 error에는 오류에 대한 정보가 포함됩니다.

- (typedef void(^ GMSAutocompletePredictionsCallback)(NSArray< GMSAutocompletePrediction * > *_Nullable results, NSError *_Nullable error)) [related]

자동 완성 결과를 수신하는 콜백 유형입니다.

results는 쿼리의 후보 완료를 나타내는 GMSAutocompletePredictions 배열입니다.

매개변수:
결과GMSAutocompletePrediction의 배열.
오류발생한 오류입니다(있는 경우).
- (typedef void(^ GMSPlacePhotoMetadataResultCallback)(GMSPlacePhotoMetadataList *_Nullable photos, NSError *_Nullable error)) [related]입니다.

장소 사진 결과를 수신하는 콜백 유형입니다.

오류가 발생하면 photos가 nil이며 error에 오류에 대한 정보가 포함됩니다.

매개변수:
포토GMSPlacePhotoMetadata 객체가 포함된 결과
오류발생한 오류입니다(있는 경우).
- (typedef void(^ GMSPlacePhotoImageResultCallback)(UIImage *_Nullable photo, NSError *_Nullable error)) [related]입니다.

GMSPlacePhotoMetadata 객체에서 UIImage 객체를 수신하는 콜백 유형입니다.

오류가 발생하면 photo가 nil이며 error에 오류에 대한 정보가 포함됩니다.

매개변수:
사진로드된 UIImage
오류발생한 오류입니다(있는 경우).