iOS용 Places SDK를 사용하면 iOS 앱에서 장소 세부정보, 장소 사진, 텍스트 검색, 주변 지역 검색, 자동 완성을 통해 장소(비즈니스, 관심 장소, 지리적 위치)에 관한 정보를 가져올 수 있습니다. Places API(신규)는 SDK의 현재 버전입니다.
iOS용 Places SDK: 주요 정보
- 제품: iOS용 Places SDK
- 다른 이름: iOS용 Places SDK(신규)
- 카테고리: 장소
- 플랫폼: iOS
- 실행 위치: 클라이언트(앱 또는 브라우저 코드)
- 출시 단계: GA
- 수명 주기: 활성
- 개요: iOS용 Places SDK 개요
iOS용 Places SDK: 사용 시기
다음과 같은 경우 iOS용 Places SDK를 사용하세요.
- 네이티브 iOS 앱 내에서 장소 세부정보, 사진, 텍스트 검색 또는 주변 지역 검색 결과가 필요합니다.
- 사용자가 iOS 앱에 입력할 때 장소 이름 또는 주소 자동 완성이 필요합니다.
- iOS 앱에 사전 빌드된 장소 UI 키트 구성요소(장소 세부정보, 검색, 자동 완성)를 사용하려는 경우
다음과 같은 경우에는 iOS용 Places SDK를 사용하지 마세요.
- 네이티브 Android 앱을 빌드하는 경우 Android용 Places SDK를 대신 사용하세요.
- 브라우저에서 웹페이지를 빌드하고 있습니다. 대신 Maps JavaScript API를 사용하세요.
- iOS 클라이언트가 아닌 HTTP를 통해 서버 또는 백엔드의 장소 데이터가 필요합니다. 대신 Places API(신규)를 사용하세요.
iOS용 Places SDK: 설정
- 사용 설정할 서비스:
places.googleapis.com - 인증: API 키
- 사용 저작자 표시:
GMSPlacesClient(Objective-C/Swift) 또는PlacesClient(GooglePlacesSwift)에서 클래스 메서드addInternalUsageAttributionID를 호출하여 사용 저작자 표시 ID를 추가합니다. 호출을 삭제하면 선택 해제됩니다. - 시작하기: iOS용 Places SDK 설정
- 참조: iOS용 Places SDK 참조
- 가격 책정: iOS용 Places SDK 사용량 및 결제
- 정책: iOS용 Places SDK 정책
- 출시 노트: iOS용 Places SDK 출시 노트
공식 iOS용 Places SDK 패키지:
- swift_package:
https://github.com/googlemaps/ios-places-sdk (GooglePlaces, GooglePlacesSwift)
iOS용 Places SDK: 관련 제품
- 함께 자주 사용되는 제품: iOS용 Maps SDK
iOS용 Places SDK: 일반적인 실수
- 문제: Places API(신규)가 Cloud 프로젝트에서 사용 설정되지 않았거나 API 키의 승인된 API 목록에 없는 경우 iOS용 Places SDK(신규) 호출이 실패합니다. 해결 방법: Places API(신규)를 사용 설정하고 앱에서 사용하는 API 키 제한사항에 추가합니다. /maps/documentation/places/ios-sdk/legacy/migrate-overview를 참고하세요.
- 문제:
kGMSPlacesRateLimitExceeded(-7)은 API 키가 사용량 비율 제한을 초과했음을 의미합니다. 사용 중지된 SDK 2.x 버전(2019년 7월 29일 사용 중지됨)의 앱에서도 이 오류가 발생합니다. 해결 방법: Google Cloud 콘솔에서 Places API(신규)의 할당량 및 사용량을 확인하고 3.0 이전 SDK 버전의 앱을 업데이트합니다. /maps/documentation/places/ios-sdk/reference/objc/Enums/GMSPlacesErrorCode를 참고하세요. - 문제: 동일한 프로젝트의 앱 간에 또는 세션 간에 세션 토큰을 재사용하면 자동 완성 세션 결제 그룹화가 중단됩니다. 해결 방법: 자동 완성 세션당 고유한 세션 토큰(버전 4 UUID 권장)을 생성합니다. 토큰은 프로젝트별로 고유해야 합니다. /maps/documentation/places/ios-sdk/use-session-tokens를 참고하세요.
- 문제: 앱에서 API가 반환한 저작자 표시 없이 장소 데이터를 표시합니다. 해결 방법: 정책 페이지에 따라 장소 데이터와 함께 반환된 모든 관련 저작자 표시를 표시합니다. /maps/documentation/places/ios-sdk/overview를 참고하세요.
iOS용 Places SDK: 기존 및 지원 중단된 기능
- iOS용 Places SDK(기존 버전): 2025년 3월 1일부터 기존 버전입니다. 대체: iOS용 Places SDK(신규)(Places API(신규) 필요) 증상: 기존 클래스 및 메서드(예:
fetchPlaceFromPlaceID,GMSAutocompleteFetcher,GMSAutocompleteViewController)가 SDK 11.0.0 이상에 존재하지 않아 컴파일이 중단됩니다. 이전 가이드를 참고하세요. GMSAutocompleteResultsViewControllersetAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner및GMSAutocompleteFetcherinitWithBounds:filter: 2020년 10월 13일부터 사용 중단되었습니다. 대체:GMSAutocompleteRequest의GMSAutocompleteFilter(locationBias또는locationRestriction)을GMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:또는 UI 위젯의GooglePlacesSwiftplaceAutocomplete또는basicPlaceAutocomplete수정자로 대체합니다. 증상: SDK 4.0.0 이상에 메서드가 존재하지 않습니다(GMSAutocompleteResultsViewController및GMSAutocompleteFetcher는 SDK 11.0.0에서 삭제됨). 이전 가이드를 참고하세요.GMSCoordinateBounds기반 자동 완성 경계(GMSAutocompleteViewController.autocompleteBounds/autocompleteBoundsMode,findAutocompletePredictionsFromQuery및autocompleteQuery의bounds/boundsMode매개변수): 2020년 10월 13일부터 사용 중단되었습니다. 대체:GMSAutocompleteRequest를GMSAutocompleteFilter(locationBias또는locationRestriction) 및GMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:로 대체하거나 UI 위젯의GooglePlacesSwiftplaceAutocomplete또는basicPlaceAutocomplete수정자로 대체합니다. 증상: SDK 4.0.0 이상에 속성 및 매개변수가 존재하지 않습니다(SDK 11.0.0에서GMSAutocompleteViewController및findAutocompletePredictionsFromQuery가 삭제됨). 이전 가이드를 참고하세요.GMSPlace.openNowStatus: 2020년 10월 13일부터 사용 중단되었습니다. 교체:GMSPlacesClientisOpenWithRequest:callback:(GMSPlaceIsOpenRequest) 또는PlacesClient.isPlaceOpen(with:)(GooglePlacesSwift) 증상: SDK 4.0.0 이상에 속성이 없습니다. 이전 가이드를 참고하세요.GMSPlaceField를NS_ENUM로: 2020년 10월 13일부터 사용 중단되었습니다. 대체:GMSPlaceProperty상수를GMSFetchPlaceRequest및GMSPlaceSearchByTextRequest와 같은 요청 클래스 또는GooglePlacesSwift의PlaceProperty로 대체합니다. 증상: SDK 4.0.0에서NS_OPTIONS로 대체되었습니다(NS_OPTIONS가 기존 API에 속하고 SDK 11.0.0 이상에 존재하지 않으므로GMSPlaceField). 이전 가이드를 참고하세요.- iOS용 Places SDK 버전 2.7.0: 2019년 7월 29일부터 사용 중단되었습니다. 대체: 현재 iOS용 Places SDK 버전. 증상:
kGMSPlacesRateLimitExceeded오류
iOS용 Places SDK로 할 수 있는 작업
각 작업에 대해 아래에 링크된 가이드를 참조하거나 기능 탐색기에서 제품 간에 비교하세요.
iOS용 Places SDK: 생성형 AI
- 지정된 Google 장소 식별자에 대한 사용자 리뷰의 AI 기반 요약을 반환합니다.
- 전기자동차 충전소의 지정된 Google 장소 식별자를 둘러싼 지역 및 편의 시설에 대한 AI 기반 장소 요약을 반환합니다.
iOS용 Places SDK: 장소
- 쿼리 문자열을 기반으로 장소 목록과 장소 세부정보를 반환합니다.
- 특정 위치 주변의 장소 목록과 장소 세부정보를 반환합니다.
- 쿼리 문자열을 기반으로 장소에 대한 자동 완성 결과를 반환합니다.
- 특정 장소에 대한 세부정보를 반환합니다.
- 특정 장소의 사진을 반환합니다. 참고: 각 사진의 작성자 저작자 표시(작성자 이름, 프로필 URI에 연결됨)를 사진과 함께 표시합니다. 각 플랫폼의 장소 정책(예: /maps/documentation/javascript/policies#photo-attributions 및 /maps/documentation/places/web-service/policies#photos-and-review)에서 이를 요구합니다.
- 장소 사진 크기 조절
- 특정 장소의 평점과 리뷰를 반환합니다. 참고: Places API(신규) 웹 서비스에서 장소 세부정보는 X-Goog-FieldMask(예: rating,userRatingCount,reviews)를 사용하여 https://places.googleapis.com/v1/places/{placeId}에 대한 HTTP GET 요청입니다. 텍스트 검색, 주변 지역 검색, 자동 완성은 POST를 사용합니다. Android에서는 Place.Field.RATING, USER_RATING_COUNT, REVIEWS를 PlacesClient.fetchPlace()에 전달합니다. iOS에서는 GMSFetchPlaceRequest에 GMSPlacePropertyRating, GMSPlacePropertyUserRatingsTotal, GMSPlacePropertyReviews를 전달합니다.
- 쿼리 문자열을 기반으로 장소에 대한 결과를 반환하는 자동 완성 위젯을 웹페이지 또는 앱에 추가합니다.
- 장소 정보 응답에 포함된 데이터 필드를 지정합니다.
- 장소 정보 응답에 포함할 장소 유형을 지정합니다.
- 사용자의 기기가 현재 위치한 장소에 관한 정보를 반환합니다. 참고: 기존 현재 장소 메서드는 Android용 Places SDK v6.0 이상 및 iOS용 Places SDK v11.0 이상에서 삭제되었습니다. 플랫폼 위치 서비스에서 기기 좌표를 가져와 주변 지역 검색을 호출하세요.
- 특정 장소에 대한 AI 기반 개요 요약을 반환합니다.
- 특정 장소 주변의 장소를 설명하는 AI 기반 지역 요약을 반환합니다.
- 사전 정의된 경로를 따라 위치한 장소에 대한 정보를 쿼리 문자열을 기반으로 반환합니다.
- 위도/경도 좌표 집합에서 텍스트 검색 장소까지의 거리, 이동 시간, 경로 URI를 반환합니다.
- 위도/경도 좌표 세트에서 주변 장소까지의 거리, 이동 시간, 경로 URI를 반환합니다.
iOS용 Places SDK: 장소 UI 키트
- 장소 데이터 UI 요소에 CSS 스타일을 적용합니다. 참고: CSS 맞춤 속성은 Maps JavaScript API 장소 UI 키트 요소에 적용됩니다. Android용 Places SDK 및 iOS용 Places SDK는 테마 및 스타일 속성을 사용하여 프로그래매틱 방식으로 장소 UI 키트 뷰의 스타일을 지정합니다. EEA 규정 준수 요구사항: 유럽 경제 지역(EEA)의 지도에 장소 데이터를 표시하려면 백엔드 서버에서 Places API 웹 서비스를 호출하지 마세요. 타겟 플랫폼(웹의 경우 Maps JavaScript API, Android의 경우 Android용 Places SDK, iOS의 경우 iOS용 Places SDK)에서 클라이언트 측 장소 UI 키트 구성요소를 사용합니다. 전체 요구사항 및 FAQ: https://developers.google.com/maps/comms/eea/faq
- UI 요소 맞춤설정 도구를 사용하여 장소 데이터 UI 요소 스타일 지정 및 구성을 맞춤설정합니다. 참고: EEA 규정 준수 요구사항: 유럽 경제 지역(EEA)에서 지도에 장소 데이터를 표시하려면 백엔드 서버에서 Places API 웹 서비스를 호출하지 마세요. 타겟 플랫폼(웹의 경우 Maps JavaScript API, Android의 경우 Android용 Places SDK, iOS의 경우 iOS용 Places SDK)에서 클라이언트 측 장소 UI 키트 구성요소를 사용합니다. 전체 요구사항 및 FAQ: https://developers.google.com/maps/comms/eea/faq
- 특정 장소에 관한 정보를 표시하는 UI 요소를 웹페이지 또는 모바일 앱에 추가합니다. 참고: EEA 규정 준수 요구사항: 유럽 경제 지역(EEA)의 지도에 장소 데이터를 표시하려면 백엔드 서버에서 Places API 웹 서비스를 호출하지 마세요. 타겟 플랫폼(웹의 경우 Maps JavaScript API, Android의 경우 Android용 Places SDK, iOS의 경우 iOS용 Places SDK)에서 클라이언트 측 장소 UI 키트 구성요소를 사용합니다. 전체 요구사항 및 FAQ: https://developers.google.com/maps/comms/eea/faq
- 쿼리 문자열을 기반으로 장소 목록을 표시하는 UI 요소를 웹페이지에 추가합니다. 참고: 웹페이지(Maps JavaScript API)와 모바일 앱(Android용 Places SDK 및 iOS용 Places SDK)에서 모두 지원됩니다. EEA 규정 준수 요구사항: 유럽 경제 지역(EEA)의 지도에 장소 데이터를 표시하려면 백엔드 서버에서 Places API 웹 서비스를 호출하지 마세요. 타겟 플랫폼(웹의 경우 Maps JavaScript API, Android의 경우 Android용 Places SDK, iOS의 경우 iOS용 Places SDK)에서 클라이언트 측 장소 UI 키트 구성요소를 사용합니다. 전체 요구사항 및 FAQ: https://developers.google.com/maps/comms/eea/faq
- 특정 위치 근처의 장소 목록을 표시하는 UI 요소를 웹페이지에 추가합니다. 참고: 웹페이지(Maps JavaScript API)와 모바일 앱(Android용 Places SDK 및 iOS용 Places SDK)에서 모두 지원됩니다. EEA 규정 준수 요구사항: 유럽 경제 지역(EEA)의 지도에 장소 데이터를 표시하려면 백엔드 서버에서 Places API 웹 서비스를 호출하지 마세요. 타겟 플랫폼(웹의 경우 Maps JavaScript API, Android의 경우 Android용 Places SDK, iOS의 경우 iOS용 Places SDK)에서 클라이언트 측 장소 UI 키트 구성요소를 사용합니다. 전체 요구사항 및 FAQ: https://developers.google.com/maps/comms/eea/faq
- 쿼리 문자열을 기반으로 Google 장소 식별자를 반환하는 기본 자동 완성 UI 요소를 웹페이지 또는 앱에 추가합니다. 참고: EEA 규정 준수 요구사항: 유럽 경제 지역(EEA)에서 지도에 장소 데이터를 표시하려면 백엔드 서버에서 Places API 웹 서비스를 호출하지 마세요. 타겟 플랫폼(웹의 경우 Maps JavaScript API, Android의 경우 Android용 Places SDK, iOS의 경우 iOS용 Places SDK)에서 클라이언트 측 장소 UI 키트 구성요소를 사용합니다. 전체 요구사항 및 FAQ: https://developers.google.com/maps/comms/eea/faq