모든 준비를 마쳤습니다!

개발을 시작하려면 개발자 문서로 이동하세요.

Google Maps Android API 활성화

개발을 시작하기 위해 Google Developers Console에서 우선적으로 해야 할 일을 몇 가지 소개하겠습니다.

  1. 프로젝트 생성 또는 선택
  2. Google Maps Android API 활성화
  3. 적합한 키 생성
계속

API 키 가져오기

Google Maps Android API를 사용하려면 Google API Console에서 앱 프로젝트를 등록하고 앱에 추가할 수 있는 Google API 키를 획득해야 합니다. 참고: API 키에는 다양한 유형의 제한이 있습니다. Android 앱에 대한 제한이 적용된 API 키가 필요합니다(브라우저 제한 키 아님).

키를 가져오기 위한 빠른 가이드

1단계. Google API Console에서 API 키 가져오기

아래의 버튼을 클릭하면, 프로세스를 안내해 주고 Google Maps Android API을 자동으로 활성화합니다.

키 가져오기

참고:

  • Google Maps API 프리미엄 플랜 고객의 경우: 프로젝트 드롭다운 메뉴가 나타나면 Google Maps API 프리미엄 플랜 구매 시 생성된 프로젝트를 선택하세요. 프로젝트 이름은 Google Maps APIs for Business 또는 Google Maps for Work 또는 Google Maps로 시작합니다.
  • 프리미엄 플랜 라이선스를 구매하려면 판매부에 문의하세요.
  • 테스트 용도로, 모든 플랫폼에서 작동하는 일반적인 무제한 API 키를 만들 수 있습니다. 프로덕션으로 이동하기 전에 키의 보안을 설정하려면, 아래 설명된 대로 키를 제한해야 합니다.

2단계. 애플리케이션에 API 키 추가

아래 절차에 따라 AndroidManifest.xml 파일에 들어 있는 애플리케이션의 매니페스트에 API 키를 포함합니다.

  1. 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 키 값으로 설정합니다.

  2. AndroidManifest.xml을 저장하고 애플리케이션을 다시 빌드합니다.

참고: 위에서 본 바와 같이 com.google.android.geo.API_KEY는 API 키의 권장 메타데이터 이름입니다. 이 이름을 가진 키는 Android 플랫폼에서 Google Maps Android API를 비롯한 여러 가지 Google Maps 기반 API를 인증하는 데 사용할 수 있습니다. 이전 버전과의 호환성을 위해 이 API는 com.google.android.maps.v2.API_KEY 이름도 지원합니다. 이 레거시 이름은 Android Maps API v2만 인증할 수 있습니다. 애플리케이션은 API 키 메타데이터 이름 중에 하나만 지정할 수 있습니다. 두 개 모두 지정되면 API가 예외를 발생시킵니다.

다 되었습니다. 위 단계를 성공적으로 따랐다면 모든 과정을 마친 것입니다. 문제가 발생한 경우, 아래의 상세 지침에서 표준 API프리미엄 플랜을 참조하세요.

API 키를 가져오기 위한 상세 가이드

표준 Google Maps Android API 사용자를 위한 상세 가이드

버튼을 클릭했는데도 원하는 결과를 얻을 수 없다면, 아래의 대안 단계에 따라 API 키를 가져올 수 있습니다.

  1. Google API Console로 이동합니다.
  2. 프로젝트를 생성하거나 선택합니다.
  3. Continue를 클릭하여 Google Maps Android API를 활성화합니다.
  4. Credentials 페이지에서 API 키를 가져옵니다.
    참고: Android 제한이 있는 기존 API 키의 경우, 이 키를 사용할 수도 있습니다.
  5. API 키가 표시된 대화상자에서, Restrict key를 선택하여 Android 제한을 API 키에 설정합니다.
  6. Restrictions 섹션에서, Android 앱을 선택한 다음, 앱의 SHA-1지문과 패키지 이름을 입력합니다. 예:
    BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
    com.example.android.mapexample
  7. API 키 제한에 대한 자세한 내용은 아래를 참조하세요.
  8. Save를 클릭합니다.

프로젝트의 API 키 목록에 새 Android 제한 API 키가 나타납니다. API 키는 다음과 같은 문자열입니다.

AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

Google Maps API 프리미엄 플랜 라이선스 사용자를 위한 상세 가이드

버튼을 클릭했는데도 원하는 결과를 얻을 수 없다면, 아래의 대안 단계에 따라 API 키를 가져올 수 있습니다.

  1. Google API Console로 이동합니다.
  2. 프로젝트 드롭다운 메뉴에서 Google Maps Premium 프로젝트를 선택합니다.*
  3. Continue를 클릭합니다.
  4. Credentials 페이지에서 API 키를 가져옵니다.
  5. API 키가 표시된 대화상자에서, Restrict key를 선택하여 Android 제한을 API 키에 설정합니다.
  6. Restrictions 섹션에서, Android 앱을 선택한 다음, 앱의 SHA-1지문과 패키지 이름을 입력합니다. 예:
    BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
    com.example.android.mapexample
    API 키 제한에 대한 자세한 내용은 아래를 참조하세요.
  7. Save를 클릭합니다.

프로젝트의 API 키 목록에 새 Android 제한 API 키가 나타납니다. API 키는 다음과 같은 문자열입니다.

AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

Google API Console에 대한 추가 정보

Google API Console에서 기존 키를 찾을 수도 있습니다.

Google API Console 사용에 대한 자세한 내용은 API Console 도움말을 참조하세요.

API 키 제한에 대한 추가 정보

Google Maps API는 Android나 iOS 앱, 웹 브라우저 및 HTTP 웹 서비스를 통해 이용할 수 있습니다. 모든 플랫폼의 API가 일반적인(무제한) API 키를 사용할 수 있습니다. 선택적으로 제한을 추가할 수 있습니다. Android 앱의 경우, 이 키를 앱의 SHA-1 지문과 패키지 이름으로 제한할 수 있습니다. 제한된 키는 해당 유형의 제한을 지원하는 플랫폼에서만 작동합니다.

앱의 SHA-1 지문을 가져오는 위치

Android API 키 제한은 SHA-1 지문으로 알려진 짧은 형식의 앱 디지털 인증서를 기반으로 합니다.

Android Studio에서 인증 정보 가져오기

Google Maps Android API 시작 가이드를 따를 경우, Android Studio는 여러분의 앱 자격 증명으로 간단한 google_maps_api.xml 파일을 생성합니다.

다음 중 하나를 선택하여 Android Studio에서 API 키를 가져옵니다.

  • 빠르고 쉬운 방법: Android Studio가 생성한 google_maps_api.xml 파일에 있는 링크를 사용합니다.
    1. google_maps_api.xml 파일에 있는 링크를 복사하여 브라우저에 붙여넣습니다. 링크를 누르면 Google API Console로 이동하고, URL 매개변수를 통해 필수 정보를 Google API Console에 제공하므로, 개발자가 수동으로 입력해야 하는 항목이 줄어듭니다.
    2. 지침에 따라 Google API Console에서 새 프로젝트를 생성하거나 기존 프로젝트를 선택합니다.
    3. 프로젝트의 Android 제한 API 키를 생성합니다.
    4. 생성된 API 키를 복사하고 Android Studio로 돌아간 다음, google_maps_api.xml 파일의 <string> 요소에 API 키를 붙여넣습니다.
  • 약간 덜 빠른 방법: Android Studio가 생성한 google_maps_api.xml 파일에 있는 자격 증명을 사용합니다.
    1. google_maps_api.xml 파일에서 제공하는 자격 증명을 복사합니다.
    2. 브라우저에서 Google API Console로 이동합니다.
    3. 복사한 자격 증명을 사용하여 기존 API 키에 앱을 추가하거나 새 API 키를 생성합니다.

직접 인증서 정보 가져오기

앱을 생성할 때 시작 가이드를 따르지 않았다면, 직접 인증서의 SHA-1 지문을 가져와야 합니다. 먼저 유효한 인증서를 사용 중인지 확인합니다. 2개의 인증서를 가질 수 있습니다.

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

아래 단계에 따라 keytool 프로그램을 -v 매개변수와 함께 사용하여 인증서의 SHA-1 지문을 표시합니다. Keytool에 대한 자세한 내용은 Oracle 문서를 참조하세요.

디버그 인증서

디버그 인증서 지문 표시

  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 Vista 및 Windows 7의 경우 다음을 실행합니다.

      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
릴리스 인증서

릴리스 인증서 지문 표시

  1. 릴리스 인증서 키스토어 파일을 찾습니다. 릴리스 키스토어의 기본 위치 또는 이름이 없습니다. 릴리스용 앱을 빌드할 때 이를 지정하지 않으면, 빌드에서 .apk를 서명되지 않은 상태로 두며, 여기에 먼저 서명해야만 게시할 수 있습니다. 릴리스 인증서의 경우, 인증서의 별칭과 키스토어 및 인증서의 암호도 필요합니다. 다음을 입력하여 모든 키에 대해 별칭을 표시할 수 있습니다.

    keytool -list -keystore your_keystore_name

    your_keystore_name.keystore 확장명을 포함한 키스토어의 전체 경로 및 이름으로 대체합니다. 키스토어의 암호를 입력하라는 메시지가 나타납니다. 이어서 keytool이 키스토어의 모든 별칭을 표시합니다.

  2. 터미널이나 명령 프롬프트에서 다음을 입력합니다.

    keytool -list -v -keystore your_keystore_name -alias your_alias_name

    your_keystore_name.keystore 확장명을 포함한 키스토어의 전체 경로 및 이름으로 대체합니다. your_alias_name을 인증서를 생성할 때 할당한 별칭으로 대체합니다.

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

Alias name: <alias_name>
Creation date: Feb 02, 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: 4cc9b300
Valid from: Mon Feb 02 08:01:04 UTC 2013 until: Mon Feb 02 18:05:04 PST 2033
Certificate fingerprints:
    MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6B:AC:F9
    SHA1: BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:90:AF:A1:66:6E:44:5D:75
    Signature algorithm name: SHA1withRSA
    Version: 3

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

디지털 인증서에 대한 자세한 내용은 Android 가이드의 애플리케이션 서명을 참조하세요.

다음에 대한 의견 보내기...

Google Maps Android API
Google Maps Android API
도움이 필요하시나요? 지원 페이지를 방문하세요.