在正式環境中導入新的 Google 地圖專案前，請務必確認設定正確無誤，確保您為使用的產品支付正確金額。本文將說明如何確保 (i) 帳單資訊公開透明，以便在產生月結單前驗證用量，以及 (ii) 專案設定正確無誤，確保您能使用我們的產品。
這項程序應該相當簡單，但地圖合作夥伴可以協助您確保專案正確遷移。
概念
在本節中，我們希望確保你瞭解 Google 地圖帳單的基本資訊，以及可能出現的不同設定。在許多情況下，沒有所謂的正確或錯誤，一切取決於您想達成的結果類型。
在這份文件中，我們將多次提及 Google Cloud 專案。這是因為 Google 地圖產品可透過該平台使用。也就是說，本文涵蓋的設定是在 Google Cloud 專案中進行。
帳單帳戶
目前使用 Google 地圖產品的每間公司，都有與其相關聯的 Google Cloud 專案。這項專案必須已設定帳單帳戶。帳單帳戶會負責累計所有 Google 地圖用量，並根據該用量每月開立月結單。
對於「Mobility」，系統會提供專屬的帳單帳戶。這個帳單帳戶僅適用於與行動裝置相關的用途，例如：共乘、外送和物流。
一個帳單帳戶可供多個或單一 Google Cloud 專案使用。
單一專案指向同一個帳單帳戶：
- 特定用途 (例如行動裝置用途)
- 獨立月結單
- 折扣是根據這個單一專案的數量計算
多個專案指向同一個帳單帳戶：
- 相同用途
- 匯總用量，享有折扣等級優惠
- 單一月結單
如要進一步瞭解帳單帳戶和其他相關資訊，請參閱這篇文章。
如上所述，單一帳單帳戶可指向多個專案。如果您有多個專案，請找出要使用行動服務的專案，並將這些專案指向行動帳單帳戶。如果專案沒有相關聯的行動裝置用途，請繼續指向您目前使用的 Google 地圖平台一般帳單帳戶。如要取得行動裝置帳單帳戶，必須與 Google 或合作夥伴簽署行動裝置交易。下圖顯示帳單帳戶在整個結構中的位置，以及各種可能的設定：
雲端資源、帳單帳戶和月結單產生
談到定價，在 Google 地圖平台上，有不同等級的折扣，可透過地圖合作夥伴取得，在某些情況下也可直接向 Google 取得。這些層級是以用量為準，因此使用產品越多，支付的費用就越少 (折扣會套用至每個 SKU)。我們的帳單系統會根據您用來呼叫產品的憑證(部分行動裝置 API 的 API 金鑰或服務帳戶)，識別您的專案：
API 金鑰
Google 地圖平台 API 會使用 API 金鑰進行驗證。Google 會根據這個 API 金鑰，找出對應的 Google Cloud 專案帳單帳戶，並在該帳戶中產生用量。
傳送至 Geocoding API 的要求範例：
https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJeRpOeF67j4AR9ydy_PIzPuM&key=YOUR_API_KEY
JWT
部分 API 需要在網址中提供 Google Cloud 專案 ID，並使用 JWT 進行驗證。因此，請務必確保正確的系統使用正確的驗證方法，以確保帳單作業正常進行。
向 Fleet Engine API 發出的要求範例：
curl -X GET \ https://fleetengine.googleapis.com/v1/providers/project_id/deliveryVehicles/vehicle-1234 \
-H 'authorization: Bearer eyJ0eXAiOi...' \
-H 'cache-control: no-cache' \
-H 'content-type: application/json' \
-d '{
"lastLocation": {
"location": {
"latitude": 37.432,
"longitude": -122.094
},
"updateTime": "2022-11-13T17:55:00Z"
}
}'
費用
在 Google 地圖平台，費用是根據 API 要求量計算。對於行動服務，我們是根據可計費的行動交易量收費，也就是成功完成的行程或工作 (出貨，而非取貨)。這項資訊會在簽署合約前定義。如果您是叫車或外送公司，完成行程或外送就是您的成功指標，這會對應到「行程」。 工作適用於必須成功遞送包裹的物流公司和零售商。
我們瞭解行動服務客戶也會在行程和送貨過程中，使用 Google 地圖平台產品。因此，只要在同一個行動裝置用途中遵守預先定義的限制，使用行動裝置帳單帳戶時，即可免付費呼叫 Google 地圖平台。
舉例來說，如果您是外送公司，每完成一趟行程，就可以呼叫 Geocoding API 十次。如要進一步瞭解這些限制，請參閱行動性說明文件中的用量限制。如要變更上限，必須先修正合約，因此請與 Google 或合作夥伴代表討論您的具體需求。
系統會在月底根據 (i) 系統回報的成功行程或工作數量，以及 (ii) 超出預先設定限制的 Google 地圖平台 API 呼叫量 (即「超額用量」) 產生月結單。我們的限制與市場上普遍的需求一致。
建議您詳閱官方行動裝置帳單文件，請參閱這裡。
試用和評估
客戶可以在簽署合約前，在 Google 地圖平台帳單帳戶上進行小規模的行動服務試驗 (概念驗證、評估)，但時間有限。如要進行試驗，請與地圖合作夥伴或 Google 對口人員聯絡。
如前所述，在前測階段，由於尚未簽署合約，因此無法使用行動裝置帳單帳戶。也就是說，只要使用Google 地圖平台產品，就會產生費用，但行動相關產品除外。換句話說，在試用階段，系統不會根據工作或行程計費，因此使用限制也不適用於這個階段。
前測正式在正式環境中推出後，必須按照合約付款。
摘要：
試用 / 開發階段：您只需支付公開推出的 Google 地圖 API 費用。如果專案未使用行動裝置帳單帳戶，則非公開的 API 和 SDK 不會產生費用。請注意，Google 會為每個新建立的帳單帳戶，提供各項 Google 地圖平台 SKU 的免費用量。在評估期間，這應該足以應付受控環境。
製作階段：系統會按趟次或工作收費。只有在用量超出合約的用量限制 (「上限」) 時，才會產生 Google 地圖平台相關費用。如果是這種情況，您就必須支付超出額度的費用。如果超量，系統會依這裡的定義計費。
如何遷移至行動裝置帳單帳戶
遷移至正式環境時，您通常必須建立額外的 Google Cloud 專案，代表不同的環境，例如 QA (品質保證) 和正式環境。在此之前，您可能只有一個環境，也就是開發環境。
相關規定
您身邊的人，且具備以下條件：
- 管理 Google Cloud 上的帳單帳戶，通常由帳單帳戶管理員或專案擁有者負責。
- 存取歡迎信中的新帳單帳戶 ID (合約簽署後產生)。
- 存取與生產環境對應的 Google Cloud 專案，系統會在此環境中回報行程或工作。
請按照下列步驟設定新專案，並為專案設定帳單。
新專案設定
建立專案
- [您] 在 Google Cloud 控制台中為每個新環境建立新的 Google Cloud 專案。例如生產、測試和品質保證。
- [合作夥伴或 Google 團隊] 將新專案加入許可清單，即可存取行動裝置產品。與 Google 或合作夥伴的業務代表合作，並提供上一個步驟中建立的專案 ID。
- [你] 更新專案的「重要聯絡人」。請務必完成這個步驟，確保 Google 支援團隊能在必要時聯絡到專案的負責人。
專案設定
在 Google Cloud 控制台中，為先前步驟建立的專案完成下列步驟：
[您] 建立服務帳戶，包括關聯正確的 Mobility 身分與存取權管理 (IAM) 角色 (以行程為準和以工作為準)
- 如在開發環境中完成，或視需要以更嚴謹的方式區隔存取權 (請參閱本節)。
[您] 建立 API 金鑰，就像在開發環境中一樣，或視需要更嚴格地區隔存取權 (例如依產品、網域等)。
[您] 啟用「Local Rides and Deliveries」等 API，以及其他需要的 Google 地圖平台 API (例如 Geocoding、Autocomplete、Address Validation)。
[您] 配額：如要提高特定 API 的每分鐘查詢次數 (QPM)，請提交支援單。如要瞭解如何操作，請參閱這篇文章。您必須提供正當的業務理由，說明為何需要提高上限。如要查看預先定義的配額，請按這裡。
[您] 如果您開發的系統使用開發環境的憑證，請確保這些系統可以指向為新建立專案建立的新憑證。包括將後端和前端系統指向新的憑證 (例如 API 金鑰、服務帳戶)，並確保在各個環境中使用正確的專案 ID。
帳單設定
在此，我們假設您已直接 (如適用) 或透過合作夥伴與 Google 簽署合約。這是接收歡迎信中行動帳單帳戶的前提條件，該帳戶將用於後續步驟。
- [您] 確認是否已收到行動裝置帳單帳戶 ID，這組 ID 會在合約簽署並執行後，透過電子郵件傳送的歡迎信中提供。重要事項：歡迎信會寄給合約訂單表單中指定的技術和財務聯絡人。請與專案團隊合作，瞭解可能收到這封郵件的對象，並請對方提供帳單帳戶 ID (以連字號分隔的一連串字元和數字)。
- [你] 與 Google 或合作夥伴合作，確保已完成帳單驗證，也就是說，你的系統已正確向 Google 回報行程或工作。詳情請參閱下一節。
- [您] 使用 Cloud 控制台將 Google Cloud 專案指向新的帳單帳戶 - 請參閱本文稍後的「帳單帳戶設定」一節。
帳單驗證
帳單驗證非常重要，可確保系統正確向你收費。 有時公司會不小心錯誤導入 API，導致費用增加或少報。
帳單驗證包含下列步驟：
確認對 Google 地圖平台 API 的要求是否在要求標頭中包含 tripId (或 taskId) - 詳情請參閱這裡。
確認行程 (或工作) 是否正常回報。這取決於所用的行動套件：
- Mobility Starter 和 Optimize 或 Accelerate (以行程為準)： 必須整合 ReportBillableEvent API。也就是說，每當行程順利完成，就必須向這個 API 發出要求。如要驗證是否正常發生這種情況，請按照這裡所述步驟操作。
- Mobility Accelerate (以工作為準)：不一定要透過 API 呼叫觸發計費。當遞送工作的任務結果設為「成功」時，系統就會自動執行這項操作。因此，請務必將工作結果正確設為「FAILED」或「SUCCEEDED」。客戶工程師 (合作夥伴或 Google) 會與您合作，確認導入作業是否正確完成。您可以透過 Cloud Logging 執行下列 Cloud Logging 查詢，確認工作是否已正確更新：
resource.type="fleetengine.googleapis.com/DeliveryFleet" jsonPayload.@type="type.googleapis.com/maps.fleetengine.delivery.log.v1.UpdateTaskLog" jsonPayload.request.task.taskOutcome="TASK_OUTCOME_LOG_SUCCEEDED" jsonPayload.response.type="TASK_TYPE_LOG_DELIVERY"如果顯示項目，表示後端系統已正確將工作設為「SUCCEEDED」。
注意：請務必檢查實際完成的行程或工作次數，是否與回報的通話次數相符。有時系統會回報帳單事件，但這些事件與實際完成的行程或工作總數不符 (回報不足)。
整合健康狀態
成功遷移至正式環境不僅要確保計費功能正常運作，也要確保 API 執行作業不會失敗。就行動服務而言，請務必確認 Fleet Engine (Local Rides and Deliveries API) 整合功能是否已正確實作。
如要這麼做，請開啟 Cloud Logging 並使用下列查詢：
jsonPayload.errorResponse.code:*
這應該會列出所有有問題的記錄項目。例如：
這些問題可以匯出至其他 Cloud 產品，例如 BigQuery。您可以根據 Cloud Logging 查詢設定指標和快訊：
由於這些是 Google Cloud 產品，因此可能會產生額外費用。如需更多資訊，請洽詢合作夥伴或 Google 代表。
設定帳單帳戶
如果所有系統現在都能正確回報行程或工作，且沒有整合錯誤，請將專案指向您在歡迎信中收到的帳單帳戶，這部分已在本文件的先前章節中說明。
注意：如果你與地圖合作夥伴合作，他們可以協助你完成這個步驟，你不必單獨按照下列步驟操作。如果您直接與 Google 合作 (某些地區會發生這種情況)，請按照下列步驟操作：
請按照下列步驟操作：
- 開啟 Google Cloud 控制台 (https://console.cloud.google.com)。
- 選取要在正式環境中使用的專案。
- 前往該專案的「帳單」部分。您也可以點選這個連結前往：https://console.cloud.google.com/billing
- 「帳單」> 點按「管理帳單帳戶」：
- 前往「帳單」頁面，然後按一下已建立的製作專案旁邊的 3 點圖示
，並選擇「變更帳單帳戶」：
- 依序點選「帳單」>「帳單帳戶」，然後在下拉式清單中選擇歡迎信中收到的帳單帳戶代碼。然後按一下「設定帳戶」：
- 專案將連結至新的帳單帳戶：
- 新增帳單付款方式後，請前往「總覽」>「付款總覽」和「付款設定」，確認資訊是否正確。如要進一步瞭解如何更新帳單和付款資訊，請參閱這篇連結。如有任何帳單相關問題，請提交帳單 支援案件，或與合作夥伴或 Google 代表聯絡。
帳單報表
帳單報表可協助您瞭解與連結至專案的帳單帳戶相關聯的費用。
注意：如果你與地圖合作夥伴合作，請與對方合作，確保你取得所需的相關帳單資訊。
開啟專案連結的帳單帳戶，然後選取「報表」。接著，您可以使用下列篩選器：
這裡要記住的主要設定是「依 SKU 分組」篩選器，這個篩選器會顯示行程和工作，以及其他 API 的詳細資訊 (如有使用)，包括是否超出用量限制，如先前所述：
報表資訊每天都會更新。如果需要當日資訊，可以使用 Cloud Logging 查詢，查看當日發生多少可計費事件。詳情請參閱前幾節。
適應期計畫
值得一提的是，您的加速計畫。視業務性質而定，並非所有流量都會遷移至行動裝置專案。舉例來說，有些公司需要時間才能將新解決方案推廣至所有分公司、加盟店、商店、辦公室等，這表示部分流量會使用舊系統，部分流量則會導向新專案。
此外，在許多情況下，並非所有流量都屬於行動用途，例如商店定位器、路邊取貨和其他內部解決方案。這些應指向 Google 地圖平台帳單帳戶，因為該處的流量應與 Mobility 帳單帳戶分開。
請務必遵守導入政策：
- 以行程為基礎的模型 - 「隨選乘車與運送服務解決方案適用於隨選商用乘車與運送服務。這類服務通常包括：(a) 提交前往特定目的地 (或運送特定物品) 乘車要求的消費者，以及 (b) 與要求配對的駕駛人，駕駛車輛完成服務。」
- 以工作為基礎的模型 - 「Google 地圖平台 Last Mile Fleet Solution 適用於商業最後一哩路配送和第一哩路取貨服務。這類服務通常包括：(a) 顧客擁有或簽約的車隊；(b) 根據預先規劃路線進行配送；(c) 配送中心網路，以及支援配送作業的營運團隊；(d) 追蹤並接收貨件的消費者。
因此，您應瞭解哪些系統應指向 Google 地圖平台帳單帳戶，哪些系統應指向行動裝置帳單帳戶。通常會有許多專案，且每個專案都指向正確的帳單帳戶。
舉例來說，假設根據用量限制，每趟行程 / 工作今天包含 10 項地址定位要求。如果遷移作業需要幾個月的時間，且您在第一個月開始回報 10 萬趟行程 / 工作，這表示您可能會呼叫 Geocoding API 100 萬次。但如果貴商家有 500 萬次地理編碼要求，則這 400 萬次差異可能會回報為超出用量。以下提供兩種選項：
- 您向我們回報的行程 / 工作數量增加 (加快啟動計畫)，因此適用較高的上限，在這種情況下，您每月需要回報 50 萬個行程 / 工作。
- 如先前所述，您可以在合約協商期間協商提高限制。
- 將 Geocoding API 要求導向 Google 地圖平台 API，即可享有較高的折扣等級，且費用比超額用量便宜。
我們瞭解根據貴商家規模、複雜度和用途估算成本可能很複雜，因此請與合作夥伴或 Google 對應人員合作，決定使用現有專案準備推出正式版產品的最佳方式。
總而言之，如要制定適當的加速計畫，請按照下列步驟操作：1. 根據實施政策，判斷哪些應用實例與行動裝置相關，哪些則否。2. 找出目前用於相關用途的 Google 地圖平台 API，以及這些 API 的用量。3. 判斷實作行動解決方案後是否仍需使用 Google 地圖平台 API，例如 Fleet Engine 會自動計算預計抵達時間，您可能就不再需要使用 Directions API 計算。4. 找出完全遷移行動裝置用途至新行動裝置平台所需的時間。5. 請仔細檢查使用限制是否足以支援您的用途。6. 找出所有 Google 地圖平台要求可併入行動帳單帳戶的轉折點，以用於行動使用案例。
結論
總而言之，正確設定帳單帳戶是價格可預測性與透明度的重要關鍵。我們的行動技術整合了頂尖的位置資訊服務，因此企業可放心使用，確保帳單程序準確有效率。這不僅有助於降低成本，還能提供做出明智業務決策所需的資料和洞察資訊。此外，這類系統提供的透明度可讓公司清楚瞭解支出，進而妥善管理預算。
後續動作
- 在 Google Cloud 控制台中設定帳單帳戶。
- 如要進一步瞭解一般計費方式，請參閱