本文說明開始使用 Navigation Connect 的必要步驟。
必要條件
本指南說明如何設定 Google Cloud 帳戶和已啟用計費功能的 Google Cloud 專案。此外,您也應熟悉 Navigation Connect API 的計費方式。
- 查看用量帳單和費用:Navigation Connect 用量和帳單。
-
確認您有 Google Cloud 帳戶。
登入 Google Cloud 控制台 -
確認您有已啟用計費功能的 Google Cloud 專案。
前往「帳單」頁面- 選取專案,開啟「Billing」(帳單) 頁面。
-
在「帳單」頁面中:
- 如果所選專案已啟用計費功能,且您只有一個帳單帳戶,系統會開啟「Billing」(帳單) 頁面。
- 如果您有多個帳單帳戶,請選取「Go to linked billing account」(前往連結的帳單帳戶),查看與專案相關聯的帳單帳戶詳細資料。
- 如果已有帳單帳戶,但未與專案建立關聯,系統會提示您將帳單帳戶連結至專案。
- 如果沒有帳單帳戶,或想建立新的帳單帳戶,請選取「管理帳單帳戶」來建立新的帳單帳戶。詳情請參閱「建立新的自助式 Cloud Billing 帳戶」。
啟用 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 控制台中的「Keys & Credentials」(金鑰和憑證):
- 在 Google Cloud 控制台中,前往 「Keys & Credentials」(金鑰和憑證) 頁面。
- 按一下「Navigation Connect 金鑰和憑證」。
- 按一下橫幅中的「開始驗證」。
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 的行程詳細資料。
Google Maps Platform 產品要求 API 呼叫必須包含 OAuth 權杖,以防未經授權的使用。
建立 OAuth 權杖
Navigation Connect 支援 OAuth 2.0 驗證。Google 支援常見的 OAuth 2.0 情境,例如網路伺服器情境。
本文說明如何在開發環境中,將 OAuth 權杖傳遞至 Navigation Connect 呼叫。如要進一步瞭解如何在正式環境中使用 OAuth,請參閱「Google 的驗證方式」。
您可以直接向伺服器發出 API 要求,呼叫 Google Maps API,也可以使用用戶端程式庫簡化程式碼。Google 地圖提供 Go、Java、Node.js 和 Python 適用的用戶端程式庫。詳情請參閱「Navigation Connect 用戶端程式庫」。
OAuth 總覽
您可以根據部署環境,透過多種方式使用 OAuth 建立及管理存取權杖。
您可以使用 OAuth 2.0,在應用程式和 Google 服務之間進行伺服器對伺服器互動。在這種情況下,您會使用與應用程式 (而非個別使用者) 相關聯的服務帳戶。您可以使用服務帳戶提出 API 要求,不必直接涉及使用者。如要進一步瞭解驗證方式,請參閱「Google 的驗證方式」。
或者,您也可以將 Navigation Connect 整合至 Android 或 iOS 行動應用程式。如要進一步瞭解如何使用 OAuth,以及管理不同部署環境的存取權杖,請參閱「使用 OAuth 2.0 存取 Google API」。
OAuth 範圍
如要搭配 Navigation Connect 使用 OAuth,您必須為 OAuth 權杖指派下列範圍:
https://www.googleapis.com/auth/cloud-platform
範例:在本機開發環境中試用 REST API 呼叫
如果您沒有會產生權杖的環境,但想嘗試使用 OAuth 權杖進行 Navigation Connect,請按照本節中的程序操作。
這個範例說明如何使用應用程式預設憑證 (ADC) 提供的 OAuth 權杖發出呼叫。如要進一步瞭解如何使用 ADC 搭配用戶端程式庫呼叫 Google API,請參閱「使用用戶端程式庫進行驗證」。
下列 REST 程序僅適用於開發或測試,不適用於正式環境。
必要條件
使用 ADC 發出 REST 要求前,請先透過 gcloud CLI 將憑證提供給 ADC:
安裝並初始化
gcloudCLI。詳情請參閱「安裝 gcloud CLI」。使用
gcloudCLI 進行驗證:gcloud auth application-default login
完成登入程序,將憑證儲存在 ADC 使用的本機憑證檔案中。
詳情請參閱「為本機開發環境設定 ADC」。
提出 REST 要求
在這個範例中,您會傳遞兩個要求標頭:
使用下列指令產生權杖,在
Authorization標頭中傳遞 OAuth 權杖:gcloud auth application-default print-access-token傳回的權杖範圍為
https://www.googleapis.com/auth/cloud-platform。在
X-Goog-User-Project標頭中,傳遞已啟用計費功能的 Google Cloud 雲端專案 ID 或名稱。
如要使用 OAuth 權杖呼叫 Navigation Connect,請完成下列步驟:
在下列程式碼範例中,請將預留位置替換為您的值:
- PROJECT_ID:Google Cloud 專案 ID
- ANDROID_APP_ID:應用程式的 Android 套件名稱 (如適用)
- IOS_APP_ID:應用程式的 iOS 軟體包 ID (如適用)
#!/bin/bash trip_id="$(uuidgen)" access_token="$(gcloud auth application-default print-access-token)" curl -X POST "https://navigationconnect.googleapis.com/v1/projects/PROJECT_ID/trips?tripId=${trip_id}" \ -H "Authorization: Bearer ${access_token}" \ -H "Content-Type: application/json" \ -d '{ "androidAppId": "ANDROID_APP_ID", "iosAppId": "IOS_APP_ID", }'
如要複製
curl指令,請按一下程式碼範例中的「Copy」(複製)。將指令貼到終端機視窗中,然後執行。
回應為 JSON 物件:
{ "name": "projects/PROJECT_NUMBER/trips/TRIP_ID", "authToken": { "token": "BASE64_ENCODED_TRIP_TOKEN", "expireTime": "2026-03-06T11:09:47.476942Z" }, "state": "NEW", "execution": { "traveledDistanceMeters": 0, "stopAddedInRoute": false }, "createTime": "2026-03-05T23:09:50.768959Z", "updateTime": "2026-03-05T23:09:50.768959Z", }
這項回應包含下列值:
- PROJECT_NUMBER:專案的專屬長整數 ID
- TRIP_ID::後端產生的 UUIDv4 行程 ID
- BASE64_ENCODED_TRIP_TOKEN:
createTrip方法傳回的已驗證權杖,用於在 Google 地圖或 Waze 中啟動追蹤的即時路況導航
疑難排解
如果要求傳回錯誤訊息,指出這個 API 不支援使用者憑證,請參閱「排解 ADC 設定問題」。
後續步驟
接著,請設定 Navigation Connect API 的服務帳戶,在後端基礎架構、Google 地圖和 Waze 之間,建立安全的伺服器對伺服器通訊。