申請和 API 金鑰

如要使用 Google Awareness API，您必須在應用程式中新增 Google API 金鑰。您需要的 API 金鑰類型為 Android API 金鑰。

所有 Android 應用程式都會使用數位憑證簽署，該金鑰會保存私密金鑰。如要進一步瞭解數位憑證，請參閱 Android 指南，瞭解如何簽署應用程式。

Android API 金鑰會連結至特定憑證套件組合。無論應用程式有多少使用者，每個憑證都只需要一組金鑰。

您必須完成幾個步驟，才能為應用程式取得金鑰。本指南將詳細說明請見下文：

  1. 取得應用程式憑證的相關資訊。
  2. 在 Google Developers Console 中註冊專案，並將 User Context API 新增為該專案的服務。
  3. 要求金鑰。
  4. 將金鑰加入應用程式。方法如下：在應用程式資訊清單中新增元素。

找出應用程式的憑證資訊

API 金鑰是以應用程式數位憑證的簡短形式表示，也就是所謂的 SHA-1 指紋。如要顯示憑證的 SHA-1 指紋，請先確認您使用的是正確的憑證。您可以選擇以下兩個憑證：

  • 偵錯憑證：執行偵錯版本時，Android SDK 工具會自動產生這個憑證。這個憑證只能用於您正在測試的應用程式。 請勿嘗試發布以偵錯憑證簽署的應用程式。如要進一步瞭解偵錯憑證，請參閱 Android 開發人員說明文件的簽署偵錯版本一節。
  • 發布憑證：Android SDK 工具會在您執行發布子版本時產生這個憑證。您也可以使用 keytool 程式產生這個憑證。準備要向全世界發布應用程式時，請使用這個憑證。

如要進一步瞭解 keytool，請參閱其 Oracle 說明文件。

偵錯憑證

顯示偵錯憑證指紋

使用 keytool 程式搭配 -v 參數，顯示憑證的 SHA-1 指紋。若要這樣做，請完成下列步驟：

  1. 找出您的偵錯 KeyStore 檔案。檔案名稱為 debug.keystore，系統會在您首次建構專案時建立這個檔案。根據預設，這個檔案會儲存在與 Android 虛擬裝置 (AVD) 檔案相同的目錄中：

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

  2. 列出 SHA-1 指紋：

    • For Linux or OS X, open a terminal window and enter the following:

      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
發布憑證

顯示版本憑證指紋

使用 keytool 程式搭配 -v 參數，顯示憑證的 SHA-1 指紋。若要這樣做，請完成下列步驟：

  1. 找出您的發布憑證 KeyStore 檔案。這個版本的 KeyStore 沒有預設位置或名稱。如果您在建構要發布的應用程式時未指定版本，建構作業會將 .apk 保持未簽署狀態，而您必須先簽署該版本才能發布。針對發布憑證，您也必須取得憑證的別名、KeyStore 密碼和憑證。

  2. 輸入下列指令，列出 KeyStore 中所有金鑰的別名：

    keytool -list -keystore your_keystore_name
  3. 將 your_keystore_name 替換為 KeyStore 的完整路徑和名稱。加入 .keystore 副檔名。在系統提示時輸入 KeyStore 密碼。接著，keytool 會顯示 KeyStore 中的所有別名。

  4. 輸入以下終端機或命令提示字元：

          keytool -list -v -keystore your_keystore_name -alias your_alias_name
  5. 將 your_keystore_name 替換為 KeyStore 的完整路徑和名稱。加入 .keystore 副檔名。
  6. 將 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 個雙位十六進位制數碼，以冒號分隔。

從 Google Developers Console 取得 API 金鑰

如要開始使用 Google Awareness API，請點選「Get key」(取得金鑰) 按鈕。並會連結至 Google Developers Console，引導您完成相關程序並自動啟用 Awareness API。

取得金鑰

或者，按照下列步驟取得 API 金鑰：

  1. 前往 Google Developers Console。
  2. 請選取現有專案，或是建立新專案。
  3. 按一下「繼續」即可啟用 Awareness API。

  4. 在「憑證」頁面上建立 Android 金鑰，並設定 API 憑證。

  5. 在「建立金鑰」對話方塊中，您必須將用量限制在 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.awareness-example

  6. 按一下「Create」(建立)。新的 Android API 金鑰會顯示在專案的 API 金鑰清單中。API 金鑰是字元字串，如下所示：

    AIzaSyBdVl-cTICSwYKrZ95LoVuw7dbMuDt1KG0

取得 API 金鑰後，您可以將金鑰加進應用程式的資訊清單中，詳情請見「開始使用」指南。

啟用其他 API

Awareness API 可讓您存取多種內容比對資料，例如信標。如要使用這些類型，您必須在 Google Developers Console 中啟用相應的 API。

服務 Awareness API 方法 啟用 API
信標 SnapshotApi.getBeaconState()、FenceApi.BeaconFence Nearby Messages API