GMSPlacesClient 클래스 참조

GMSPlacesClient 클래스 참조

개요

Places SDK의 기본 인터페이스입니다.

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

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

공개 멤버 함수

(void) - lookUpPlaceID:callback:
 장소에 대한 세부정보를 가져옵니다.
(void) - lookUpPhotosForPlaceID:callback:
 장소와 연결된 최대 10장의 사진의 메타데이터를 가져옵니다.
(void) - loadPlacePhoto:callback:
 특정 사진의 이미지를 최대 크기로 로드합니다.
(void) - loadPlacePhoto:constrainedToSize:scale:callback:
 지정된 최대 크기에 맞게 조정된 특정 사진의 이미지를 로드합니다.
(void) - currentPlaceWithCallback:
 현재 기기의 위치로 알려진 장소의 추정치를 반환합니다.
(void) - findAutocompletePredictionsFromQuery:filter:sessionToken:callback:
 텍스트 쿼리에서 자동 완성 예상 검색어를 찾습니다.
(void) - fetchPlaceFromPlaceID:placeFields:sessionToken:callback:
 장소에 대한 세부정보를 가져옵니다.
(void) - findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:callback:
 사용자의 현재 위치를 사용하여 장소 유사도를 찾습니다.
(void) - isOpenWithPlaceID:callback:
 현재 시간의 GMSPlaceOpenStatus를 확인하는 데 필요한 모든 필드를 비롯하여 장소의 세부정보를 가져옵니다.
(void) - isOpenWithPlaceID:date:callback:
 지정된 NSDate에서 GMSPlaceOpenStatus를 결정하는 데 필요한 모든 필드를 비롯한 장소의 세부정보를 가져옵니다.
(void) - isOpenWithPlace:callback:
 현재 시간의 GMSPlaceOpenStatus를 확인하는 데 필요한 모든 필드를 비롯하여 장소의 세부정보를 가져옵니다.
(void) - isOpenWithPlace:date:callback:
 지정된 NSDate에서 GMSPlaceOpenStatus를 결정하는 데 필요한 모든 필드를 비롯한 장소의 세부정보를 가져옵니다.
(void) - searchByTextWithRequest:callback:
 텍스트 및 제한사항별로 장소를 검색할 수 있습니다.

정적 공개 멤버 함수

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

(이 함수는 멤버 함수가 아닙니다.)

typedef void(^) GMSPlaceResultCallback )(GMSPlace *_Nullable 결과, NSError *_Nullable 오류)
 장소 세부정보 조회 수신을 위한 콜백 유형입니다.
typedef void(^) GMSPlaceLikelihoodListCallback )(GMSPlaceLikelihoodList *_NullableabilityList, NSError *_Nullable 오류)
 장소 유사도 목록을 수신하기 위한 콜백 유형입니다.
typedef void(^) GMSPlaceLikelihoodsCallback )(NSArray< GMSPlaceLikelihood * > *_Nullable processs, NSError *_Nullable error)
 GMSPlaceLikelihood 배열을 수신하기 위한 콜백 유형입니다.
typedef void(^) GMSAutocompletePredictionsCallback )(NSArray< GMSAutocompletePrediction * > *_Nullable results, NSError *_Nullable 오류)
 자동 완성 결과를 받기 위한 콜백 유형입니다.
typedef void(^) GMSPlacePhotoMetadataResultCallback)(GMSPlacePhotoMetadataList *_Nullable 사진, NSError *_Nullable 오류)
 장소 사진 결과 수신을 위한 콜백 유형입니다.
typedef void(^) GMSPlacePhotoImageResultCallback)(UIImage *_Nullable 사진, NSError *_Nullable 오류)
 GMSPlacePhotoMetadata 객체에서 UIImage 객체를 수신하기 위한 콜백 유형입니다.
typedef void(^) GMSPlaceOpenStatusCallback )(GMSPlaceOpenStatus 결과, NSError *_Nullable 오류)
 장소의 영업시간 상태를 받기 위한 콜백 유형입니다.
