本文說明開始使用 Navigation Connect 的必要步驟。
|
確認符合先決條件。 |
在 Google Cloud 專案中啟用 API。 |
設定 OAuth，發出經過驗證的 API 要求。 |
啟用 API 並驗證應用程式
本指南說明如何在 Google Cloud 控制台中啟用 Navigation Connect API 並驗證應用程式，讓應用程式安全地與 Google 地圖和 Waze 介接。您必須完成這項程序，才能使用 Navigation Connect API。
1. 啟用 Navigation Connect API
使用 Google Cloud 控制台或 gcloud 指令，在 Google Cloud 雲端專案中啟用 Navigation Connect API。
如要啟用 API，請按照下列步驟操作：
控制台
在 Google Cloud 控制台中開啟產品頁面：
啟用 Navigation Connect API點選「啟用」按鈕。
gcloud
gcloud services enable \ --project "PROJECT" \ "navigationconnect.googleapis.com"
進一步瞭解 Google Cloud SDK、Cloud SDK 安裝和下列指令：
2. 開始應用程式驗證程序
啟用 API 後，您必須驗證應用程式，才能啟用 Navigation Connect API。 啟用 API 本身不會授予存取權，您必須先提供商家和應用程式詳細資料以供審查，才能使用 Navigation Connect API。
如要啟動驗證程序，請使用下列任一方法：
-
API Marketplace：
- 在 API Marketplace 中，找出「Navigation Connect API」資訊卡。
- 按一下藍色的「需要驗證」圖示，即可開始驗證程序。
- Google Cloud 控制台中的金鑰和憑證：
3. 提供應用程式、資料收集和隱私權詳細資料
下表說明應用程式驗證時必須提供的詳細資料：
| 欄位 | 說明 |
|---|---|
| 應用程式詳細資料 請提供下列詳細資料，確保應用程式在 Google 地圖和 Waze 中正確顯示。 |
|
| 商家或應用程式名稱 | 輸入要在 Google 地圖和 Waze 中向使用者顯示的名稱。 |
| 應用程式 ID | 提供 Android 套件名稱或 iOS 軟體包 ID。 |
| iOS 通用連結 | 提供 iOS 通用連結，讓使用者返回應用程式 (僅適用於 Waze)。 |
| 應用程式標誌 (僅限 Waze) | (選用) 上傳 PNG 或 JPG 格式的標誌 (32x32 至 128x128 像素)，在導航期間於 Waze 中顯示應用程式標誌。 |
| 資料收集和隱私權詳細資料 輸入下列詳細資料，確保透明度、駕駛人信任度和資料安全性。 |
|
| 隱私權政策連結 | 提供應用程式隱私權政策的網址。這個連結會顯示在同意畫面上。 |
| 額外的資料控管者 (選填) | 提供第三方資料管理員 (例如 ISV) 的商業名稱和隱私權政策連結。這些詳細資料會顯示在同意畫面中。 |
| 資料法規遵循情形 | 如果您的應用程式在美國境內運作，請選取「這個應用程式會用於美國境內的行程」核取方塊，確保符合當地法規。 |
4. 檢閱並提交
提交應用程式以供驗證前，請先檢查您提供的資訊摘要。
-
請仔細檢查應用程式名稱、平台、ID 和連結。
- 勾選「資訊均正確無誤」核取方塊。
- 按一下「提交」。
將應用程式送交驗證後，就會進入審查階段。
- 時間表：驗證程序通常會在 1 到 3 個工作天內完成。
- 通知：驗證狀態變更時，你會收到電子郵件。您也會收到電子郵件，要求提供付款資料 ID 或 Android 開發人員 ID。如需 Android 開發人員 ID，請參閱「建立開發人員帳戶」。
- 狀態追蹤：在 Google Cloud 控制台的「金鑰和憑證」頁面中，監控進度。
- 支援：如要在核准後更新設定，但不想影響生產作業，請建立支援單。
驗證完成後，應用程式即可使用 Navigation Connect API 產生行程權杖，授權存取導航工作階段，並接收 Google 地圖和 Waze 的行程詳細資料。