설정 및 데모

플랫폼 선택: Android iOS

이 페이지에서는 iOS용 Maps SDK의 유틸리티 라이브러리 를 설정하는 방법을 설명합니다.

이러한 유틸리티를 사용해 보려면 다음 중 하나를 실행하면 됩니다.

Xcode 프로젝트에 iOS용 Maps SDK 유틸리티 라이브러리 추가

다음 절차에 따라 Xcode 작업 영역에 유틸리티 라이브러리를 추가합니다.

Swift Package Manager 사용

  1. 아직 Xcode 프로젝트가 없으면 지금 만들어 로컬 시스템에 저장합니다. iOS용 앱을 처음 개발하는 경우 새 프로젝트를 만들고 iOS 앱 템플릿을 선택합니다. Xcode 11.7 이전 버전에서 단일 뷰 애플리케이션 을 만듭니다.)
  2. iOS용 Maps SDK를 종속 항목으로 추가합니다. 옵션은 SDK 설치를 참고하세요.
  3. Xcode 프로젝트에서 File(파일) -> Swift Packages(Swift 패키지) -> Add Package Dependency(패키지 종속 항목 추가)로 이동합니다.
  4. 표시된 창에서 iOS용 Maps SDK 유틸리티 라이브러리 저장소 URL https://github.com/googlemaps/google-maps-ios-utils을 입력하고 Next(다음)를 선택합니다.
    • 이때 GitHub 계정으로 인증하라는 메시지가 표시될 수 있습니다. 안내에 따라 GitHub 개인 액세스 토큰을 만들어 프로세스를 계속합니다.
  5. 다음 창에서 Version(버전) 라디오 옵션을 선택하고 드롭다운 목록에서 Up to Next Major Version(다음 주요 버전까지)을 선택한 후 iOS용 Maps SDK 유틸리티 라이브러리의 최신 버전(예: '6.0.0')을 입력합니다.
  6. Add to Project(프로젝트에 추가) 옆에 있는 드롭다운을 클릭하고 프로젝트를 선택한 후 Add Package(패키지 추가)를 선택합니다.

앱에 API 키 추가

API 키를 생성하고 Xcode 프로젝트에 추가하는 방법은 Xcode 프로젝트 설정을 참고하세요.

프로젝트 빌드 및 실행

API 키를 추가한 후 프로젝트를 빌드하고 실행합니다.

앱에서 유틸리티 사용

앱에서 유틸리티를 사용하는 방법에 관한 자세한 내용은 각 유틸리티의 문서를 참고하세요.

데모 앱 설치 및 실행

유틸리티 라이브러리에는 설치한 후 각 유틸리티를 사용해 볼 수 있는 데모 앱이 포함되어 있습니다.

데모 앱 설치:

GitHub의 파일 사용

  1. GitHub에서 코드 샘플 보관 파일을 다운로드하고 보관 파일의 압축을 풉니다. 또는 저장소를 로컬 디렉터리로 클론합니다. 
    git clone https://github.com/googlemaps/google-maps-ios-utils.git
  2. 터미널 창을 열고 샘플 파일의 압축을 푼 디렉터리로 이동한 후 사용하려는 언어의 적절한 샘플 디렉터리로 드릴다운합니다.

    Swift

    cd google-maps-ios-utils/samples/SwiftDemoApp
open SwiftDemoApp.xcodeproj

    Objective-C

    cd google-maps-ios-utils/samples/ObjCDemoApp
open ObjCDemoApp.xcodeproj

데모 앱에 API 키 추가

API 키 가져오기에서 앱의 API 키를 생성합니다. 이제 데모 앱의 Xcode 프로젝트에 해당 키를 추가합니다.

Swift

다음과 같이 API 키를 AppDelegate.swift에 추가합니다.

  1. 다음 import 문을 추가합니다. 
    import GoogleMaps
  2. 다음 줄을 수정하여 큰따옴표 사이에 API 키를 추가합니다. 
    // Change this key to a valid key registered with the demo app bundle id.
let mapsAPIKey = ""

Objective-C

다음과 같이 API 키를 AppDelegate.m에 추가합니다.

  1. 다음 import 문을 추가합니다. 
    @import GoogleMaps;
  2. 다음 줄을 수정하여 큰따옴표 사이에 API 키를 추가합니다. 
    // Change this key to a valid key registered with the demo app bundle id.
static NSString *const kMapsAPIKey = @"";

데모 앱 빌드 및 실행

API 키를 추가한 후 프로젝트를 빌드하고 실행합니다.

  • 데모의 Swift 버전을 실행하는 경우 앱에서 볼 유틸리티를 선택할 수 있습니다.
  • 데모의 Objective-C 버전을 실행하는 경우 마커 클러스터링 유틸리티의 데모가 표시됩니다. 그런 다음 데모의 Objective-C 버전을 수정하여 각 유틸리티를 사용해 볼 수 있습니다. 자세한 내용은 아래의 앱에 유틸리티 추가 섹션을 참고하세요.