typedef void(^) GMSPlaceSearchByTextResultCallback )(NSArray< GMSPlace * > *_Nullable places, NSError *_Nullable error)
 텍스트 결과를 수신하기 위한 콜백 유형입니다.

멤버 함수 문서

+ (instancetype) sharedClient

iOS용 Google Places SDK에 GMSPlacesClient의 공유 인스턴스를 제공하고 필요한 경우 인스턴스를 만듭니다.

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

+ (BOOL) provideAPIKey: (NSString *)

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

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

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

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

이 정보는 신청서에서 확인할 수 있어야 합니다.

+ (NSString *) SDKVersion

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

. 예: '1.0.0'

+ (NSString *) SDKLongVersion

iOS용 Google Places SDK의 이번 출시 버전에 대한 긴 버전을 반환합니다.

예: '1.0.0(102.1)'

- (void) LookUpPlaceID: (NSString *) placeID
콜백을 수신합니다. (GMSPlaceResultCallback) 콜백

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

이 메서드는 비블로킹입니다.

매개변수:
placeID조회할 장소 ID입니다.
콜백조회 결과와 함께 호출할 콜백입니다.
- (void) LookUpPhotosForPlaceID: (NSString *) placeID
콜백을 수신합니다. (GMSPlacePhotoMetadataResultCallback) 콜백

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

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

이 메서드를 여러 번 호출하면 매번 동일한 사진이 반환될 수 있습니다. 하지만 기본 데이터가 변경되었을 수 있으므로 보장되지 않습니다.

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

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

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

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

매개변수:
photoMetadataUIImage를 로드할 GMSPlacePhotoMetadata입니다.
콜백로드된 UIImage로 호출할 콜백입니다.
- (void) loadPlacePhoto: (GMSPlacePhotoMetadata *) photoMetadata
constraintToSize: (CGSize) maxSize
있습니다. (CGFloat) 배율
콜백을 수신합니다. (GMSPlacePhotoImageResultCallback) 콜백

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

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

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

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

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

현재 기기의 위치로 알려진 장소의 추정치를 반환합니다.

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

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

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

결과는 특정 위치에 편중되거나 특정 지역으로 제한될 수 있습니다. 이 메서드는 비블로킹입니다.

제공된 콜백은 성공 시 자동 완성 예상 검색어 배열과 함께 호출되고 오류 발생 시 NSError 배열과 함께 호출됩니다.

매개변수:
query자동 완성할 부분 텍스트입니다.
filter결과에 적용할 필터입니다. 이 매개변수는 nil일 수 있습니다.
sessionToken요청을 결제 세션에 연결할 GMSAutocompleteSessionToken입니다.
콜백예상 검색어와 함께 호출할 콜백입니다.
- (void) fetchPlaceFromPlaceID: (NSString *) placeID
placeFields: (GMSPlaceField) placeFields
sessionToken: (null을 허용하는 GMSAutocompleteSessionToken *) sessionToken
콜백을 수신합니다. (GMSPlaceResultCallback) 콜백

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

이 메서드는 비블로킹입니다.

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

사용자의 현재 위치를 사용하여 장소 유사도를 찾습니다.

이 메서드는 비블로킹입니다.

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

매개변수:
placeFields목록의 장소 객체에 대해 요청된 개별 장소 필드입니다.
콜백장소 유사도로 호출할 콜백입니다.
- (void) isOpenWithPlaceID: (NSString *) placeID
콜백을 수신합니다. (GMSPlaceOpenStatusCallback) 콜백

현재 시간의 GMSPlaceOpenStatus를 확인하는 데 필요한 모든 필드를 비롯하여 장소의 세부정보를 가져옵니다.

이 메서드는 비블로킹입니다.

매개변수:
placeID조회할 장소 ID입니다.
콜백장소 결과와 함께 호출할 콜백입니다.
- (void) isOpenWithPlaceID: (NSString *) placeID
date: (NSDate *) 날짜
콜백을 수신합니다. (GMSPlaceOpenStatusCallback) 콜백

