코드 샘플 개요

플랫폼 선택: Android iOS JavaScript

iOS용 Places SDK와 함께 제공되는 SDK 데모 앱은 장소 자동 완성, 장소 사진 등 다양한 기능을 보여줍니다. 또한 이 개발자 가이드의 각 페이지에 코드 스니펫이 있습니다.

CocoaPods를 사용하여 SDK 데모 실행

iOS용 Places SDK는 CocoaPods 포드로 제공됩니다. CocoaPods는 Swift 및 Objective-C Cocoa 프로젝트용 오픈소스 종속 항목 관리자입니다.

iOS용 Places SDK는 pod try 명령어를 사용하여 설치하고 실행할 수 있는 SDK 데모 앱 집합을 제공합니다.

다음 단계에 따라 CocoaPods를 설치하고 iOS용 Places SDK를 사용해 보세요.

  1. 아직 CocoaPods 도구가 없으면 터미널에서 다음 명령어를 실행하여 macOS에 CocoaPods 도구를 설치합니다. 자세한 내용은 CocoaPods 시작 가이드를 참고하세요. 
    sudo gem install cocoapods
  2. 다음 두 가지 방법 중 하나를 사용하여 샘플 파일을 가져옵니다.

    GitHub의 파일 사용

    1. GitHub에서 코드 샘플 보관 파일을 다운로드하고 보관 파일을 압축해제합니다.
    2. 터미널 창을 열고 샘플 파일을 확장한 디렉터리로 이동한 다음 GooglePlaces 디렉터리를 자세히 살펴봅니다.

      Swift

      cd maps-sdk-for-ios-samples-master/GooglePlaces-Swift

      Objective-C

      cd maps-sdk-for-ios-samples-master/GooglePlaces
    3. 다음 명령어를 실행합니다.
      pod install
      
open GooglePlacesDemos.xcworkspace

    CocoaPods v1.6.1 사용

    1. 터미널 창을 열고 버전 1.6.1을 설치합니다. 
      sudo gem install cocoapods -v1.6.1
    2. Cocoapods를 사용해 Google Places 파일을 가져옵니다. 
      pod try GooglePlaces

      CocoaPods가 사양 저장소를 업데이트한 다음 임시 Xcode 프로젝트 GooglePlacesDemos.xcworkspace에서 SDK 데모를 엽니다.

  3. Google Cloud 콘솔 프로젝트에 대해 iOS용 Places SDK를 사용 설정합니다.
  4. 아직 API 키가 없다면 instructions에 따라 Cloud 콘솔에서 프로젝트를 설정하고 API 키를 가져옵니다. Cloud 콘솔에서 키를 구성할 때 앱의 번들 식별자를 지정하여 내 앱만 키를 사용하도록 할 수 있습니다. SDK 샘플 앱의 기본 번들 식별자는 com.example.GooglePlacesDemos입니다.
  5. SDKDemoAPIKey 파일을 수정하고 API 키를 적절한 상수에 붙여넣습니다. 예를 들면 다음과 같습니다.

    Swift

    let placesAPIKey = "YOUR_API_KEY"

    Objective-C

    static NSString *const kAPIKey = @"YOUR_API_KEY";
  6. 수정을 위해 SDKDemoAPIKey 파일을 잠금 해제하라는 메시지가 Xcode에 표시되면 잠금 해제를 선택합니다.
  7. 다음 줄이 있으면 문제를 등록하는 데 사용되므로 삭제합니다.

    Swift

    #error (API 키를 등록하고 여기에 삽입합니다. 그런 다음 이 줄을 삭제합니다.')

    Objective-C

    #error Register your API key and insert here, then delete this line.
  8. 다시 프로젝트를 빌드하고 실행합니다.
  9. 처음 실행할 때 API 키 관련 오류와 함께 빌드가 실패하거나 앱이 다운되는 경우 SDKDemoAPIKey 파일에 필요한 키를 제공했는지 확인합니다.
  10. GooglePlaces 데모를 실행하는 경우 iOS 시뮬레이터 창에 Places Demos 목록이 표시됩니다.
  11. GooglePlacesDemos에서 내 위치에 액세스하도록 허용하라는 메시지가 표시되면 허용을 선택합니다.
  12. 이제 선택한 샘플을 실행할 준비가 되었습니다.

개발자 가이드의 코드 스니펫 사용

개발자 가이드의 각 페이지에는 API의 특정 기능을 보여주는 코드 스니펫이 포함되어 있습니다. 예를 들어 이 가이드의 자동 완성, 현재 장소 가져오기, 사진 가이드 및 기타 페이지를 참고하세요.