iOS용 Places SDK 코드 샘플

플랫폼 선택: Android iOS JavaScript

GitHub 또한 이 개발자 가이드의 각 페이지에 코드 스니펫이 있습니다. 앱을 가져와 빌드하고, API 키를 추가하고, 데모를 보고, 앱의 출발점으로 제공된 샘플 코드를 사용하세요.

샘플 앱을 실행하면 기기에서 실행할 수 있는 샘플 목록이 표시됩니다. 옵션 중 하나를 선택합니다.

전체 샘플 앱을 로컬에서 실행

GitHub

  1. GitHub에서 코드 샘플 보관 파일을 다운로드 하고 보관 파일의 압축을 풉니다. 또는 저장소를 로컬 디렉터리로 클론합니다. 
    git clone https://github.com/googlemaps-samples/ios-places-sdk-samples.git

  2. 터미널 창을 열고 샘플 파일의 압축을 푼 디렉터리로 이동한 후 사용할 버전의 디렉터리로 드릴다운합니다.

    SwiftUI

    cd ios-places-sdk-samples/GooglePlacesDemos/
open GooglePlacesDemos.xcodeproj

    Swift

    cd ios-places-sdk-samples/GooglePlaces-Swift/
open GooglePlacesSwiftDemos.xcodeproj

    Objective-C

    cd ios-places-sdk-samples/Archive/GooglePlaces
open GooglePlacesXCFrameworkDemos.xcodeproj
  3. Xcode 프로젝트에서 File(파일) > Add Package Dependencies(패키지 종속 항목 추가)로 이동합니다. URL로 https://github.com/googlemaps/ios-places-sdk를 입력하고 Enter 키를 눌러 패키지를 가져온 후 Add Package를 클릭합니다.
  4. Google Cloud 콘솔 프로젝트에 iOS용 Places SDK 및 iOS용 Maps SDK를 사용 설정합니다.
  5. Places API 또는 Places API (신규)가 사용 설정된 프로젝트에서 API 키를 가져옵니다.
  6. 아래의 적절한 안내에 따라 앱에 API 키를 추가합니다.

    SwiftUI

    API 키의 로컬 구성 파일(GooglePlacesDemos.xcconfig)을 데모 애플리케이션의 Info.plist 파일(GooglePlacesDemos/GooglePlacesDemos)과 동일한 디렉터리에 만듭니다.

    구성 파일에 두 줄을 추가하여 API 키를 정의합니다.

    PLACES_API_KEY = YOUR_PLACES_API_KEY 및 MAPS_API_KEY = YOUR_MAPS_API_KEY.

    YOUR_PLACES_API_KEY 및 YOUR_MAPS_API_KEY를 이전 단계의 API 키로 바꿉니다.

    로컬 구성 파일 만들기에 관한 도움말은 구성 설정 파일 (xcconfig) 형식을 참고하세요.

    Swift

    SDKDemoAPIKey 파일을 수정하고 API 키 를 적절한 상수에 붙여넣습니다. 예를 들면 다음과 같습니다.

    let placesAPIKey = "YOUR_API_KEY"

    다음 줄이 있으면 삭제합니다.

    #error (Register for API Key and insert here. Then delete this line.)

    Xcode에서 수정을 위해 SDKDemoAPIKey 파일의 잠금을 해제하라는 메시지가 표시되면 Unlock을(를) 선택합니다.

    Objective-C

    SDKDemoAPIKey 파일을 수정하고 API 키 를 적절한 상수에 붙여넣습니다. 예를 들면 다음과 같습니다.

    static NSString *const kAPIKey = @"YOUR_API_KEY";

    다음 줄이 있으면 삭제합니다.

    #error (Register for API Key and insert here. Then delete this line.)

    Xcode에서 수정을 위해 SDKDemoAPIKey 파일의 잠금을 해제하라는 메시지가 표시되면 Unlock을(를) 선택합니다.

  7. 앱을 빌드합니다.
  8. 처음 실행할 때 빌드가 실패하거나 앱이 API 키 에 관한 오류로 비정상 종료되면 위의 안내에 필요한 키를 제공했는지 확인합니다.
  9. 샘플 앱을 실행하면 iOS 시뮬레이터 창에 장소 데모 목록이 표시됩니다.
  10. 데모 앱에서 위치에 액세스하도록 허용할지 묻는 메시지가 표시되면 Allow를 선택합니다.
  11. 이제 선택한 샘플을 실행할 준비가 되었습니다.