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

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

在正式導入新的 Google 地圖專案前，請先確認設定正確無誤，以便您為所使用的產品支付正確金額。在本文件中，我們將說明以下幾個方面，確保您享有 (i) 透明的帳單資訊 (可在產生帳單前驗證使用情形)，以及 (ii) 正確的專案設定，確保您能使用我們的產品。

這應該是相對簡單的程序，但地圖合作夥伴可以與您合作，確保專案正確遷移。

概念

在本節中，我們希望您能瞭解 Google 地圖結帳系統的基本資訊，以及可能的各種設定。在許多情況下，沒有對錯之分，取決於您想要達成的結果類型。

在本文件中，我們會大量討論您的 Google Cloud 專案。這是因為 Google 地圖產品可透過該帳戶使用。也就是說，我們在本文中介紹的設定是在您的 Google Cloud 專案中完成。

帳單帳戶

目前，所有使用 Google 地圖產品的公司都會與 Google Cloud 專案相關聯。這項專案必須設定帳單帳戶。帳單帳戶會負責累積所有 Google 地圖用量，並根據用量每月開立月結單。

針對Mobility，系統會佈建特殊的帳單帳戶。這個帳單帳戶僅適用於與移動相關的用途，例如共乘、外送和物流。

一個帳單帳戶可供多個 Google Cloud 專案使用，也可以只供一個專案使用。

單一專案指向相同的帳單帳戶：

特定用途 (例如行動用途)
分開開立月結單
折扣是根據這項專案的數量計算

多個專案指向同一個帳單帳戶：

相同用途
匯總使用量，享有折扣等級優惠
單一月結單

如要進一步瞭解帳單帳戶和其他相關資訊，請按這裡。

如上所述，單一帳單帳戶可指向多個專案。如果您有多個專案，請找出哪些專案會使用我們的移動服務，並將這些專案指向移動帳單帳戶。如果專案沒有相關的行動應用程式用途，請繼續將其指向您目前使用的一般 Google 地圖平台帳單帳戶。如要取得行動裝置帳單帳戶，您必須與 Google 或合作夥伴簽訂行動裝置交易合約。下方說明帳單帳戶如何融入整個結構，以及可能的不同設定：

Cloud 資源、帳單帳戶和月結單產生作業

