目標
在本文件中,我們將探討如何在 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 控制台產生 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 資料 standardizedAddress
注意事項
- 效能:分段繼續處理 1,000 列資料。指令碼最終可能會停止,例如當每秒 API 配額超出時,請從指令碼停止的資料列繼續執行。
- 依序點選「選單」>「擴充功能」>「Apps Script」即可存取程式碼,並根據需求自行指派專屬指令碼版本
- Address Validation API 的定價。
結論
Google 試算表中的 Address Validation API 可讓非開發人員開始查詢 Address Validation API,並瞭解這項 API 對其業務的策略意義。本文將說明如何建立 API 金鑰並使用提供的 Google 試算表範本,讓任何人都能開始查詢 API。
後續行動
建議的延伸閱讀:
貢獻者
本文由 Google 負責維護。以下是原始作者。
主要作者:
Thomas Anglaret | 解決方案工程師