地址驗證 API 屬於智慧型解決方案，可解析不正確的詳細聯絡資訊，並以更精準的方式加速包裹遞送。此 API 可將與有效地址極為相似的收件人地址輸入資訊適當地格式化，然後傳回很可能為使用者打算輸入的實際地址。

此 API 亦提供相關註解，註明輸入地址的缺失，或為了送達實際地址而對輸入內容所做之變更。在託運包裹前，您可以使用此 API 驗證並解析收件人地址資訊。

注意：請勿使用此應用程式開發介面 (API) 來判斷地址的可遞送性。FedEx 並未針對所有的有效地址提供遞送服務。FedEx 不會遞送至郵政信箱 (除非透過 FedEx Ground® Economy (先前稱為 FedEx SmartPost®))。

此 API 可讓使用者在託運包裹前，驗證並更正收件人地址資訊。在託運標籤上記載正確地址，有助於消除遞送延誤以及額外的地址更正費用 (因地址格式錯誤)。

附註：

• 地址解析結果會因國家/地區而異。
• 請求中所輸入的地址將與 FedEx 資料庫中的參考資料做比對，並傳回相符的地址。

地址驗證 API 功能

• 提供街道層級的地址符合資料。
• 接收地址資料庫的每月更新。
• 區別找到的確切符合資料是公司還是住宅地址。
• 目前無法驗證套房或公寓號碼。

地址驗證 API 能力

• 完成不完整的收件人地址。在某些情況下，地址驗證 API 可添加缺少的資訊，具體取決於提供的資訊與參考資料的驗證。地址驗證 API 目前無法添加缺少的次要資訊 (例如公寓或套房)。
• 接收地址資料庫的每月更新。
• 更正無效的收件人地址。例如，更正不正確的郵遞區號，以符合輸入之其他資訊。
• 判斷地址為公司或住宅地址，以提升優惠運費報價的精確度。僅適用於美國與加拿大地址。
• 可確認以下地區中，許多國家地址的有效性與完整性：美國、加拿大、拉丁美洲、歐洲、中東和亞太地區。現在，您可以在託運之前驗證國內與國際地址資訊，去除不必要的遞送延誤和額外服務費。
• 提供街道層級的符合資料。
• 在一個 API 請求中最多可檢查 100 個地址。

支援地址驗證 API 的國家/地區

您可以在下列國家/地區使用 FedEx 地址驗證 API 來驗證並更正收件人地址，以提升遞送效率。

注意：驗證地址要求傳回的資訊僅供參考使用。

法律免責聲明：本文件提供的資料為 FedEx 專有且為機密資訊，在您的要求下免费提供。未經 FedEx 書面許可，不得以任何形式向任何第三方散佈或揭露此資料的任何部分。此资料反映了 FedEx 遞送地址資料庫中之目前的 FedEx 地址層級公司/住宅分類，並且可能有所變更。在提供此資訊時，FedEx 不保證其當下或未來準確無誤，亦不保證送達這些地址的包裹，將根據此處提供的公司/住宅分類開立發票。不得將提供此訊息的行為視為變更雙方關係的條款。請參閱 FedEx服務指南，以及任何適用的帳戶定價合約，瞭解 FedEx 託運與收費的相關條款與條件。

驗證地址

使用此端點驗證和解析輸入地址，並傳回實際地址。提供並驗證地址詳細資料以解析地址，當輸入地址符合已知的參考資料時，將會標註為「已解析」。

與此請求相關的必要輸入資訊為：

• 街道行
• 城市 (選填)
• 州或省代碼 (選填)
• 郵遞區號 (選填)
• 國家地區代碼

注意：當顧客託運至沒有郵遞區號的國家/地區，則填寫州代碼或城市名稱即可。

地址驗證 API 會對輸入地址執行下列作業，以傳回實際地址：

• 第一步：API 會嘗試將輸入地址正規化。這包括更換公用道路辨識文字，例如將街道和大道更換為標準簡寫 ST 與 PKWY，以及重新排序地址的要素。若無法正規化輸入地址，則回傳的已解析地址將為輸入的地址。非地址的值會予以捨棄。
• 第二步：透過尋找使用者打算輸入的可能或實際地址，API 會嘗試標準化經過正規化處理的地址。若無法標準化，則回傳的已解析地址將為經過正規化處理的輸入地址。請參考回傳的元素，以協助判斷提交之地址的問題。
• 正規化地址之特定元素也會被回傳。若無法成功標準化，則回傳的已解析地址將為實際地址。在此情況下，標準化地址的各種額外元素，以及正規化地址如何衍生該元素的相關資訊亦將一併回傳。

地址驗證 API 回傳值

如果回傳的地址包含下列屬性值，則該地址為有效地址：

• 地址州/省已標準化
• 解析地址的屬性為「True」
• 遞送點有效 (DPV) 為「True」
• 內插地址為「False」

如果未列出上述項目，請使用其他屬性來判斷地址值可能的問題。

如需地址屬性的詳細資訊，請參閱地址屬性。

如果輸出的回傳顧客訊息為 INTERPOLATED.STREET.ADDRESS，表示地址可能無效。如需顧客訊息代碼的詳細資訊，請參閱顧客訊息的元素說明。