談到價格，Google 地圖平台提供不同等級的折扣，可透過 Google 地圖合作夥伴或在某些情況下直接向 Google 取得。這些等級是以用量為依據，因此使用產品越多，您支付的費用就越低 (折扣會個別套用至每個 SKU)。我們的帳單系統會根據您用來呼叫 Google 產品的憑證(可能是 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 地圖平台產品，就會產生費用，但行動裝置專屬產品則不會。換句話說，在前測期間，系統不會根據任務或行程收費，因此也不會套用使用限制。

前測正式推出後，必須依照合約支付費用。

摘要：

前測 / 開發階段：您只需為已公開的 Google 地圖 API 付費。在專案中使用行動裝置結帳帳戶之前，不會產生非公開 API 和 SDK 的費用。請注意，Google 會為您建立的任何新帳單帳戶提供 $200 美元的 Google 地圖平台 API 抵免額。這應該足以在評估期間提供受控環境。
實際執行階段：您會依據行程或任務付費。只有在用量超過合約的用量限制 (「上限」) 時，才會產生與 Google 地圖平台相關的費用。在這種情況下，您必須支付超出額度的費用。超量使用會依這裡的定義計費。

如何遷移至行動裝置帳單帳戶

遷移至正式環境時，您通常必須建立其他 Google Cloud 專案，用於代表 QA (品質確保) 和正式環境等不同環境。在此之前，您可能只有單一環境，也就是開發環境。

規定

你的同事或同事，可以：

管理 Google Cloud 上的帳單帳戶，通常由帳單帳戶管理員或專案擁有者負責。
簽署合約後，系統會在歡迎信中提供新的帳單 ID，請務必存取該 ID。
存取與實際工作環境相對應的 Google Cloud 專案，以便回報行程或任務。

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

新專案設定

建立專案

[您] 針對每個新環境，在 Google Cloud 控制台中建立新的 GCP 專案。例如正式環境、測試環境和品質確保。
[合作夥伴或 Google 團隊] 將新專案加入許可清單，以便存取 Mobility 產品。請與 Google 或合作夥伴的業務代表聯絡，並提供先前步驟中建立的專案 ID。
[您] 更新專案中的重要聯絡人。這個步驟非常重要，可確保 Google 支援團隊在必要時能與專案的正確人員聯絡。

專案設定

針對先前步驟中建立的專案，在 Google Cloud 控制台完成下列步驟：

[您] 建立服務帳戶，並連結正確的 Mobility Identity and Access Management (IAM) 角色 (以行程為準和以任務為準)
- 在開發環境中執行，或視需要使用更有條理的存取權分割方式 (請參閱本節)。
[您] 建立 API 金鑰 - 在開發環境中建立，或在需要時使用更有條理的存取權區隔 (例如每個產品、網域等)。
[您] 啟用「Local Rides and Deliveries」等 API，以及其他所需的 Google 地圖平台 API (例如 Geocoding、自動完成、地址驗證)。
[您] 配額：如需針對特定 API 提高 QPM (每分鐘的查詢次數)，請向支援團隊提出支援單。如要瞭解如何操作，請參閱這篇文章。您必須提供業務理由，說明為何需要提升。如要查看預先定義配額，請按這裡。
[您] 如果您開發的系統使用開發環境中的憑證，請確認這些系統能夠指向為新專案建立的新憑證。這包括將後端和前端系統指向新的憑證 (例如 API 金鑰、服務帳戶)，並確保在各個環境中使用正確的專案 ID。

帳單設定

我們假設您已直接 (如適用) 或透過合作夥伴與 Google 簽署合約。這是接收歡迎信中 Mobility Billing 帳戶的必要條件，這個帳戶會在後續步驟中使用。

[您] 請確認是否已收到 Google 在合約簽署及執行後，透過電子郵件寄送的歡迎信，其中包含行動裝置帳單 ID。重要事項：歡迎信會傳送給合約訂單表單中所列的技術和財務聯絡人。請與專案團隊合作，瞭解誰可能已收到這封電子郵件，並請對方提供帳單帳戶 ID，也就是一系列以連字號分隔的字元和數字。
[你] 請與 Google 或合作夥伴合作，確保已執行帳單驗證，也就是你的系統已正確向 Google 回報行程或工作。詳情請參閱下一節。
[您] 使用 Cloud 控制台將 Google Cloud 專案指向新的帳單帳戶，請參閱本文稍後的「帳單帳戶設定」一節。

如要進一步瞭解一般帳單資訊，請參閱這篇文章和這篇文章。

帳單驗證

帳單驗證非常重要，可確保您正確付費。有時候，公司會不小心錯誤導入 API，導致收費過多或未充分回報。

帳單驗證程序包含下列步驟：

確認 Google 地圖平台 API 要求的請求標頭是否包含 tripId (或 taskId)。詳情請參閱這篇文章。
確認行程 (或任務) 是否已正確回報。這取決於您使用的Mobility Package：
- Mobility Starter 和 Optimize，或 Accelerate (以行程為準)：必須整合 ReportBillableEvent API。也就是說，每當行程順利完成時，就必須向這個 API 提出要求。如要驗證這項功能是否正常運作，請按照這裡所述步驟操作。
- Mobility Accelerate (Task Based)：結帳不必由 API 呼叫觸發。在提交工作時，如果工作結果設為「成功」，系統就會自動執行這項操作。因此，請務必將工作結果正確設為「失敗」或「成功」。客戶工程師 (合作夥伴或 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"
```
如果顯示項目，表示後端系統已正確將任務設為「成功」。

注意：請務必確認實際行程或已成功完成的任務次數是否與回報的通話次數相符。有時我們會看到已回報的帳單事件，但這些事件與實際完成的趟次或任務總數不符 (未充分回報)。

整合健康狀態

成功遷移至實際工作環境後，不僅要確保計費系統正常運作，也要確保 API 執行無誤。在行動服務方面，請務必確認是否已正確實作與車隊引擎 (Local Rides and Deliveries API) 的整合。

如要這麼做，您可以開啟 Cloud Logging 並使用下列查詢：

jsonPayload.errorResponse.code:*

這應該會列出所有有問題的記錄項目。例如：

這些問題可以匯出至 BigQuery 等其他 Cloud 產品。您可以根據 Cloud Logging 查詢設定指標和快訊：

透過 Cloud Logging 查詢建立指標 — **從 Cloud Logging 查詢建立指標**

由於這些是 Google Cloud 產品，因此可能會產生額外費用。如需進一步瞭解，請洽詢合作夥伴或 Google 代表。

帳單帳戶設定

如果所有系統現在都能正確回報行程或工作，且沒有整合錯誤，請將專案指向您在歡迎信中收到的帳單帳戶(這部分已在本文件前面幾節中說明)。

注意：如果您與 Google 地圖合作夥伴合作，他們可以協助您完成這項作業，您不必自行按照下列步驟操作。如果您是直接與 Google 合作 (部分地區適用)，請按照下列步驟操作：

請按照下列步驟操作：

開啟 Google Cloud 控制台 (https://console.cloud.google.com)。
選取要用於正式版的新專案。
前往該專案的「帳單」部分。您可以透過以下連結存取這個捷徑：https://console.cloud.google.com/billing
依序前往「帳單」>「管理帳單帳戶」：

您的專案可能與上述畫面不同。
在「帳單」> 依序按一下已建立的正式版專案旁邊的 3 點圖示，然後選擇「變更帳單帳戶」：
在「Billing」>「Billing account」中，從下拉式清單中選擇你在「Welcome Letter」中收到的帳單帳戶代碼。接著按一下「設定帳戶」：
專案會連結至新的帳單帳戶：

重要事項：從這時起，這個專案中回報的所有行程或工作都會依照先前說明的收費方式計費。如果帳單驗證尚未完成，請勿連結帳單帳戶。
新增帳單資料後，請前往「總覽」>「付款總覽」和「付款設定」，確認資訊是否正確。如要進一步瞭解如何更新帳單和付款資料，請參閱這個連結。如有任何帳單相關問題，請提交帳單客服案件，或與合作夥伴或 Google 代表聯絡。

帳單報表

帳單報表可協助您瞭解與已連結至專案的帳單帳戶相關的費用。

注意：如果您與 Google 地圖合作夥伴合作，請與他們合作，確保您能取得所需的相關帳單資訊。

開啟專案的已連結帳單帳戶，然後選取「報表」。接著，您可以使用下列篩選器組合：

這裡要注意的主要設定是「Group by」篩選器，可依 SKU 顯示行程和工作 (以及使用的其他 API，如有) 的詳細資訊，包括是否有超時情形，如先前所述：

報表資訊每天都會更新。如果需要當日資訊，您可以使用 Cloud Logging 查詢，查看當天發生多少可計費事件。請參閱前述章節。

增加曝光量企劃書

值得一提的是，您需要制定逐步增加預算的計畫。視業務性質而定，並非所有流量都會遷移至行動專案。舉例來說，有些公司需要花時間將新解決方案推廣至所有分公司、加盟店、商店和辦公室等，這表示部分流量會使用舊系統，部分流量會轉往新專案。

此外，在許多情況下，並非所有流量都屬於行動應用程式用途，例如商店定位器、路邊取貨和其他內部解決方案。這些帳戶應指向 Google 地圖平台帳單帳戶，因為該帳戶的流量應與交通帳單帳戶分開。

請務必遵守導入政策：

行程型模型：「隨選乘車與運送服務解決方案適用於隨選、商業乘車和運送服務。這類服務通常包括：(a) 消費者向特定目的地 (或特定商品的送貨) 提出叫車要求，以及 (b) 與要求配對的司機，並由司機駕駛車輛完成服務。」
任務型模型：「Google 地圖平台最後一哩車隊解決方案適用於商業最後一哩外送和第一哩接送服務。這類服務通常包括 (a) 由客戶擁有或簽約的車隊，(b) 根據預先規劃的路線進行運送，(c) 由支援運送執行作業的營運團隊組成的分銷中心網路，以及 (d) 追蹤並接收貨物的消費者。」

因此，請務必瞭解哪些系統應指向 Google 地圖平台帳單帳戶，哪些系統應指向行動裝置帳單帳戶。通常會有多個專案，且每個專案都會指向正確的帳單帳戶。

舉例來說，假設每趟行程 / 工作包含 10 個地址定位要求 (依用量限制)，如果遷移作業需要幾個月的時間，且您在第一個月開始回報 10 萬趟行程 / 工作，表示您可以呼叫 Geocoding API 100 萬次。但如果您的商家有 500 萬個地理編碼要求，則差額 (400 萬) 可能會以超額的方式呈報。這裡有兩種做法：

您增加向我們回報的 Trips / Tasks 數量 (加速提前啟用計畫)，因此會套用較高的上限，在這種情況下，您需要每月回報 50 萬個 Trips / Tasks。
如前所述，您可以在合約協商期間協商更高的上限。
您將 Geocoding API 要求指向 Google 地圖平台 API，即可享有較高的折扣層級，並以低於超額費用的價格付費。

我們瞭解，根據貴商家和用途的規模和複雜度，成本估算作業可能會相當複雜，因此請與合作夥伴或 Google 對應人員合作，找出使用現有專案為正式版推出做好準備的最佳方式。

總結來說，如要建立適當的逐步增加計畫，必須採取下列步驟： 1. 根據實施政策，找出哪些用途與行動相關，哪些不相關。2. 找出目前用於相關用途的 Google 地圖平台 API 和使用量。3. 確認在導入行動解決方案後，是否仍需要使用 Google 地圖平台 API。舉例來說，如果在 Fleet Engine 上自動計算預估到達時間，您可能就不需要再使用 Directions API 計算。4. 找出將行動應用程式用途完整遷移至新行動平台所需的時間。5. 請仔細確認使用限制是否足以支援您的用途。6. 找出轉折點，以便將所有 Google 地圖平台要求合併至行動應用程式用途的行動帳單帳戶。

結論

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

後續行動

在 GCP 主控台中設定帳單帳戶。
如要進一步瞭解一般帳單資訊，請前往
- Mobility Services 商業說明文件
- 啟用、停用或變更專案的計費功能 bookmark_border。