Google 試算表中的 Address Validation API

目標

在本文件中,我們將探討如何在 Google 試算表中使用 Address Validation API,以便快速輕鬆地測試服務。

非開發人員如果想使用 Google 地圖平台的資料 (例如 地址驗證 API),但不想過度仰賴技術團隊的協助,可以透過以下方式開始使用這項服務。

接下來,我們來看看 Google 試算表中的 Address Validation API 有哪些用途:

  • 試用:商家可能想使用自己的地址,快速測試 Address Validation API 的功能。
  • 比較:將 Address Validation API 結果與其他端點結果 (例如 Geocoding API 或 Places API) 進行比較。
  • A/B 版本測試:對相同資料集的變化版本進行 A/B 版本測試,瞭解哪些版本可能提供更合適的結果。

這個解決方案是 Google 試算表,內含自訂 Apps Script 函式,可依序向地址驗證 API 執行要求。

您可以按照下列步驟透過 API 執行地址 (需要 Google 帳戶API 金鑰):

  1. 前往範例試算表,然後依序選取選單中的「檔案」>「建立副本」
    (您必須登入 Google 帳戶 或建立帳戶)
  2. 啟用 Address Validation API,並透過 Cloud 控制台產生 API 金鑰。
  3. 在「API 金鑰 + 資訊主頁」試算表分頁中,將 B2 儲存格替換成您的 API 金鑰。
  4. 在範本中複製/貼上地址 (在單獨的試算表中設定資料格式:連結門牌號碼、名稱、城市、郵遞區號)
  5. 選取工作表儲存格,然後依序選取「Address Validation」>「Address Validation API selection」
    中的選單
  6. 首次執行時,系統會顯示「需要授權」訊息,要求您提供 Apps Script 存取權。



Google 地圖平台條款

本解決方案僅供測試,適用於有限的地址:允許快取的期間:連續 30 個日曆日,過後客戶必須 (1) 刪除快取的 Google 地圖內容,或 (2) 以透過使用者確認或修正提供的使用者資料取代。請參閱 Google 地圖平台服務條款表格 11.3.1 (快取權限)

  • placeId
  • 位置:緯度值、經度值
  • verdict
  • formattedAddress
  • postalAddress
  • addressComponent: componentName
  • USPS 資料 standardizedAddress

注意事項

  • 效能:一次處理 1000 列的資料區塊,不超過這個數量。指令碼最終可能會停止,例如當每秒 API 配額超出時,請從指令碼停止的資料列繼續執行。
  • 您可以依序前往「選單」>「擴充功能」>「Apps Script」,然後根據需求製作專屬的指令碼
  • Address Validation API 的定價

結論

Google 試算表中的 Address Validation API 可讓非開發人員開始查詢 Address Validation API,並瞭解這項 API 對其業務的策略意義。本文將說明如何建立 API 金鑰並使用提供的 Google 試算表範本,讓任何人都能開始查詢 API。

後續行動

建議參閱以下文章:


貢獻者

本文由 Google 維護。以下是原始撰寫者。
主要作者:

Thomas Anglaret | 解決方案工程師