目標
本文將說明如何在 Google 試算表中使用 Address Validation API,以便快速輕鬆地測試這項服務。
您不是開發人員,但願意使用 Google 地圖平台的資料 (例如 Address Validation API),因此希望在不需要技術團隊太多協助的情況下,開始使用這項服務。
用途
現在,讓我們瞭解 Google 試算表中的 Address Validation API 適用的用途:
- 試用:商家可能想使用自己的地址,快速測試 Address Validation API 的功能。
- 比較:將 Address Validation API 結果與其他端點 (例如 Geocoding API 或 Places API) 的結果進行比較。
- A/B 測試:對相同資料集進行 A/B 測試,瞭解哪些資料集可能提供更合適的結果。
Google 試算表範本
這個解決方案是 Google 試算表,內含自訂 Apps Script 函式,可依序向地址驗證 API 發出要求。
您可以按照下列步驟,透過 API 執行地址 (需要 Google 帳戶和 API 金鑰):
- 前往範例試算表,然後依序選取「檔案」>「建立副本」
(您必須登入 Google 帳戶或建立帳戶) - 啟用 Address Validation API,並從 Cloud Console 產生 API 金鑰。
- 在「API Key + Dashboard」Google 試算表分頁中,將 B2 儲存格替換成您的 API 金鑰。
- 在範本中複製/貼上地址 (在另一個工作表中設定資料格式:串連門牌號碼、名稱、城市、郵遞區號)
- 選取試算表儲存格,然後依序選取「選單」>「地址驗證」>「選取 Address Validation API」
- 首次執行時,系統會顯示「需要授權」訊息,要求您授予 Apps Script 存取權。
Google 地圖平台條款
本解決方案僅供測試,且僅適用於一組有限的地址:
允許的快取期間:連續 30 個日曆天,之後客戶必須 (1) 刪除快取的 Google 地圖內容,或 (2) 替換為透過使用者確認或修正提供的使用者資料。請參閱 Google 地圖平台服務條款表 11.3.1 (快取權限):
- placeId
- 位置:緯度值、經度值
- 判決
- formattedAddress
- postalAddress
- addressComponent: componentName
- USPS 資料標準化地址
注意事項
- 效能:一次處理 1000 列,不要超過這個數量。指令碼最終可能會停止,例如超出每秒 API 配額時,請從指令碼停止的資料列繼續執行。
- 您可以依序點選「選單」>「擴充功能」>「Apps Script」存取程式碼,並根據需求自訂指令碼版本
- Address Validation API 的定價。
結論
Google 試算表的 Address Validation API 可讓非開發人員開始查詢 Address Validation API,並瞭解這項 API 如何為自家業務帶來策略性優勢。本文旨在說明如何建立 API 金鑰並使用提供的 Google 試算表範本,開始查詢 API。
後續動作
建議延伸閱讀:
貢獻者
本文由 Google 維護。以下是這篇文章的原始撰稿人。
主要作者:
Thomas Anglaret | 解決方案工程師\