Google Maps API 키 가져오기Obtaining a Google Maps API Key

Android에서 Google Maps 기능을 사용 하려면 google Maps API 키를 등록 해야 합니다.To use the Google Maps functionality in Android, you need to register for a Maps API key with Google. 이 작업을 수행 될 때까지 응용 프로그램에 맵이 아니라 표에서 비어 있는 표시 됩니다.Until you do this, you will just see a blank grid instead of a map in your applications. Google Maps Android API v2 키를 받아야-이전 Google Maps Android API 키 v1의 키 작동 하지 않습니다.You must obtain a Google Maps Android API v2 key - keys from the older Google Maps Android API key v1 will not work.

Maps API v2 키를 가져오는 단계는 다음과 같습니다.Obtaining a Maps API v2 key involves the following steps:

  1. 응용 프로그램 서명에 사용 되는 키 저장소의 SHA-1(secure 지문을 검색 합니다.Retrieve the SHA-1 fingerprint of the keystore that is used to sign the application.
  2. Google Api 콘솔에서 프로젝트를 만듭니다.Create a project in the Google APIs console.
  3. API 키를 가져옵니다.Obtaining the API key.

서명 키 지문 가져오기Obtaining your Signing Key Fingerprint

Google Maps API 키를 요청 하려면 응용 프로그램 서명에 사용 되는 키 저장소의 sha-1 지문 알 필요가 있습니다.To request a Maps API key from Google, you need to know the SHA-1 fingerprint of the keystore that is used to sign the application. 일반적으로 디버그 키 저장소에 대 한 sha-1 지문 결정 해야 하 고 릴리스에 대 한 응용 프로그램에 서명 하는 데 사용 되는 키 저장소에 대 한 sha-1 지문 다음 의미 합니다.Typically, this means you will have to determine the SHA-1 fingerprint for the debug keystore, and then the SHA-1 fingerprint for the keystore that is used to sign your application for release.

Xamarin.Android 응용 프로그램의 디버그 버전에 서명 하는 데 사용 되는 키 저장소를 기본적으로 다음 위치에서 찾을 수 있습니다:By default the keystore that is used to sign debug versions of a Xamarin.Android application can be found at the following location:

C:\사용자가\[USERNAME]\AppData\로컬\Xamarin\Android 용 Mono\debug.keystoreC:\Users\[USERNAME]\AppData\Local\Xamarin\Mono for Android\debug.keystore

JDK에서 keytool 명령을 실행하면 키 저장소에 대한 정보를 가져올 수 있습니다.Information about a keystore is obtained by running the keytool command from the JDK. 이 도구는 일반적으로 Java bin 디렉터리에 있습니다.This tool is typically found in the Java bin directory:

C:\Program Files (x86)\Java\jdk[VERSION]\bin\keytool.exeC:\Program Files (x86)\Java\jdk[VERSION]\bin\keytool.exe

Keytool (위에 표시 된 파일 경로 사용) 다음 명령을 사용 하 여 실행 합니다.Run keytool using the following command (using the file paths shown above):

keytool -list -v -keystore [STORE FILENAME] -alias [KEY NAME] -storepass [STORE PASSWORD] -keypass [KEY PASSWORD]

Debug.keystore 예제Debug.keystore Example

(자동으로 생성 된 수에 대 한 디버깅을 위해)는 기본 디버그 키에 대해이 명령을 사용 합니다.For the default debug key (which is automatically created for you for debugging), use this command:

keytool.exe -list -v -keystore "C:\Users\[USERNAME]\AppData\Local\Xamarin\Mono for Android\debug.keystore" -alias androiddebugkey -storepass android -keypass android

프로덕션 키Production Keys

Google Play에 앱을 배포 하는 경우 이어야 합니다 개인 키를 사용 하 여 서명합니다.When deploying an app to Google Play, it must be signed with a private key. keytool 개인 키 세부 정보 및 프로덕션 Google Maps API 키를 만드는 데 사용 되는 결과 SHA-1(secure 지문을 사용 하 여 실행 해야 합니다.The keytool will need to be run with the private key details, and the resulting SHA-1 fingerprint used to create a production Google Maps API key. 업데이트 해야 합니다 AndroidManifest.xml 배포 하기 전에 올바른 Google Maps API 키가 있는 파일입니다.Remember to update the AndroidManifest.xml file with the correct Google Maps API key before deployment.

Keytool 출력Keytool Output

콘솔 창 출력은 다음과 같이 표시 됩니다.You should see something like the following output in your console window:

Alias name: androiddebugkey
Creation date: Jan 01, 2016
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

SHA-1(secure 지문을 사용 하 여 (후 나열 SHA1)이이 가이드의 뒷부분에 나오는.You will use the SHA-1 fingerprint (listed after SHA1) later in this guide.

API 프로젝트 만들기Creating an API project

서명 키 저장소의 sha-1 지문에 검색 한 후 Google Api 콘솔에서 새 프로젝트를 만듭니다 (또는 기존 프로젝트에 Google Maps Android API v2 서비스를 추가) 하는 데 필요한 것입니다.After you have retrieved the SHA-1 fingerprint of the signing keystore, it is necessary to create a new project in the Google APIs console (or add the Google Maps Android API v2 service to an existing project).

  1. 브라우저에서로 이동 합니다 Google 개발자 콘솔 API 및 서비스 대시보드 클릭 프로젝트를 선택합니다.In a browser, navigate to the Google Developers Console API & Services Dashboard and click Select a project. 프로젝트 이름을 클릭 하거나 클릭 하 여 새로 만듭니다 새 프로젝트:Click on a project name or create a new one by clicking NEW PROJECT:

    Google 개발자 콘솔 만들기 프로젝트 단추Google Developer Console CREATE PROJECT button

  2. 새 프로젝트를 만든 경우에 프로젝트 이름을 입력 합니다 새 프로젝트 대화 상자가 표시 됩니다.If you created a new project, enter the project name in the New Project dialog that is displayed. 이 대화 상자에 프로젝트 이름을 기반으로 하는 고유한 프로젝트 ID를 제조할 것입니다.This dialog will manufacture a unique project ID that is based on your project name. 다음을 클릭 합니다 만들기 이 예와 같이 단추:Next, click the Create button as shown in this example:

    새 프로젝트 XamarinMapsDemo 라고 합니다.New project is named XamarinMapsDemo

  3. 프로젝트가 생성 되는 1 분 정도 후 및 이동 합니다 대시보드 프로젝트의 페이지입니다.After a minute or so, the project is created and you are taken to the Dashboard page of the project. 여기에서 클릭 API 및 서비스를 사용 하도록 설정:From there, click ENABLE APIS AND SERVICES:

    라이브러리 섹션에서 Google Maps Android API를 클릭합니다.Clicking Google Maps Android API in the Library section

  4. API 라이브러리 페이지에서 클릭 Android 용 Maps SDK합니다.From the API Library page, click Maps SDK for Android. 다음 페이지에서 클릭 사용 이 프로젝트에 대 한 서비스를 활성화 하려면:On the next page, click ENABLE to turn on the service for this project:

    대시보드 섹션에서 설정 단추를 클릭Clicking the ENABLE button in the Dashboard section

이 시점에서 API 프로젝트를 만들었으며 Google Maps Android API v2에 추가 되었습니다.At this point the API project has been created and Google Maps Android API v2 has been added to it. 그러나에 대 한 자격 증명을 만들 때까지 프로젝트에서이 API을 사용할 수 없습니다.However, you cannot use this API in your project until you create credentials for it. 다음 섹션에서는이 키를 사용 하도록 권한이 부여 된 있도록 Xamarin.Android 응용 프로그램 허용 목록 및 API 키를 만드는 방법을 설명 합니다.The next section explains how to create an API key and white-list a Xamarin.Android application so that it is authorized to use this key.

API 키 가져오기Obtaining the API Key

후 합니다 Google 개발자 콘솔 API 프로젝트 되었습니다 생성 해야 하는 Android API 키를 만듭니다.After the Google Developer Console API project has been created, it is necessary to create an Android API key. Xamarin.Android 응용 프로그램 Android 맵 API v2에 대 한 액세스를 부여 된 API 키가 있어야 합니다.Xamarin.Android applications must have an API key before they are granted access to Android Map API v2.

  1. Android 용 Maps SDK 표시 되는 페이지 (클릭 한 후 사용 하도록 설정 이전 단계에서)로 이동 합니다 자격 증명 탭을 클릭는 만들기 자격 증명 단추:In the Maps SDK for Android page that is displayed (after clicking ENABLE in the previous step), go to the Credentials tab and click the Create credentials button:

    Android 자격 증명 메시지에 대 한 지도 SDKMaps SDK for Android Credentials message

  2. 클릭 API 키:Click API key:

    프로젝트 대화 상자에 자격 증명 추가Add credentials to your project dialog

  3. 이 단추를 클릭 한 후에 API 키 생성 됩니다.After this button is clicked, the API key is generated. 다음은 앱에만이 키를 사용 하 여 Api를 호출할 수 있도록이 키를 제한 해야 합니다.Next it is necessary to restrict this key so that only your app can call APIs with this key. 클릭 제한 키:Click RESTRICT KEY:

    자격 증명 페이지에서 키 제한을 클릭합니다.Clicking Restrict Key on the Credentials page

  4. 변경 합니다 이름 필드를 API 키 1 에 사용 되는 키를 기억 하는 데 도움이 되는 이름으로 (XamarinMapsDemoKey 이 예제에서 사용).Change the Name field from API Key 1 to a name that will help you remember what the key is used for (XamarinMapsDemoKey is used in this example). 다음을 클릭 합니다 Android 앱 라디오 단추:Next, click the Android apps radio button:

    자격 증명 페이지에서 Android 앱을 선택합니다.Selecting Android apps on the Credentials page

  5. Sha-1 지문에 추가 하려면 클릭 + 추가 패키지 이름 및 지문:To add the SHA-1 fingerprint, click + Add package name and fingerprint:

    추가 패키지 이름 및 지문을 클릭Clicking Add package name and fingerprint

  6. 앱의 패키지 이름을 입력 하 고는 sha-1 인증서 지문을 입력 (을 통해 얻은 keytool 이 가이드의 앞부분에 설명 된 대로).Enter your app's package name and enter the SHA-1 certificate fingerprint (obtained via keytool as explained earlier in this guide). 다음 예에서는 패키지에 대 한 이름을 XamarinMapsDemo 입력 이면 뒤에에서 가져온 sha-1 인증서 지문 debug.keystore:In the following example, the package name for XamarinMapsDemo is entered, followed by the SHA-1 certificate fingerprint obtained from debug.keystore:

    패키지 이름 입력은 com.xamarin.docs.android.mapPackage name entered is com.xamarin.docs.android.map

  7. Google Maps에 액세스할 APK에 대 한 순서로 sha-1 지문 포함 하며 APK에 서명 하는 데 사용 하는 모든 keystore (디버그 및 릴리스)에 대 한 이름을 패키지 note 합니다.Note that, in order for your APK to access Google Maps, you must include SHA-1 fingerprints and package names for every keystore (debug and release) that you use to sign your APK. 예를 들어, 디버그 및 릴리스 APK를 생성 하기 위한 다른 컴퓨터에 대 한 컴퓨터를 사용 하는 경우 포함 해야 첫 번째 컴퓨터의 디버그 키 저장소에서 sha-1 인증서 지문 및의 릴리스 키 저장소에서 sha-1 인증서 지문 두 번째 컴퓨터입니다.For example, if you use one computer for debug and another computer for generating the release APK, you should include the SHA-1 certificate fingerprint from the debug keystore of the first computer and the SHA-1 certificate fingerprint from the release keystore of the second computer. 클릭 + 추가 패키지 이름 및 지문 이 예와 같이 다른 지문 및 패키지 이름을 추가 하려면:Click + Add package name and fingerprint to add another fingerprint and package name as shown in this example:

    다른 sha-1 인증서를 만들고 다른 지문 추가Adding another fingerprint creates another SHA-1 certificate

  8. 저장 단추를 클릭하여 변경 내용을 저장합니다.Click the Save button to save your changes. 다음으로, API 키의 목록으로 돌아가게 됩니다.Next, you are returned to the list of your API keys. 이전에 만든 다른 API 키가 있으면 해당도 여기에 나열 됩니다.If you have other API keys that you have created earlier, they will also be listed here. 이 예제에서는 하나의 API 키 (이전 단계에서 만든) 나열 됩니다.In this example, only one API key (created in the previous steps) is listed:

    XamarinMapsDemoKey는 API 키 목록에 표시 됩니다.XamarinMapsDemoKey is shown in the API keys list

청구 계정에 프로젝트 연결Connect the project to a billable account

11 2018 년 6 월부터 API 키 작동 하지 않습니다 (경우에이 서비스는 여전히 모바일 앱 용) 프로젝트 청구 계정에 연결 되지 않은 경우.Beginning June,11 2018, the API key will not work if the project is not connected to a billable account (even if the service is still free for mobile apps).

  1. 햄버거 메뉴 단추를 클릭 하 고 선택 합니다 청구 페이지:Click the hamburger menu button and select the Billing page:

    햄버거 메뉴의 청구 섹션 선택Selecting the hamburger menu billing section

  2. 프로젝트를 클릭 하 여 대금 청구 계정에 연결 청구 계정을 연결할대금 청구 계정 만들기 표시 된 팝업 (계정이 없다면 안내 새로 만들려면):Link the project to a billing account by clicking Link a billing account followed by CREATE BILLING ACCOUNT on the displayed popup (if you don't have an account, you will be guided to create a new one):

    청구 계정에 링크 프로젝트Link project to billing account

프로젝트에 키 추가Adding the Key to Your Project

마지막으로,이 API 키를 추가 합니다 AndroidManifest.XML Xamarin.Android 앱의 파일입니다.Finally, add this API key to the AndroidManifest.XML file of your Xamarin.Android app. 다음 예에서 YOUR_API_KEY 이전 단계에서 생성 된 API 키를 사용 하 여 대체 됨:In the following example, YOUR_API_KEY is to be replaced with the API key generated in the previous steps:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    android:versionName="4.10" package="com.xamarin.docs.android.mapsandlocationdemo"
    android:versionCode="10">
...
  <application android:label="@string/app_name">
    <!-- Put your Google Maps V2 API Key here. -->
    <meta-data android:name="com.google.android.maps.v2.API_KEY" android:value="YOUR_API_KEY" />
    <meta-data android:name="com.google.android.gms.version" android:value="@integer/google_play_services_version" />
  </application>
</manifest>