Pendaftaran dan kunci API

Untuk menggunakan Google Awareness API, Anda harus menambahkan kunci API Google ke aplikasi. Jenis kunci API yang Anda perlukan adalah kunci API Android.

Semua aplikasi Android ditandatangani dengan sertifikat digital yang kunci pribadinya Anda miliki. Untuk informasi selengkapnya tentang sertifikat digital, lihat panduan Android tentang cara menandatangani aplikasi.

Kunci API Android ditautkan ke pasangan paket sertifikat tertentu. Anda hanya memerlukan satu kunci untuk setiap sertifikat, berapa pun jumlah pengguna yang Anda miliki untuk aplikasi.

Ada beberapa langkah yang diperlukan untuk mendapatkan kunci aplikasi. Langkah-langkah tersebut dijelaskan secara mendetail dalam panduan ini, dan diringkas sebagai berikut:

1. Dapatkan informasi tentang sertifikat aplikasi Anda.
2. Daftarkan project di konsol Google Developers dan tambahkan User Context API sebagai layanan untuk project.
3. Mintalah kunci.
4. 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. Untuk menampilkan sidik jari SHA-1 untuk sertifikat Anda, pastikan terlebih dahulu bahwa 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 Anda ke publik.

Untuk informasi selengkapnya tentang keytool, lihat dokumentasi Oracle.

Sertifikat debug

Menampilkan sidik jari sertifikat debug

Gunakan program keytool dengan parameter -v untuk menampilkan sidik jari SHA-1 sertifikat. Caranya, selesaikan langkah-langkah berikut:

1. Temukan file keystore debug Anda. Nama file-nya adalah debug.keystore, dan dibuat saat pertama kali Anda membuat project. Secara default, file ini disimpan dalam direktori yang sama seperti file Android Virtual Device (AVD) Anda:

   • OS X dan Linux: ~/.android/
   • Windows Vista dan Windows 7: C:\Users\your_user_name\.android\

2. Tampilkan daftar sidik jari SHA-1:

   • Untuk Linux atau OS X, buka jendela terminal dan masukkan 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

Sertifikat rilis

Menampilkan sidik jari sertifikat rilis

Gunakan program keytool dengan parameter -v untuk menampilkan sidik jari SHA-1 sertifikat. Caranya, selesaikan langkah-langkah berikut:

1. Temukan file keystore sertifikat rilis Anda. Tidak ada lokasi atau nama default untuk keystore rilis. Jika Anda tidak menetapkannya saat membuat aplikasi untuk rilis, build akan membiarkan .apk tidak ditandatangani dan Anda harus menandatanganinya sebelum dapat memublikasikannya. Untuk sertifikat rilis, Anda juga memerlukan sandi dan alias sertifikat untuk keystore dan sertifikatnya.

2. Masukkan kode berikut untuk mencantumkan alias untuk semua kunci dalam keystore:

   keytool -list -keystore your_keystore_name
         

3. Ganti your_keystore_name dengan jalur dan nama keystore yang sepenuhnya memenuhi syarat. Sertakan ekstensi .keystore. Masukkan sandi keystore saat diminta. Kemudian, keytool menampilkan semua alias dalam keystore.

4. Masukkan hal berikut pada terminal atau command prompt:

         keytool -list -v -keystore your_keystore_name -alias your_alias_name
         

5. Ganti your_keystore_name dengan jalur dan nama keystore yang sepenuhnya memenuhi syarat. Sertakan ekstensi .keystore.
6. Ganti your_alias_name dengan alias yang ditetapkan ke sertifikat saat Anda 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.

Perhatian: Untuk melindungi keystore dan kunci Anda, jangan memasukkan argumen storepass atau keypass pada command line kecuali jika Anda yakin dengan keamanan komputer Anda. Misalnya, pada komputer yang digunakan bersama, seseorang dapat melihat histori jendela terminal Anda atau daftar proses yang sedang berjalan, mendapatkan sandinya, lalu memiliki akses tulis ke sertifikat penandatanganan Anda. Hal ini akan memungkinkan orang tersebut memodifikasi atau mengganti aplikasi Anda dengan aplikasi mereka.

Mendapatkan kunci API dari Google Developers Console

Untuk mulai menggunakan Google Awareness API, klik tombol Dapatkan kunci. Halaman ini ditautkan ke Konsol Google Developers, yang memandu Anda menjalankan prosesnya dan mengaktifkan Awareness API secara otomatis.

Mendapatkan kunci

Alternatifnya, ikuti langkah-langkah ini untuk mendapatkan kunci API:

1. Buka Google Developers Console.
2. Pilih project, atau buat project baru.
3. Klik Continue untuk mengaktifkan Awareness API.

4. Di halaman "Credentials", buat kunci Android dan tetapkan kredensial API.

   Catatan: Jika sudah memiliki kunci Android, Anda dapat menggunakannya.

5. Pada dialog 'Create key", 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
   

6. Klik Create. Kunci API Android baru Anda 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 Additional APIs

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 yang akan diaktifkan
Beacon	SnapshotApi.getBeaconState(), FenceApi.BeaconFence	Nearby Messages API