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