코드 샘플 개요

플랫폼 선택: Android iOS 자바스크립트

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를 사용해 보세요.

  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 지역 정보 파일을 가져옵니다.
      pod try GooglePlaces

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

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

    Swift

    let placesAPIKey = "YOUR_API_KEY"

    Objective-C

    static NSString *const kAPIKey = @"YOUR_API_KEY";
  6. Xcode에서 수정을 위해 SDKDemoAPIKey 파일을 잠금 해제하라는 메시지가 표시되면 잠금 해제를 선택합니다.
  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 시뮬레이터 창에 장소 데모 목록이 표시됩니다.
  11. GooglePlacesDemos에서 내 위치에 액세스하도록 허용할지 묻는 메시지가 표시되면 허용을 선택합니다.
  12. 이제 선택한 샘플을 실행할 준비가 되었습니다.

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

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