都市化 (僅限波多黎各)：在波多黎各的都會區域，此描述項經常用於描述特定街道的位置，因此是地址格式中重要的一部分。在波多黎各，相同的郵遞區號可能會出現重複的街道名稱和地址號碼範圍，這些街道可能有同樣的門牌號碼範圍。在這些情況下，需要使用都市化名稱來正確辨別特定地址的位置。

範例：Sr Pedro Rivera Urb Hermosillo 123 Calle 1 Bayamon, PR 00961-1212。

註解

地址驗證 API 會回傳註解，確保所有回傳的地址都已經過驗證並回傳。註解會提供缺失的相關資訊 (若有之)，以及為了送達實際地址而對輸入地址所做之變更的資訊。

地址驗證 API 會使用參考資料，以判斷特定地址的分類。功能地址分類是在驗證地址過程中獨立計算，並基於營運人員的反饋，而商業數據來源僅用於確認。

地址驗證 API 僅有四種可能的地址分類：未知、公司、住宅與混合。所有地址都會先納入「未知」分類，直到地址驗證商務規則判斷需變更其分類為止。若有一地點為多租戶地址，且包含公司和住宅單位，才會分類為「混合」。

備註：FedEx Express 服務針對收件人地址提供附加的地址行 (地址行 3)。此附加的地址資訊提供更完整且精確的地點詳細資訊，協助您取得更準確的地址。

實際地址分類如下：

公司地址

公司地址是您業務主要所在地的地址，也就是您處理業務的場所，但也可能並非一向如此。

公司地址是公司所在處的正式地點，無論是某人的住宅地址還是大型科技公司耗資鉅萬的園區皆有可能。

住家地址

住宅遞送費適用於美國境內的住家或私人住宅託運，包括在住家經營的公司。視目的地距離而定，透過 FedEx Ground 使用 FedEx Home Delivery 在 1 個工作天內進行住宅區遞送。

範例：

• 教區長住所
• 修道院
• 牧師公館
• 集合單位住宅居民，例如：
  • 公寓大樓
  • 共管式公寓
  • 大學宿舍

• 用於銷售和/或配送產品的住宅地址

以下提供一些使用地址驗證 API 的實用秘訣：

• 使用正確的空格：確定空格位置正確，並避免不必要的空格。
• 使用正確的拼字：避免任何的拼字及印刷錯誤。另外，請確定使用正確的數字零 (0) 而非字母 O。
• 避免特殊字元：請避免使用地址不需要的特殊字元，如縮寫字後面的句點 (Ave 與 Ave.)。
• 提供額外的地址和街道資訊：提供額外的地址資訊可提高地址搜尋結果的精確性。
  • 大樓或房屋編號 - 1、1A、1½、One
  • 街道名稱 - Main、George Washington、42^nd
  • 街道字尾 - Road、Avenue、Rd、Ave
• 輸入城市、州/省和郵遞區號：三個全部提供，可提高地址搜尋結果的精確性。
• 依序輸入街道和地址：街道地址部分通常接在大樓或門牌號碼之後，後面則接著前置方向元素、街道名稱、街道類型/後綴、後置方向元素、公寓名稱、公寓號碼及/或私人信箱名稱和號碼。
• 使用正確的縮寫字：美國郵政服務及加拿大郵政具有州/省、街道字尾及公寓或單位名稱的標準縮寫字。
  • 非標準的縮寫字可能造成搜尋結果不理想。
  • 如果不確定縮寫字，請勿使用。
• 都市化 - 都市化名稱代表地理區域內某區域、地段或住宅開發。

例如：

• 大樓或房屋編號，例如 1、1A、One。
• 街道名稱，例如 Main、George Washington、42nd。
• 街道字尾，例如 Road、Avenue、Rd、Ave。
• 輸入城市、州/省和郵遞區號：提供所有地址資訊可提高地址搜尋結果的精確性。檢查地址時，不需要郵遞區號的 ZIP+4 部分。
• 使用正確的縮寫字：美國郵政服務及其他國家/地區的郵政機構，所定義之州/省、街道字尾及公寓或單位名稱的標準縮寫字。非標準的縮寫字可能造成搜尋結果不理想。如果不確定縮寫字，請勿使用。
• 請考慮將地址驗證回覆結果傳送給使用者，讓使用者選擇使用最正確的地址。

• 請勿使用此 API 來判斷地址的包裹可遞送性。FedEx 並未針對所有的有效地址提供遞送服務。FedEx 不會遞送至郵政信箱 (除非透過 FedEx Ground® Economy (先前稱為 FedEx SmartPost^®))。
• 已解析地址回傳的資訊僅供參考使用。
• 您可以在單一請求中檢查最多 100 個地址。
• 必填欄位數量下限依國家/地區而有所不同。

  例如，若為美國地址，則至少必須填寫一個地址行，以及郵遞區號或城市和州代碼，但若為澳洲 (澳洲地址格式) 地址，則可省略州代碼，甚至不必提供郵遞區號。

• 地址解析結果可能會因國家/地區而異。

注意：地址驗證 API 可能不適用於部分國家/地區。請參閱支援地址驗證 API 的國家/地區章節。