180904(화) Google Maps (Get API Key)

Google Maps

Get API Key

1. Google Cloud Platform Console에서 API key getting

- unrestricted API key 이다.

- https://cloud.google.com/maps-platform/#get-started

・ Tip

- testing 및 development 목적으로 unrestricted API key

- production용으로는 따로 project를 생성한 뒤 restricted API key 발급 받아 사용

・ Premium plan customers

- 돈주고 premium을 샀으면, purchased 때 받은 API key를 넣으면 된다.

2. Add API key to application

- AndroidManifest.xml의 <application> element에 추가.

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

Note : com.google.android.geo.API_KEY 대신에, 이전버전 호환을 위해서 com.google.android.maps.v2.API_KEY를 사용할 수도 있다. 대신에 Android Maps API v2만 사용 가능하며, 위 둘중 하나만 하용 가능함. 중복되면 throws exception 발생

Detailed guides to getting an API key

- standard Maps SDK for Android

1. go to GCPC

2. create or select project

3. enable the Maps SDK for Android

4. credentials page에서 API key를 가져온다.

5. API key displaying dialog에서, Restrict key를 선택하여 Android restriction API key를 설정

6. Restrictions 후에 Android apps를 선택, app's SHA-1 fingerprint and package name 을 입력

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. save!

- API key 는 string of characters, something like this

AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

Note : standard API를 사용하면, Maps SDK and Places SDK에 동일한 API key를 사용 가능하다.

Detailed guide for Premium Plan license

1. go to GCPC

2. purchased Google Maps APIs Premium Plan의 project를 선택

3. credentials page에서 API key를 가져온다.

4. API key displaying dialog에서, Restrict key를 선택하여 Android restriction API key를 설정

5. Restrictions 후에 Android apps를 선택, app's SHA-1 fingerprint and package name 을 입력

BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75

com.example.android.mapexample

6. save!

More about API key restrictions

- APIs on any platform can use a generic (unrestricted) API key

- Android app의 경우 SHA-1 fingerprint an package name으로 restrict 한다.

- restricted key는 restriction type을 지원하는 해당 platform에서만 동작한다.

Where to get app's SHA-1 fingerprint

- Android API key restriction은 SHA-1 fingerprint라고 하는 short form digital certificate를 기반으로 한다.

- Android Studio 가 google_maps_api.xml file과 함께  app's credentials를 쉽게 만들어준다. (Get Started 참조)

- Getting the certificate information yourself

・ getting start guide대로 따라하지 않았으면, SHA-1 fingerprint를 수동으로 가져와야 한다.

・ 두가지 종류의 certificates가 있을 수 있다.

Debug certificate

- Android SDK tools는 debug build를 돌릴때 자동으로 이 certificate를 생성한다.

- testing에서만 사용됨

- Do not attempt to publish app that's signed with a debug certificate

- Signing in Debug Mode

- used keytools

・ macOS : ~/.android/

・ list the SHA-1 fingerprint

keytool -list -v -keystore ~/.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

Release certificate

- Android SDK tools는 release build를 돌릴때 자동으로 certificate 생성

- keytool program을 이용해서 생성도 가능

・ Oracle documentation.

・ default location or name은 없다.

・ 모든 key에 대해서 aliases entering 가능

keytool -list -keystore your_keystore_name

keytool -list -v -keystore your_keystore_name -alias 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

・ fully-qualifed path를 적으면 list 출력됨

- release할 준비가 되었으면 사용