설정 및 데모

플랫폼 선택: 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 프로젝트에서 파일로 이동합니다. Swift 패키지 -> 패키지 종속 항목 추가.
  4. 표시된 창에 iOS용 Maps SDK 유틸리티 라이브러리 저장소 URL을 입력합니다. https://github.com/googlemaps/google-maps-ios-utils을 클릭하고 Next를 선택합니다.
    • 이 시점에서 GitHub 계정으로 인증하라는 메시지가 표시될 수 있습니다. 안내에 따라 GitHub 개인 액세스 토큰을 사용하여 프로세스를 계속 진행합니다.
  5. 다음 창에서 버전 라디오 옵션을 선택하고 최대 다음 메이저 버전을 선택합니다. 드롭다운 목록에서 클릭한 다음 iOS용 Maps SDK 유틸리티 라이브러리의 최신 버전을 입력합니다. (예: '6.0.0')
  6. 프로젝트에 추가 옆의 드롭다운을 클릭하고 프로젝트를 선택한 다음 패키지 추가를 선택합니다.

CocoaPods 사용

  1. 아직 Xcode 프로젝트가 없으면 지금 만들어 가상 머신을 실행하는 것입니다 (iOS 개발이 처음인 경우 싱글 애플리케이션 보기를 참고하세요.)
  2. 아직 프로젝트에 사용할 포드 파일이 없는 경우 파일을 만듭니다. Podfile라는 이름을 입력합니다. 이 파일은 도움이 됩니다
  3. 프로젝트의 포드 파일을 수정하고 Google-Maps-iOS-Utils 포드. 다음은 이 예시에서는 iOS용 Maps SDK 및 유틸리티 라이브러리: 
    source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '15.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  use_frameworks!
  pod 'GoogleMaps', '9.0.0'
  pod 'Google-Maps-iOS-Utils', '6.0.0' # x-release-please-version
end
  4. pod install을 실행합니다.
  5. Xcode를 닫은 다음 프로젝트의 .xcworkspace 파일을 사용하여 Xcode를 실행합니다. 지금부터 .xcworkspace 파일을 사용하여 프로젝트를 열어야 합니다.

참고: 마커 클러스터링 유틸리티는 쿼드트리를 사용하지만, 마커 클러스터링 없이 쿼드트리를 사용할 수 있습니다. 원하는 경우 쿼드트리 유틸리티만 사용하는 경우에는 pod 'Google-Maps-iOS-Utils'부터 'Google-Maps-iOS-Utils/QuadTree'를 포함해야 합니다.

앱에 API 키 추가

코드 생성 방법은 Xcode 프로젝트 설정을 참조하세요. Xcode 프로젝트에 추가하는 방법을 알아보겠습니다.

프로젝트 빌드 및 실행

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

앱에서 유틸리티 사용

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

데모 앱 설치 및 실행

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

다음 두 가지 방법 중 하나를 사용하여 데모 앱을 설치합니다.

GitHub의 파일 사용

  1. 다운로드 코드 샘플 보관 파일을 GitHub 아카이브를 압축 해제합니다
  2. 터미널 창을 열고 샘플 파일을 확장한 디렉터리로 이동합니다. 사용하려는 언어에 적합한 샘플 디렉터리를 선택합니다.
    • Swift의 경우 cd google-maps-ios-utils-master/samples/SwiftDemoApp 실행
    • Objective-C의 경우 cd google-maps-ios-utils-master/samples/ObjCDemoApp를 실행합니다.
  3. 다음 명령어를 실행합니다.
    pod install
  4. Xcode를 닫은 다음 프로젝트의 .xcworkspace 파일을 사용하여 Xcode를 실행합니다. 지금부터 .xcworkspace 파일을 사용하여 프로젝트를 열어야 합니다.

CocoaPods v1.6.1 사용

  1. 터미널 창을 열고 버전 1.6.1을 설치합니다. 
    sudo gem install cocoapods -v1.6.1
  2. CocoaPods를 사용하여 Google 지도 파일을 가져옵니다. 
    pod try Google-Maps-iOS-Utils

    메시지가 나타나면 Swift 또는 Objective-C를 선택합니다. CocoaPods는 사양 저장소를 업데이트하므로 그런 다음 SwiftDemoApp.xcodeproj라는 임시 Xcode 프로젝트에서 데모를 엽니다. 또는 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 버전의 데모를 편집하여 각 유틸리티를 사용해 볼 수 있습니다. 자세한 내용은 아래의 앱에 유틸리티 추가 섹션을 참고하세요.