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

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

在實際在正式環境中導入新的 Google 地圖專案前，請先確認設定正確無誤，以便您為所使用的產品支付正確費用。在本文件中，我們會說明各方面確保 (i) 帳單透明度 - 可在產生月結單前驗證用量和 (ii) 設定正確的專案設定，確保您可使用 Google 產品。

雖然這個程序應該相對簡單明瞭，但 Google 地圖合作夥伴可協助您確保專案可正確遷移。

概念

本節將確保您瞭解 Google 地圖帳單的基本資訊，以及可供採用的各種設定。在許多情況下，沒有對錯之分，取決於您想要達成的結果類型。

在本文件中，我們會大量討論您的 Google Cloud 專案。這是因為使用者可透過這項服務存取 Google 地圖產品。也就是說，我們在本文中介紹的設定是在您的 Google Cloud 專案中進行。

帳單帳戶

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

針對「行動性」，系統會佈建特殊的帳單帳戶。這個帳單帳戶只能用於代僱駕駛服務相關用途，例如共乘/代僱駕駛服務、配送和物流。

單一帳單帳戶可供多項 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 要求數量計算。針對行動性服務，我們會根據成功完成行程或工作 (而非自取) 的可計費行動交易量收費。請在簽署合約前先定義相關規定。如果您是代僱駕駛服務或食物外送公司，當您完成行程或外送服務時，您的成效指標就像是行程。工作適用於必須成功送達包裹的物流公司和零售商。

我們瞭解行動客戶也會在規劃行程和配送行程時使用 Google 地圖平台產品。因此，如果您使用的是行動帳單帳戶，就可以免費呼叫 Google 地圖平台，前提是必須遵守我們在相同行動用途中適用的預先定義的限制。

舉例來說，如果您是美食外送公司，每次成功行程時，您都可以呼叫 Geocoding API 10 次。如要進一步瞭解這些限制，請參閱行動性說明文件中的使用限制。如要變更上限，就必須修訂合約，因此請與 Google 或合作夥伴代表討論具體需求。

到了月底，我們會根據 (i) 系統回報成功的行程或工作數，以及 (ii) 超過預先設定的限制 (「超額」) 的任何 Google 地圖平台 API 呼叫次數 (「超額」) 產生月結單。我們的限制與市場上廣泛採用的做法保持一致。

建議您仔細閱讀官方的行動裝置付款說明文件，請按這裡查看。

前測與評估

客戶可以在簽署合約前，透過 Google 地圖平台帳單帳戶執行為期有限的交通服務小型前測 (概念驗證、評估)。如想進行前測，請聯絡您的 Google 地圖合作夥伴或 Google 的對應人員。

如前所述，在前測階段中，由於尚未簽署合約，因此無法使用行動帳單帳戶。也就是說，只要使用 Google 地圖平台產品，就會產生費用，但行動裝置專屬產品則不會。換句話說，在前測期間，系統不會根據任務或行程收費，因此也不會套用使用限制。

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

摘要：

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

如何遷移至行動性帳單帳戶

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

規定

您可以請身邊的人協助完成以下事項：

管理 Google Cloud 中的帳單帳戶，通常是由「帳單帳戶管理員」或「專案擁有者」負責。
簽署合約後，系統會在歡迎信中提供新的帳單 ID，請務必存取該 ID。
具備會回報行程或工作的正式環境相對應的 Google Cloud 專案存取權。

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

新專案設定

建立專案

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

專案設定

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

[您] 建立服務帳戶，包括正確行動性關聯識別並Access Management (IAM) 角色 (行程) 根據和工作根據)
- 在開發環境中執行，或視需要使用更有條理的存取權分割方式 (請參閱本節)。
[您] 建立 API 金鑰：就像在開發環境中一樣，能以更結構化的方式區隔存取權 (例如按產品、網域等) 可以視需要使用
[你] 啟用「本機乘車和運送服務」等 API和其他 Google 地圖需要平台 API (例如 Geocoding、Autocomplete、地址驗證)。
[您] 配額：如需提高特定 API 的 QPM (每分鐘查詢數) 增幅，開立支援單。如要瞭解如何操作，請參閱這篇文章。您必須提供業務理由，說明為何需要提升。可查看預先定義的配額請按這裡。
[您] 如果您開發的系統使用開發環境中的憑證，請確認這些系統能夠指向為新專案建立的新憑證。包括將後端和前端系統指向新憑證例如 API 金鑰、服務帳戶，以及確認專案 ID 正確無誤用於個別環境

