iOS용 Places SDK와 함께 제공되는 SDK 데모 앱에는 장소 자동 완성 및 장소 사진 등 다양한 기능이 있습니다. 또한 이 개발자 가이드의 각 페이지에서 코드 스니펫을 찾을 수 있습니다.
CocoaPods를 사용하여 SDK 데모 실행
iOS용 Places SDK는 CocoaPods pod로 제공됩니다. CocoaPods는 Swift 및 Objective-C Cocoa 프로젝트의 오픈소스 종속 항목 관리자입니다.
iOS용 Places SDK는 pod try 명령어를 사용하여 설치하고 실행할 수 있는 SDK 데모 앱 모음을 제공합니다.
다음 단계에 따라 CocoaPods를 설치하고 iOS용 Places SDK를 사용해 보세요.
- 아직 CocoaPods 도구가 없으면 터미널에서 다음 명령어를 실행하여 macOS에 CocoaPods 도구를 설치합니다. 자세한 내용은 CocoaPods 시작 가이드를 참고하세요.
sudo gem install cocoapods
- 다음 두 가지 방법 중 하나를 사용하여 샘플 파일을 가져옵니다.
GitHub의 파일 사용
- GitHub에서 코드 샘플 보관 파일을 다운로드하고 압축을 풉니다.
- 터미널 창을 열고 샘플 파일을 펼친 디렉터리로 이동한 후
GooglePlaces 디렉터리를 상세히 살펴봅니다.
Swift
cd maps-sdk-for-ios-samples-master/GooglePlaces-Swift
Objective-C
cd maps-sdk-for-ios-samples-master/GooglePlaces
- 다음 명령어를 실행합니다.
pod install
open GooglePlacesDemos.xcworkspace
CocoaPods v1.6.1 사용
- 터미널 창을 열고 버전 1.6.1을 설치합니다.
sudo gem install cocoapods -v1.6.1
- CocoaPods를 사용하여 Google 지역 정보 파일을 가져옵니다.
pod try GooglePlaces
CocoaPods가 사양 저장소를 업데이트한 다음 임시 Xcode 프로젝트
GooglePlacesDemos.xcworkspace에서 SDK 데모를 엽니다.
- Google Cloud Console 프로젝트에 iOS용 Places SDK를 사용 설정합니다.
- 아직 API 키가 없는 경우 안내에 따라 Cloud Console에서 프로젝트를 설정하고 API 키를 가져옵니다. Cloud Console에서 키를 구성할 때 앱의 번들 식별자를 지정하여 앱에서만 키를 사용할 수 있도록 할 수 있습니다. SDK 샘플 앱의 기본 번들 식별자는
com.example.GooglePlacesDemos입니다. SDKDemoAPIKey파일을 수정하고 API 키를 적절한 상수에 붙여넣습니다. 예를 들면 다음과 같습니다.Swift
let placesAPIKey = "YOUR_API_KEY"Objective-C
static NSString *const kAPIKey = @"YOUR_API_KEY";- Xcode에서 수정을 위해
SDKDemoAPIKey파일을 잠금 해제하라는 메시지가 표시되면 잠금 해제를 선택합니다. - 다음 행이 있으면 문제를 등록하는 데 사용되므로 삭제합니다.
Swift
#error (API 키를 등록하고 여기에 삽입하세요. 그런 다음 이 줄을 삭제합니다.")
Objective-C
#error Register your API key and insert here, then delete this line.
- 다시 프로젝트를 빌드하고 실행합니다.
- 처음 실행할 때 API 키 관련 오류와 함께 빌드가 실패하거나 앱이 비정상 종료되는 경우
SDKDemoAPIKey파일에 필요한 키를 제공했는지 확인하세요. - GooglePlaces 데모를 실행 중인 경우 iOS 시뮬레이터 창에 장소 데모 목록이 표시됩니다.
- GooglePlacesDemos에서 내 위치에 액세스하도록 허용할지 묻는 메시지가 표시되면 허용을 선택합니다.
- 이제 선택한 샘플을 실행할 준비가 되었습니다.
개발자 가이드의 코드 스니펫 사용
개발자 가이드의 각 페이지에는 API의 특정 기능을 보여주는 코드 스니펫이 포함되어 있습니다. 예를 들어 이 가이드의 자동 완성, 현재 장소 가져오기, 사진 및 기타 페이지를 참고하세요.