[Android] 구글맵 (GoogleMap) SDK 설치 및 API Key 발급

구글 맵을 이용하기 위해서는 구글 API Key를 발급받아야 합니다.

Google Maps Android API 특징

Google Maps Android API를 사용하면 Google 지도 데이터에 기반한 지도를 애플리케이션에 추가할 수 있습니다. API는 Google 지도 서버 액세스, 데이터 다운로드, 지도 표시 및 지도 제스처에 대한 응답을 자동으로 처리합니다. 또한, API 호출을 사용하여 기본 지도에 마커, 폴리곤, 오버레이를 추가하고 특정 지도 영역의 사용자 뷰를 변경할 수 있습니다. 이러한 객체는 지도 위치에 대한 추가 정보를 제공하고 지도와 사용자 간의 상호작용을 허용합니다. 이 API를 사용하면 지도에 다음과 같은 그래픽을 추가할 수 있습니다.

• 지도의 특정 위치에 고정된 아이콘(마커).
• 선 세그먼트 집합(폴리라인).
• 닫힌 세그먼트(폴리곤).
• 지도의 특정 위치에 고정된 비트맵 그래픽(그라운드 오버레이).
• 기본 지도 타일 위에 표시되는 이미지 집합 (타일 오버레이).

구글 맵을 추가하는 전체 과정

Google Play 서비스 SDK를 설치하고 구성합니다. 여기에는 Google Maps Android API가 포함되어 있습니다.

구글 플레이 서비스를 설치하는 방법

구글 플레이 서비스를 이용한 앱을 개발하기 위해서는 구글 플레이 서비스 SDK를 프로젝트에 셋업해야합니다.

만약 설치되어있지 않다면 아래와 가이드를 따라하시면 됩니다.

1. 안드로이드 스튜디오를 실행합니다.
2. Tools -> Android -> SDK Manager
3. SDK Tools click
4. upport Repository - Google Repository 선택 후 Ok

테스트를 위해서는 안드로이드 디바이스는 Android 4.0 또는 그 이상의 버전을 사용해야 합니다.

2. 구글 플레이 서비스를 프로젝트에 추가하기

build.gradle 파일을 열어서 아래에 추가합니다.

Google Play services API	Description in build.gradle
Google+	com.google.android.gms:play-services-plus:10.2.6
Google Account Login	com.google.android.gms:play-services-auth:10.2.6
Google Actions, Base Client Library	com.google.android.gms:play-services-base:10.2.6
Google Address API	com.google.android.gms:play-services-identity:10.2.6
Google Analytics	com.google.android.gms:play-services-analytics:10.2.6
Google Awareness	com.google.android.gms:play-services-awareness:10.2.6
Google Cast	com.google.android.gms:play-services-cast:10.2.6
Google Cloud Messaging	com.google.android.gms:play-services-gcm:10.2.6
Google Drive	com.google.android.gms:play-services-drive:10.2.6
Google Fit	com.google.android.gms:play-services-fitness:10.2.6
Google Location and Activity Recognition	com.google.android.gms:play-services-location:10.2.6
Google Maps	com.google.android.gms:play-services-maps:10.2.6
Google Mobile Ads	com.google.android.gms:play-services-ads:10.2.6
Google Places	com.google.android.gms:play-services-places:10.2.6
Mobile Vision	com.google.android.gms:play-services-vision:10.2.6
Google Nearby	com.google.android.gms:play-services-nearby:10.2.6
Google Panorama Viewer	com.google.android.gms:play-services-panorama:10.2.6
Google Play Game services	com.google.android.gms:play-services-games:10.2.6
SafetyNet	com.google.android.gms:play-services-safetynet:10.2.6
Android Pay	com.google.android.gms:play-services-wallet:10.2.6
Android Wear	com.google.android.gms:play-services-wearable:10.2.6

dependencies { 

    ...
    compile 'com.google.android.gms:play-services-maps:10.2.6'
    compile 'com.google.android.gms:play-services-location:10.2.6'
}

그리고 Sync 버튼을 클릭합니다.

인스톨되어있지 않다는 문구가 출력될 것이고, 설치 버튼을 눌러 설치합니다.

3. API 키를 가져옵니다. 이를 위해 프로젝트를 Google API Console에 등록하고, API 키를 만들고, 자신의 앱 서명 인증서를 사용하여 API 키를 제한해야 합니다.

https://console.developers.google.com/cloud-resource-manager 에 접속해서 Key를 발급 받을 수 있습니다.

1. 

2. 

3. 

4. 

5. 

6. 

7. 

8. 

 

패키지는 본인 프로젝트의 패키지명을 가져오면 되고, SHA-1 인증서 지문은 개인 PC에 저장된 값을 가져와야합니다.

직접 인증서 정보 가져오기

• 디버그 인증서: Android SDK 도구는 디버그 빌드 수행 시 이 인증서를 자동으로 생성합니다. 이 인증서는 테스트 중인 앱에서만 사용합니다. 디버그 인증서로 서명된 앱은 게시하지 마십시오. 
• 릴리스 인증서: Android SDK 도구는 릴리스 빌드 수행 시 이 인증서를 자동으로 생성합니다. keytool 프로그램을 사용하여 이 인증서를 생성할 수도 있습니다. 전세계에 앱 출시를 준비할 때 이 인증서를 사용합니다.

아래 단계에 따라 keytool 프로그램을 -v 매개변수와 함께 사용하여 인증서의 SHA-1 지문을 표시합니다

1. 디버그 키스토어 파일을 찾습니다. 파일 이름은 debug.keystore이고 처음 프로젝트를 빌드할 때 생성됩니다. 기본적으로 Android Virtual Device (AVD) 파일과 동일한 디렉토리에 저장됩니다.

   • macOS 및 Linux: ~/.android/
   • Windows Vista 및 Windows 7: C:\Users\your_user_name\.android\

2. SHA-1 지문 표시:

   • Linux 또는 macOS의 경우, 터미널 창을 열고 다음을 입력합니다.

     keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android

   • Windows 경우 CMD 창을 열 다음을 실행합니다.
     반드시 JDK 가 환경변수에 등록되어있어야 합니다
     

     

     
     

     keytool -list -v -keystore "%USERPROFILE%\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android

다음과 유사하게 출력되어야 합니다.

Alias name: androiddebugkey
Creation date: Jan 01, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4aa9b300
Valid from: Mon Jan 01 08:04:04 UTC 2013 until: Mon Jan 01 18:04:04 PST 2033
Certificate fingerprints:
     MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6A:AC:F9
     SHA1: BB:0D:AC:74:D3:21:E1:43:07:71:9B:62:90:AF:A1:66:6E:44:5D:75
     Signature algorithm name: SHA1withRSA
     Version: 3

SHA1로 시작하는 줄은 인증서의 SHA-1 지문을 포함합니다. 지문은 콜론으로 구분된 20개의 두 자리 16진수 시퀀스입니다.

4. 애플리케이션 매니페스트에 필요한 설정을 추가합니다.

AndroidManifest.xml에서 </application> 태그를 닫기 직전에 다음 요소를 삽입하여 <application> 요소의 하위 요소로 추가합니다.

    <meta-data
        android:name="com.google.android.geo.API_KEY"
        android:value="YOUR_API_KEY"/>
    

value 특성에서 API 키를 YOUR_API_KEY로 교체합니다. 이 요소는 com.google.android.geo.API_KEY 키를 API 키 값으로 설정합니다.

YOUR_API_KEY 는 BB:0D:AC:74:D3:21:E1:43:07:71:9B:62:90:AF:A1:66:6E:44:5D:75 입니다.