帳單設定

此處假設您已直接與 Google 簽訂合約 (如適用)，或是透過合作夥伴簽訂合約。這是在歡迎信中取得行動帳單帳戶的先決條件，後續步驟將會用到。

[您] 確認在簽署及執行合約後，Google 會在歡迎信中收到行動帳單帳戶 ID。重要事項：我們會將歡迎信寄給技術與財務聯絡人，信中會依照合約訂單規定指定。請與專案團隊合作，瞭解哪些人可能收到這組 ID，並請由專員提供帳單帳戶 ID。帳單帳戶 ID 由一串字元和數字組成，並以連字號分隔。
[你] 請與 Google 或合作夥伴合作，確保已執行帳單驗證，也就是你的系統已正確向 Google 回報行程或工作。詳情請參閱下一節。
[您] 使用 Cloud 控制台將 Google Cloud 專案指向新的帳單帳戶，請參閱本文後續的「帳單帳戶設定」一節。

如要進一步瞭解帳單概要說明，請按這裡和這裡。

帳單驗證

帳單驗證非常重要，因為這可確保我們正確收費。有時候，公司可能會不小心導入 API，導致費用增加或報表微不足。

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

確認 Google 地圖平台 API 要求的請求標頭是否包含 tripId (或 taskId)。詳情請參閱這裡。
確認行程 (或任務) 是否已正確回報。這取決於目前使用的行動套件：
- 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:*

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

這些問題可以匯出至其他 Cloud 產品，例如 BigQuery。您可以根據 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」中，從下拉式清單中選擇您在「歡迎信」中收到的帳單帳戶代碼。接著，按一下 [設定帳戶]：
專案將連結至新的帳單帳戶：

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

帳單報表

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

注意：如果您與 Google 地圖合作夥伴合作，請與對方合作確認是否已取得所需的相關帳單資訊。

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

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

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

成效提升計畫

值得一提的是，您需要制定逐步增加預算的計畫。視貴公司的性質而定，並非所有流量都會遷移至行動性專案。舉例來說，有些公司需要時間將新的解決方案推出至所有分公司、加盟店、店面、辦公室等，因此部分流量將使用舊系統，部分流量將傳送至新專案。

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

請務必遵守《導入政策》：

行程型模型：「隨選乘車與運送服務解決方案適用於隨選、商業乘車和運送服務。這類服務通常包括：(a) 要求行程並抵達指定目的地 (或運送特定商品) 的消費者；以及 (b) 與要求相符，以及駕駛車輛完成服務的消費者。」
任務型模型：「Google 地圖平台最後一哩車隊解決方案適用於商業最後一哩外送和第一哩接送服務。這類服務通常包括：(a) 客戶擁有或約定的一輛貨運車輛；(b) 根據預先規劃的路線運送產品；(c) 由提供作業團隊的配送中心網路提供貨物交付執行程序，以及 (d) 追蹤並收到貨物的消費者。」

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

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

您可以增加向 Google 回報的行程 / 工作數量 (加快適應期)，因此適用較高上限。在這種情況下，您每月必須回報 50 萬次行程 / 工作。
而在合約協商期間，我們會依照先前所述的方式，協商較高的限制。
您將 Geocoding API 要求指向 Google 地圖平台 API，即可享有較高的折扣層級，並以低於超額費用的價格付費。

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

總結來說，您必須完成下列步驟，才能建立適當的適應期： 1.找出行動相關用途，以及哪些用途與實作政策無關。 2. 找出目前用於相關用途的 Google 地圖平台 API，以及這些 API 數量。 3. 確認在導入行動解決方案後，是否仍需要使用 Google 地圖平台 API。舉例來說，如果在 Fleet Engine 上自動計算預估到達時間，您可能就不需要再使用 Directions API 計算。4. 瞭解在裝置端將行動性用途完全遷移至新的行動平台需要多少時間。 5. 請仔細檢查使用上限是否足以支援您的用途。 6. 針對行動用途，找出所有 Google 地圖平台要求都能摺疊至行動帳單帳戶時的轉折點。

結論

總而言之，正確設定帳單帳戶，對於價格的可預測性和透明度至關重要。我們的行動技術採用一流的定位服務，可以確保公司帳單流程的正確性和效率。不僅有助於降低成本，還能提供必要的資料和深入分析，協助您做出明智的業務決策。此外，借助這類系統的公開透明，公司得以清楚瞭解支出，更有效地管理預算。

後續行動

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