簡介
驗證地址 API 是一種智能解決方案,可解析不準確的聯絡資料及加快準確送遞包裹的速度。此 API 使用適當格式處理輸入的收件人地址資料,與有效地址非常相似,並發回可能是預期地址的真實地址。
此 API 還提供有關輸入地址的缺失或為送達該實際地址而對輸入資料所作出更改的註釋。您可以在託運包裹之前使用此 API 驗證和解析收件人地址資料。
注意:請勿使用此 API 確定某一地址是否能遞送貨件。FedEx 不會向每個有效的地址提供遞送服務。FedEx 不會遞送貨件至郵政信箱 (經 FedEx Ground® Economy (前稱 FedEx SmartPost®) 除外)。
驗證地址 API 詳情
此 API 允許在託運包裹之前驗證和更正收件人地址資料。託運標籤上的準確地址將有助消除延遲送遞和額外地址更正費用 (由於地址格式錯誤)。
請注意:
- 地址分析結果視乎國家/地區或有所不同。
- 請求中輸入的地址與 FedEx 數據庫中的參考數據進行比較,並發回吻合的地址。
驗證地址 API 功能
- 提供相符的街道地址。
- 接收每月更新的地址資料庫。
- 如果有完美配對,則區分商業地址和住宅地址。
- 現在未能確認套房或公寓號碼。
驗證地址 API 功能
- 填妥不完整的收件人地址。在某些情況下,驗證地址 API 將能夠添加缺失的資料,具體取決於提供的資料與參考數據的驗證。驗證地址 API 目前無法添加缺少的輔助資料 (即公寓或套房)。
- 接收每月更新的地址資料庫。
- 更正無效的收件人地址。例如,更正不正確的郵遞區號以與輸入的其餘資料吻合。
- 確定地址是商業地址或住宅地址,以提高協定運費報價表的準確程度。僅適用於美國和加拿大地址。
- 確認以下地區中許多國家/地區地址的有效性和完整性:美國、加拿大、拉丁美洲、歐洲、中東和亞太區。您現在可以在託運包裹之前驗證國內和國際地址資料,從而消除不必要的延遲送遞和額外的服務費用。
- 提供配對的街道地址。
- 在一個 API 請求中最多可以核對 100 個地址。
支援驗證地址 API 的國家/地區
您可以在以下國家/地區使用 FedEx 驗證地址 API 來驗證和更正收件人地址,以實現高效送遞。
安的列斯 | 丹麥 | 巴拿馬 |
阿根廷 | 多米尼克共和國 | 秘魯 |
阿魯巴 | 愛沙尼亞 | 葡萄牙 |
澳洲 | 芬蘭 | 新加坡 |
奧地利 | 法國 | 南非 |
巴哈馬 | 德國 | 西班牙 |
巴巴多斯 | 希臘 | 瑞典 |
比利時 | 危地馬拉 | 瑞士 |
百慕大 | 中國香港特別行政區 | 特立尼達和多巴哥 |
巴西 | 意大利 | 英國 |
加拿大 | 牙買加 | 美國 |
開曼群島 | 馬來西亞 | 烏拉圭 |
智利 | 墨西哥 | 委內瑞拉 |
哥倫比亞 | 荷蘭 | 維爾京群島 |
哥斯達黎加 | 新西蘭 | |
捷克共和國 | 挪威 |
注意:驗證地址請求發回的資料僅供建議使用。
法律免責聲明:此處提供的數據是 FedEx 的專有和機密資料,應您的要求善意提供。未經 FedEx 書面許可,不得以任何形式向任何第三方分發或披露此數據的任何部分。它反映 FedEx 送遞地址數據庫中目前的 FedEx 商業/住宅地址分類,並且可能隨時變更。在提供此資料時,FedEx 不保證其現在或將來的準確性,也不保證送遞至此等地址的包裹將根據此處提供的商業/住宅分類開具發票。提供此資料不應被視為改變雙方關係的條款。請查看 FedEx 服務指南以及適用於管理 FedEx 託運和費用的帳戶定價協議條款及細則。
驗證地址 API 的運作方式
驗證地址
使用此終端驗證和解析輸入地址及發回真實地址。提供及驗證地址詳情以解析地址。當輸入地址與已知參考數據相符時,則說明地址已解析。
與此請求相關的必須輸入資料為:
- 街道行
- 城市 (可選填)
- 州或省編號 (可選填)
- 郵遞區號 (可選填)
- 國家/地區代碼
注意:當顧客託運至沒有郵遞區號的國家時,提供州代碼或城市名稱即可。
驗證地址 API 透過對輸入地址執行以下操作來發回真實地址:
- 在第一個步驟中,API 嘗試規範輸入地址。這可以包括用標準縮寫(例如 ST 和 PKWY)替換街道和公園路等常見道路標識符,以及重新排序地址的組成部分。如果輸入地址無法規範,則發回的已解析地址將是輸入地址。非地址值被丟棄。
- 在第二個步驟中,API 嘗試查找可能是使用者想要的地址或實際地址以將規範化地址標準化。如果標準化失敗,則發回的解析地址將是輸入地址的規範化形式。請參閱發回的元素以幫助確定提交的地址存在的問題。
- 將發回該規範化地址的某些元素。如果標準化確實成功,則發回的解析地址將是真實世界的地址。在這種情況下,還發回標準化地址的各種附加元素以及關於它是如何從規範化地址衍生的資料。
驗證地址 API 回傳的數值
如果發回的地址包含下列屬性的下列值,則地址有效:
- 已對地址狀態進行標準化
- 解析地址的屬性為真
- 遞送點有效 (DPV) 為真
- 已篡改地址為錯誤
如果這些內容未列出,則使用額外屬性以確定地址值的可能問題。
有關地址屬性的更多資訊,請參見地址屬性。
如果輸出發回顧客訊息代碼為 INTERPOLATED.STREET.ADDRESS,則有可能地址無效。有關顧客訊息代碼的更多資料,請參閱顧客訊息的概要說明。
城市化 (僅限波多黎各):此說明通常用於波多黎各的城區,是當地地址格式中十分重要的一個因素,用於形容特定街道的位置。在波多黎各,在同一郵區編號內存在重複的街道名稱及地址號碼範圍。這些街道可能具有相同的門牌號碼範圍。在此情況下,需要城市化名稱以正確識別特定地址的位置。
例如:Sr Pedro Rivera Urb Hermosillo Calle Bayamon, PR 00961-1212。
註解
驗證地址 API 發回每個已驗證及發回的地址註解。註解亦提供有關所輸入地址存在缺失的資料及為送達該實際地址而對輸入資料所作出的更改。
地址分類
驗證地址 API 使用參考數據來確定地址的分類。功能地址分類是在驗證地址過程中獨立計算,並基於營運人員的反饋,而商業數據來源僅用於確認。
驗證地址 API 只有四種可能的地址分類:未知、商業、住宅和混合。所有地址都以「未知」分類開始並保持這種狀態,直至地址驗證商業規則確定應更改其分類。如果某個位置是一個多租戶的地址,並且同時包含商業和住宅單位,則該位置只會獲得「混合」分類。
注意:FedEx Express 服務為收件人地址提供額外的地址行 (地址行 3)。此附加地址資料提供更完整和準確的位置詳情,從而提高獲得準確地址的機會。
現實世界的地址分類如下:
商業地址
商業地址用於指定主要營業地點的地址。這是業務應該經營的位置,但情況可能並非總是如此。
公司地址是公司辦公場所的官方地址。它的範圍從某人的住址至價值數百萬美元的校區,例如受青睞的大型科技公司及介乎兩者之間的地址。
住宅地址
住宅送遞費用適用於在美國境內託運至家居或私人住宅的貨件,包括在家中經營業務的地點。視乎到目的地的距離而定,FedEx Home Delivery 住宅派送可透過 FedEx Ground 於 1 個工作天內派送。
範例:
- 教區牧師長住所
- 女修道院
- 教區牧師住宅
- 多單位住宅的居民,例如:
- 公寓大廈
- 分套購置的公寓樓
- 學校宿舍
- 銷售和/或分銷產品的住宅
使用驗證地址 API 的小貼士
以下是關於使用驗證地址 API 的一些有用提示:
- 使用正確的間隔:確保正確輸入空格並避免不必要的空格。
- 使用正確的拼寫: 避免任何拼寫和打字上的錯誤。同樣,請確保您正確使用數字零 (0) 和英文字母 O。
- 避免特別字元: 請不要使用不必用於地址中的特別字元,例如縮寫後的句號 (Ave vs. Ave.)。
- 提供額外的地址和街道資訊:透過提供額外的地址資訊,您可以增加地址調查結果的準確性。
- 建築物或房屋號碼 - 1, 1A, 1½, One
- 街道名稱 - Main, George Washington, 42nd
- 街道前綴 - Road, Avenue, Rd, Ave
- 輸入城市、州/省、郵區編號或郵遞區號:提供這三項資訊會增加您地址調查結果的準確性。
- 按次序輸入街道和地址:街道地址元素通常都有一個特定模式,由建築物或房屋號碼開始,然後是一個指示方向的元素,街道名稱、街道類別或前綴(一個指示其後方向的元素)、公寓稱號、公寓號碼及/或私人郵箱稱號和號碼。
- 使用正確的縮寫:美國郵遞服務和加拿大郵局對州/省的縮寫,街道前綴和公寓或單位稱號皆設有統一標準。
- 不符合標準的縮寫可能會導致不準確的搜尋結果。
- 如果您不確定如何使用某個縮寫,請不要使用。
- 城市化 - 一個城市化名稱表示在一個地理位置中的一個地區、部分、或住宅開發。
例如:
- 建築物或房屋號碼,例如 1, 1A, 1½, One
- 街道名稱,例如 Main, George Washington, 42nd。
- 街道前綴,例如 Road, Avenue, Rd, Ave。
- 輸入城市、州/省或郵遞區號:提供所有地址資料會增加調查結果的準確性。檢查地址不需要郵遞區號的 ZIP+4 部分。
- 使用正確的縮寫:美國郵遞服務和其他國家/地區的郵政當局對州/省、街道前綴和公寓/單位稱號皆定義標準的縮寫。不符合標準的縮寫可能會導致不準確的搜尋結果。如果您不確定如何使用某個縮寫,請不要使用。
- 考慮將驗證地址回應反饋發回給使用者,以便他們可以選擇最正確的地址。
業務規則
- 請勿使用此 API 確定某一地址是否能遞送包裹。FedEx 不會向每個有效的地址提供遞送服務。FedEx 不會遞送貨件至郵政信箱(經 FedEx Ground® Economy (前稱 FedEx SmartPost®) 除外)。
- 解析地址發回的資料僅供建議使用。
- 在一個請求中最多可以核對 100 個地址。
- 所需的最少欄位因國家/地區而有所不同。
例如,美國地址至少需要一個地址行和郵遞區號或城市和州代碼,但對於 AUS (澳洲地址格式) 地址,即使沒有郵遞區號,州代碼也可能被省略。
- 地址分析結果視乎國家/地區或有所不同。
注意:驗證地址 API 可能不適用於所有國家/地區。請參閱支援驗證地址 API 的國家/地區一節。
JSON API 系列
Response