Untuk menggunakan Google Awareness API, Anda harus menambahkan kunci Google API ke aplikasi. Jenis kunci API yang diperlukan adalah kunci API Android.
Semua aplikasi Android ditandatangani dengan sertifikat digital yang Anda miliki kunci pribadinya. Untuk mendapatkan informasi selengkapnya tentang sertifikat digital, lihat panduan Android tentang cara menandatangani aplikasi Anda.
Kunci Android API ditautkan ke pasangan paket sertifikat tertentu. Anda hanya memerlukan satu kunci untuk setiap sertifikat, terlepas dari jumlah pengguna yang dimiliki untuk aplikasi tersebut.
Beberapa langkah diperlukan agar Anda mendapatkan kunci untuk aplikasi. Hal tersebut dijelaskan secara mendetail dalam panduan ini dan diringkas sebagai berikut:
- Mendapatkan informasi tentang sertifikat aplikasi Anda.
- Mendaftarkan project di Google Developers Console dan menambahkan User Context API sebagai layanan untuk project tersebut.
- Mintalah kunci.
- Tambahkan kunci ke aplikasi Anda. Untuk melakukannya, tambahkan elemen ke manifes aplikasi Anda.
Menemukan informasi sertifikat aplikasi
Kunci API didasarkan pada bentuk singkat sertifikat digital aplikasi Anda, yang dikenal sebagai sidik jari SHA-1. Agar dapat menampilkan sidik jari SHA-1 untuk sertifikat Anda, pastikan Anda menggunakan sertifikat yang tepat. Anda mungkin memiliki dua sertifikat berikut yang dapat dipilih:
- Sertifikat debug: Android SDK Tools membuat sertifikat ini secara otomatis saat Anda membuat build debug. Hanya gunakan sertifikat ini bersama aplikasi yang sedang Anda uji. Jangan mencoba memublikasikan aplikasi yang ditandatangani dengan sertifikat debug. Sertifikat debug dijelaskan secara lebih mendetail di bagian Menandatangani build debug dalam dokumentasi developer Android.
- Sertifikat rilis: Android SDK Tools membuat sertifikat ini saat Anda membuat build rilis. Anda juga dapat membuat sertifikat ini dengan program
keytool
. Gunakan sertifikat ini jika Anda siap merilis aplikasi ke seluruh dunia.
Untuk informasi selengkapnya tentang keytool
, lihat
dokumentasi Oracle.
Menampilkan sidik jari sertifikat debug
Gunakan program keytool
dengan parameter -v
untuk menampilkan
sidik jari SHA-1 sertifikat. Caranya, selesaikan langkah-langkah berikut:
Temukan file keystore debug Anda. Nama filenya adalah
debug.keystore
, dan dibuat saat pertama kali Anda membuat project. Secara default, file ini disimpan dalam direktori yang sama dengan file Perangkat Virtual Android (AVD) Anda:- OS X dan Linux:
~/.android/
- Windows Vista dan Windows 7:
C:\Users\your_user_name\.android\
- OS X dan Linux:
Tampilkan daftar sidik jari SHA-1:
Untuk Linux atau OS X, buka jendela terminal dan masukkan hal berikut:
keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android
Untuk Windows Vista dan Windows 7, jalankan perintah berikut:
keytool -list -v -keystore "%USERPROFILE%\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android
Anda akan melihat output yang mirip dengan berikut ini:
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
Menampilkan sidik jari sertifikat rilis
Gunakan program keytool
dengan parameter -v
untuk menampilkan
sidik jari SHA-1 sertifikat. Caranya, selesaikan langkah-langkah berikut:
- Temukan file keystore sertifikat rilis Anda. Tidak ada lokasi atau nama default untuk keystore rilis. Jika Anda tidak menentukannya saat
mem-build aplikasi untuk dirilis, build akan
membiarkan
.apk
tidak ditandatangani dan Anda harus menandatanganinya sebelum dapat memublikasikannya. Untuk sertifikat rilis, Anda juga memerlukan alias sertifikat, sandi untuk keystore, dan sertifikatnya. Masukkan kode berikut untuk mencantumkan alias untuk semua kunci dalam keystore:
keytool -list -keystore your_keystore_name
- Ganti
your_keystore_name
dengan jalur dan nama keystore yang sepenuhnya memenuhi syarat. Menyertakan ekstensi.keystore
. Masukkan sandi keystore saat diminta. Kemudian,keytool
akan menampilkan semua alias di keystore. Masukkan hal berikut pada terminal atau command prompt:
keytool -list -v -keystore your_keystore_name -alias your_alias_name
- Ganti
your_keystore_name
dengan jalur dan nama keystore yang sepenuhnya memenuhi syarat. Menyertakan ekstensi.keystore
. - Ganti
your_alias_name
dengan alias yang Anda tetapkan ke sertifikat saat membuatnya.
Anda akan melihat output yang mirip dengan berikut ini:
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
Baris yang diawali dengan SHA1
berisi sidik jari SHA-1 sertifikat. Sidik jari adalah rangkaian 20 angka heksadesimal dua digit yang dipisahkan dengan titik dua.
Mendapatkan kunci API dari Google Developers Console
Untuk memulai Google Awareness API, klik tombol Dapatkan kunci. Link ini menautkan ke Google Developers Console, yang memandu Anda melalui proses dan mengaktifkan Awareness API secara otomatis.
Alternatifnya, ikuti langkah-langkah ini untuk mendapatkan kunci API:
- Buka Google Developers Console.
- Pilih project, atau buat project baru.
- Klik Lanjutkan untuk mengaktifkan Awareness API.
Di halaman "Credentials", buat kunci Android dan setel kredensial API.
Dalam dialog 'Buat kunci', Anda perlu membatasi penggunaan ke aplikasi Android. Untuk melakukannya, masukkan sidik jari SHA-1 dan nama paket aplikasi Anda, seperti dalam contoh berikut:
BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75 com.example.android.awareness-example
Klik Create. Kunci Android API baru akan muncul dalam daftar kunci API untuk project Anda. Kunci API adalah string karakter, seperti berikut:
AIzaSyBdVl-cTICSwYKrZ95LoVuw7dbMuDt1KG0
Setelah memiliki kunci API, Anda dapat menambahkannya ke manifes aplikasi, seperti yang dijelaskan dalam panduan Memulai.
Mengaktifkan API Tambahan
Awareness API memungkinkan Anda mengakses beberapa jenis data kontekstual, seperti beacon. Untuk menggunakan jenis ini, Anda harus mengaktifkan API yang sesuai di Google Developers Console.
Layanan | Metode Awareness API | API untuk mengaktifkan |
---|---|---|
Beacon | SnapshotApi.getBeaconState() ,
FenceApi.BeaconFence |
Nearby Messages API |