iOS용 Places SDK 빠른 참조

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: 설정

공식 iOS용 Places SDK 패키지:

  • swift_package: https://github.com/googlemaps/ios-places-sdk (GooglePlaces, GooglePlacesSwift)

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 이상에 존재하지 않아 컴파일이 중단됩니다. 이전 가이드를 참고하세요.
  • GMSAutocompleteResultsViewController setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner 및 GMSAutocompleteFetcher initWithBounds:filter: 2020년 10월 13일부터 사용 중단되었습니다. 대체: GMSAutocompleteRequest의 GMSAutocompleteFilter(locationBias 또는 locationRestriction)을 GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback: 또는 UI 위젯의 GooglePlacesSwift placeAutocomplete 또는 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) 및 GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback:로 대체하거나 UI 위젯의 GooglePlacesSwift placeAutocomplete 또는 basicPlaceAutocomplete 수정자로 대체합니다. 증상: SDK 4.0.0 이상에 속성 및 매개변수가 존재하지 않습니다(SDK 11.0.0에서 GMSAutocompleteViewController 및 findAutocompletePredictionsFromQuery가 삭제됨). 이전 가이드를 참고하세요.
  • GMSPlace.openNowStatus: 2020년 10월 13일부터 사용 중단되었습니다. 교체: GMSPlacesClient isOpenWithRequest: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

iOS용 Places SDK: 장소

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