지정된 NSDate에서 GMSPlaceOpenStatus를 결정하는 데 필요한 모든 필드를 비롯한 장소의 세부정보를 가져옵니다.

이 메서드는 비블로킹입니다.

매개변수:
placeID조회할 장소 ID입니다.
date열기 상태를 확인할 NSDate입니다.
콜백장소 결과와 함께 호출할 콜백입니다.
- (void) isOpenWithPlace: (GMSPlace *) 장소
콜백을 수신합니다. (GMSPlaceOpenStatusCallback) 콜백

현재 시간의 GMSPlaceOpenStatus를 확인하는 데 필요한 모든 필드를 비롯하여 장소의 세부정보를 가져옵니다.

GMSPlace에 모든 필수 필드가 없는 경우에만 추가 필드를 요청합니다. 그렇지 않으면 GMSPlaceOpenStatus가 콜백에서 즉시 반환됩니다. 이 메서드는 비블로킹입니다.

매개변수:
장소조회할 GMSPlace입니다.
콜백장소 결과와 함께 호출할 콜백입니다.
- (void) isOpenWithPlace: (GMSPlace *) 장소
date: (NSDate *) 날짜
콜백을 수신합니다. (GMSPlaceOpenStatusCallback) 콜백

지정된 NSDate에서 GMSPlaceOpenStatus를 결정하는 데 필요한 모든 필드를 비롯한 장소의 세부정보를 가져옵니다.

GMSPlace에 모든 필수 필드가 없는 경우에만 추가 필드를 요청합니다. 그렇지 않으면 GMSPlaceOpenStatus가 콜백에서 즉시 반환됩니다. 이 메서드는 비블로킹입니다.

매개변수:
장소조회할 GMSPlace입니다.
date열기 상태를 확인할 NSDate입니다.
콜백장소 결과와 함께 호출할 콜백입니다.
- (void) searchByTextWithRequest: (GMSPlaceSearchByTextRequest *) textSearchRequest
콜백을 수신합니다. (GMSPlaceSearchByTextResultCallback) 콜백

텍스트 및 제한사항별로 장소를 검색할 수 있습니다.

이 메서드는 비블로킹입니다.

매개변수:
textSearchRequestGMSPlaceSearchByTextRequest: 쿼리에 사용할 텍스트 요청입니다.
콜백조회 결과와 함께 호출할 콜백입니다.

- (typedef void(^ GMSPlaceResultCallback)(GMSPlace *_Nullable result, NSError *_Nullable error)) [related]

장소 세부정보 조회 수신을 위한 콜백 유형입니다.

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

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

장소 유사도 목록을 수신하기 위한 콜백 유형입니다.

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

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

GMSPlaceLikelihood 배열을 수신하기 위한 콜백 유형입니다.

오류가 발생하면 배열은 nil이 되고 error에는 오류에 대한 정보가 포함됩니다.

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

자동 완성 결과를 받기 위한 콜백 유형입니다.

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

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

장소 사진 결과 수신을 위한 콜백 유형입니다.

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

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

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

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

매개변수:
사진로드된 UIImage입니다.
error발생한 오류입니다(있는 경우).
- (typedef void(^ GMSPlaceOpenStatusCallback)(GMSPlaceOpenStatus result, NSError *_Nullable error)) [related]

장소의 영업시간 상태를 받기 위한 콜백 유형입니다.

오류가 발생한 경우 result는 GMSPlaceOpenStatusUnknown이 되고 error에는 오류에 관한 정보가 포함됩니다.

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

텍스트 결과를 수신하기 위한 콜백 유형입니다.

results는 쿼리와 일치하는 개별 결과를 나타내는 GMSPlace의 배열입니다.

매개변수:
경기 결과GMSPlace의 배열입니다.
error발생한 오류입니다(있는 경우).