在正式環境中實作新的 Google 地圖專案前,請務必確認設定正確無誤,以便支付正確的產品費用。在本文件中,我們會介紹各方面以確保您 (i) 帳單資訊公開,也就是在產生月結單前驗證用量;以及 (ii) 正確的專案設定,確保您可以使用我們的產品。
雖然這個過程應該相對簡單,但 Google 地圖合作夥伴仍可配合,確保專案移動正確。
概念
在本節中,我們希望確保您瞭解 Google 地圖帳單的基本資訊,以及可用的各種設定。每個情況之間沒有是對的,這取決於您想達成的結果類型。
在本文件中,我們會深入討論您的 Google Cloud 專案。這是因為可以透過這項服務取得 Google 地圖產品。也就是說,本文件中提及的設定是在 Google Cloud 專案中執行。
帳單帳戶
目前所有使用 Google 地圖產品的公司都有相關聯的 Google Cloud 專案。您必須為這項專案設定帳單帳戶。帳單帳戶會負責累計所有 Google 地圖用量,並按月根據該用量開立發票。
針對「行動性」,系統會佈建特殊帳單帳戶。這個帳單帳戶僅適用於與行動不便相關的用途,例如共乘/代僱駕駛服務、外送和物流業。
單一帳單帳戶可由多項 Google Cloud 專案或單一專案使用。
指向同一個帳單帳戶的單一專案:
- 具體用途 (例如行動不便)
- 個別月結單
- 折扣是根據此專案的數量計算
多個專案指向同一個帳單帳戶:
- 相同用途
- 匯總用量來掌握折扣層級
- 單一應付憑據
如要進一步瞭解帳單帳戶和其他相關資訊,請點選這個連結。
如上所述,單一帳單帳戶可以指向多項專案。如果您有多項專案,凡是沒有與行動管理用途相關的專案,則應繼續指向您目前使用的一般 Google 地圖平台帳單帳戶。如要取得行動帳單帳戶,必須與 Google 或透過合作夥伴簽署行動交易協議。以下說明帳單帳戶能如何符合整個結構定義,以及各種可能的設定:
雲端資源、帳單帳戶及產生月結單
談論 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 十次。如要進一步瞭解這些限制,請參閱行動管理說明文件中的使用限制。調整上限時,您必須修改合約內容,因此請與 Google 或合作夥伴代表聯絡,討論您的具體需求。
月底時,系統會根據 (i) 系統中記錄的成功行程或工作數量,以及 (ii) 超過預定上限 (「超額」) 的任何 Google 地圖平台 API 呼叫數量 (「超額」) 產生月結單。這些限制與我們在市場上廣泛看到的需求一致。
建議您詳閱這篇文章,詳閱官方行動管理帳單說明文件。
前測與評估
客戶可在簽署合約前,透過 Google 地圖平台帳單帳戶,在有限時間內進行行動管理服務的小型前測計畫 (概念驗證和評估)。如要執行前測,請聯絡您的地圖合作夥伴或 Google 支援人員。
在前測階段,如上所述,由於尚未簽署合約,所以沒有行動帳單帳戶可用。這表示每當您使用 Google 地圖平台產品時,系統就會收取該產品的費用,但行動裝置專用產品則不會。也就是說,在前測階段的計費方式並非以工作或行程為基礎,因此在此階段不適用限制。
前測計畫正式推出至正式版後,必須按合約付費。
摘要:
前測 / 開發階段:您只需要為公開提供的 Google Maps API 付費。在專案使用行動管理帳單帳戶前,無法公開使用的 API 和 SDK 不會產生費用。請注意,對於新建立的帳單帳戶,Google 會提供價值 $200 美元的 Google 地圖平台 API 抵免額。在評估期間,這類元件應足以用於受控管的環境。
生產階段:向您收取行程或工作費用。只有在用量超出合約使用限制 (「上限」) 時,系統才會產生 Google 地圖平台相關費用。如果有,您將需要支付超額費用。超額計費的定義請參閱這裡。
如何遷移至行動管理服務帳單帳戶
遷移至實際工作環境時,通常需要建立其他幾個 Google Cloud Platform (GCP) 專案來代表不同的環境,例如品質確保 (品質確保) 和實際工作環境。在您可能只擁有單一環境之前,就是開發環境。
相關規定
你的側邊使用者可以執行下列操作:
- 在 Google Cloud 中管理帳單帳戶,通常由「帳單帳戶管理員」或「專案擁有者」執行。
- 簽署合約簽署後產生的歡迎信中隨附的新帳單帳戶 ID。
- 具備與回報行程或工作相關的正式環境,具備相應的 Google Cloud 專案存取權。
以下將說明建立新專案的必要步驟,以及如何設定這些新專案的計費功能。
新專案設定
建立專案
- [您] 為新環境 (即實際工作環境、品質查驗等) 建立新的 GCP 專案。使用 Google Cloud 控制台的直接連結即可完成此步驟。
- [合作夥伴或 Google 團隊] 必須將這項專案加入許可清單,才能使用行動管理產品。請與 Google 或合作夥伴的業務代表合作,由對方協助你完成這項操作。請提供在上一個步驟中建立的專案 ID。
- [你] 更新專案的重要聯絡人。為確保 Google 支援團隊能順利聯繫您,這就相當重要。
專案設定
使用 Google Cloud 控制台建立於先前步驟中建立的專案,應執行下列步驟:
- [您] 建立服務帳戶,包括將正確的行動性識別和存取管理 (IAM) 角色 (以行程為準和以任務為基礎) 建立關聯。
- [您] 建立 API 金鑰:如同模擬於開發環境,或視需要採用更結構化存取權區隔 (例如按產品、網域等) 進行操作。
- [您] 啟用「本地乘車與運送服務」等 API 和所需的其他 Google 地圖平台 API (例如地理編碼、自動完成、地址驗證)。
- [您] 配額:如要針對特定 API 提高 QPS (每秒查詢次數) 升幅,請提交支援單。如需操作說明,請參閱這篇文章。您必須新增業務正當理由,說明需要提升成效的原因。如要查看預先定義的配額,請按這裡。
- [您] 如果您開發的系統是使用開發環境中的憑證,請確認這些系統能夠指向因為新建專案而建立的新憑證。這包括將後端和前端系統指向新的憑證 (例如 API 金鑰、服務帳戶),以及確保每個環境中使用的專案 ID 正確無誤。
帳單設定
我們假設您已直接與 Google (如適用) 或透過合作夥伴簽署合約。這是取得「歡迎信」中的 Mobility Billing 帳戶前的必備條件,此信將會在後續步驟中使用。
- [您] 簽署合約簽署後,Google 會透過電子郵件寄送歡迎信,確認您是否收到行動帳單帳戶 ID。重要事項:系統會將歡迎信傳送給合約中載明的技術和財務聯絡人。請與您的專案團隊合作,瞭解哪些人可能已收到付款資料,並請對方提供帳單帳戶 ID。這組 ID 是由一系列字元和數字組成,並以連字號分隔。
- [您] 與 Google 或合作夥伴合作,確保已進行帳單驗證,這表示您的系統已正確向 Google 回報行程或工作。詳情請參閱下一節。
- [您] 使用 Cloud 控制台將 Google Cloud 專案指向新的帳單帳戶。詳情請參閱本文件的「帳單帳戶設定」一節。
帳單驗證
為確保您支付的費用正確無誤,帳單驗證相當重要。有時候,公司可能會不小心導入 API,導致費用增加或回報不彰。
帳單驗證包含下列步驟:
確認向 Google 地圖平台 API 發出的要求,要求標頭中是否含有 TripId (或 taskId)。詳情請參閱這篇文章。
確認行程 (或工作) 是否已正確回報。這取決於所用的行動性套件:
- Mobility Starter 和 Optimization,或 Accelerate (Trip 導向):必須整合 ReportBillableEvent API。這表示每次行程順利完成時,都必須向這個 API 發出要求。如要驗證這個問題是否正確無誤,請按照這篇文章中的步驟操作。
- 活動加速 (以工作為準):帳單不必由 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 不會執行失敗。如果是行動性服務,請務必確認是否已正確實作 Fleet Engine (Local Rides and Deliveries API) 整合功能。
如要這麼做,請開啟 Cloud Logging 並使用下列查詢:
jsonPayload.errorResponse.code:*
這應該會列出所有有問題的記錄項目。例如:
這些問題可匯出至其他 Cloud 產品,例如 BigQuery。您可以根據 Cloud Logging 查詢,設定指標和快訊:
這些是 Google Cloud 產品,可能會產生額外費用。如要進一步瞭解相關資訊,請洽詢合作夥伴或 Google 代表。
帳單帳戶設定
如果您的所有系統現已正確回報行程或 Tasks,也沒有任何整合錯誤,現在便是將專案指向您收到的帳單帳戶,以歡迎信中所附的歡迎信內容,以及本文件前幾節討論的內容。
注意:如果與 Google 地圖合作夥伴合作,他們可以在此提供協助,你不必單獨執行下列步驟。如果您直接與 Google 合作 (在某些區域可能會發生),可以採取下列步驟:
如要授權,請按照下列步驟操作:
- 開啟 Google Cloud 控制台 (https://console.cloud.google.com)。
- 選取要在實際工作環境中使用的新專案。
- 前往該專案的「帳單」部分。如要取得捷徑,可前往這個連結:https://console.cloud.google.com/billing
- 依序點選「帳單」>「管理帳單帳戶」:
- 前往「帳單」>「在已建立的正式環境專案」旁點選 3 點圖示 ,然後選擇「變更帳單帳戶」:
- [帳單] > [帳單帳戶],然後在下拉式清單中選擇您收到的帳單帳戶代碼。然後點選「設定帳戶」:
- 系統會將專案連結至新的帳單帳戶:
- 新增付款方式後,請前往「總覽」>「付款總覽」和「付款設定」確認資訊是否正確。如要進一步瞭解如何更新帳單和付款,請參閱這個連結。
如有任何帳單相關問題,請提交billing 客服案件,或洽詢您的合作夥伴或 Google 代表。
帳單報表
帳單報表可協助您瞭解連結至專案的帳單帳戶相關費用。
注意:如果您與 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。 3. 確認導入行動管理解決方案後,是否仍需使用 Google 地圖平台 API。舉例來說,如果 Fleet Engine 會自動計算預計到達時間,您可能不再需要使用 Directions API 計算這些 API 數量。4. 瞭解將行動工作用途完全遷移至全新行動管理平台所需的時間。5. 仔細確認「使用限制」是否足以支援您的用途。6. 找出所有 Google 地圖平台要求可全部存入行動管理帳單帳戶,以便因應行動性用途的轉折點。
結論
總而言之,妥善設定帳單帳戶是確保價格可預測性和資訊公開的關鍵。我們的行動不便技術整合了一流的定位服務,因此公司可以確保帳單程序正確且有效率。如此一來,不僅有助於降低成本,還能獲得必要的資料和洞察資訊,進而做出明智的業務決策。此外,這套系統提供公開透明的資訊,可讓公司清楚掌握支出情形,進而提高預算管理成效。
下一步
- 在 GCP 控制台中設定帳單帳戶。
- 如要進一步瞭解一般計費方式,請前往