本頁面由 Cloud Translation API 翻譯而成。

Google 地圖平台和行動管理計費指南

在正式環境中導入新的 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 要求量計算。如果是 Mobility 服務，我們會根據可計費的行動交易量收費，也就是成功完成的行程或工作 (出貨，而非取貨)。這項資訊會在簽署合約前定義。如果你是叫車或外送公司，完成行程或外送就是你的成功指標，這會對應到「行程」。工作適用於必須成功遞送包裹的物流公司和零售商。

我們瞭解行動服務客戶也會在行程和送貨過程中，使用 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，該 ID 會在合約簽署後產生的歡迎信中提供。
存取與生產環境對應的 Google Cloud 專案，系統會在此環境中回報行程或工作。

請按照下列步驟設定新專案，並為專案設定帳單。

新專案設定

建立專案

[您] 在 Google Cloud 控制台中，為每個新環境建立新的 GCP 專案。例如生產、預先發布和品質保證。
[合作夥伴或 Google 團隊] 將新專案加入許可清單，即可存取行動裝置產品。與 Google 或合作夥伴的業務代表合作，並提供上一個步驟中建立的專案 ID。
[你] 更新專案的「重要聯絡人」。請務必完成這個步驟，確保 Google 支援團隊在必要時，能與專案的適當人員聯絡。

專案設定

在 Google Cloud Console 中，為先前步驟建立的專案完成下列步驟：

[您] 建立服務帳戶，包括關聯正確的 Mobility 身分與存取權管理 (IAM) 角色 (以行程為準和以工作為準)
- 如在開發環境中進行，或視需要以更嚴謹的方式區隔存取權 (請參閱本節)。
[您] 建立 API 金鑰，做法與開發環境相同，或視需要更嚴格地控管存取權 (例如依產品、網域等)。
[您] 啟用「Local Rides and Deliveries」等 API，以及其他需要的 Google 地圖平台 API (例如 Geocoding、Autocomplete、Address Validation)。
[您] 配額：如要提高特定 API 的每分鐘查詢次數，請開啟支援單。如要瞭解如何操作，請參閱這篇文章。您必須提供正當的業務理由，說明為何需要提高上限。如要查看預先定義的配額，請按這裡。
[您] 如果您開發的系統使用開發環境的憑證，請確保這些系統可以指向為新建立專案建立的新憑證。包括將後端和前端系統指向新的憑證 (例如 API 金鑰、服務帳戶)，並確保在各個環境中使用正確的專案 ID。

帳單設定

我們假設您已直接 (如適用) 或透過合作夥伴與 Google 簽署合約。這是先決條件，您必須完成這項程序，才能在歡迎信中收到行動裝置帳單帳戶，並在後續步驟中使用。

[您] 確認是否已收到歡迎信，這封信是 Google 在合約簽署並執行後，透過電子郵件傳送給您的，信中會提供行動裝置帳單帳戶 ID。重要事項：歡迎信會寄給合約訂單表單中指定的技術和財務聯絡人。請與專案團隊合作，找出可能收到這封郵件的人，並請對方提供帳單帳戶 ID (以連字號分隔的一連串字元和數字)。
[你] 與 Google 或合作夥伴合作，確保已執行帳單驗證，也就是說，你的系統已正確向 Google 回報行程或工作。詳情請參閱下一節。
[您] 使用 Cloud Console 將 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"
```
如果顯示項目，表示後端系統已正確將工作設為「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 地圖平台帳單帳戶，因為該處的流量應與行動裝置帳單帳戶分開。

請務必遵守導入政策：

以行程為基礎的模型 -「隨選乘車與運送服務解決方案適用於隨選商用乘車與運送服務。這類服務通常包括 (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 地圖平台要求併入行動裝置帳單帳戶，用於行動裝置應用情境。

結論

總而言之，正確設定帳單帳戶是價格可預測性和透明度的重要關鍵。我們的行動技術採用頂尖的位置資訊服務，可確保企業的帳單程序準確有效。這不僅有助於降低成本，還能提供必要的資料和洞察資訊，協助您做出明智的業務決策。此外，這類系統提供的透明度可讓公司清楚瞭解支出，進而更妥善地管理預算。

後續動作

在 GCP 控制台中設定帳單帳戶。
如要進一步瞭解一般計費方式，請參閱
- Mobility Services 商業文件
- 啟用、停用或變更專案的計費功能 bookmark_border。