Google 試算表中的 Address Validation API

目標

本文將說明如何在 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 金鑰):

  1. 前往範例試算表,然後依序選取「檔案」>「建立副本」
    (您必須登入 Google 帳戶或建立帳戶)
  2. 啟用 Address Validation API,並從 Cloud Console 產生 API 金鑰。
  3. 在「API Key + Dashboard」Google 試算表分頁中,將 B2 儲存格替換成您的 API 金鑰。
  4. 在範本中複製/貼上地址 (在另一個工作表中設定資料格式:串連門牌號碼、名稱、城市、郵遞區號)
  5. 選取試算表儲存格,然後依序選取「選單」>「地址驗證」>「選取 Address Validation API」
  6. 首次執行時,系統會顯示「需要授權」訊息,要求您授予 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 | 解決方案工程師\