简介
地址验证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尝试对输入地址进行规范化。其中可能包括将Street和Parkway等常见道路标识符替换为它们的标准缩写(如ST和PKWY),以及重新排列地址的各个部分。如果输入的地址无法进行规范化,则返回的解析后地址将为输入地址。非地址值会被丢弃。
- 第二步,API尝试对规范化后的地址进行标准化,方法是找到接近用户所需地址的可能或实际地址。如果标准化失败,则返回的解析后地址将为规范化后的输入地址。请参考返回的元素,帮助判断所提交的地址中存在的问题。
- 还将返回规范化后地址的某些元素。如果标准化成功,则返回的解析后地址将为实际地址。此时,还将返回标准化后地址的各种其他元素以及该地址是如何从规范化后地址衍生而来的。
地址验证API返回值
如果返回的地址包含具有下列值的以下属性,则该地址为有效地址:
- 地址状态为“已标准化”
- 已解析地址属性为True
- “递送点有效(DPV)”为True
- “内插地址”为False
如果上述内容未列出,则使用其他属性来判断地址值可能存在的问题。
有关地址属性的详细信息,请参见地址属性。
如果输出返回的客户消息为INTERPOLATED.STREET.ADDRESS,则该地址可能为无效地址。有关客户消息代码的详细信息,请参见客户消息的元素说明。
注释
地址验证API会随每个经验证并返回的地址一起返回注释。注释向您提供有关缺失内容的信息(如有)以及为送达实际地址而对输入地址所做的更改。
地址分类
地址验证API使用参考数据来确定指定地址的分类。职能地址的分类计算与地址验证流程无关,而是基于操作人员的反馈,商业数据源仅作确认用途。
地址验证API只有四种可能的地址分类:未知、公司、住宅和混合。所有地址最初都分类为“未知”,并在地址验证业务规则判断其分类应进行更改之前一直保持该分类。仅当某个地点是基于多租户的地址且同时包含公司和住宅单元时,才会被划归到“混合”分类。
注意:FedEx Express服务为收件人地址提供一个额外地址行(地址行3)。这一额外地址信息提供了更完整且准确的位置详细信息,有助于您获得准确地址。
实际地址分类如下:
公司地址
公司地址是用来指定您的主要业务地点的地址。它通常是您公司运营的地方,但并不一定总是如此。
公司地址是公司办公场所的正式位置。它既可以是某人的家庭住址,也可以是价值数百万美元的园区(例如大型科技公司所青睐的那些园区),还可以是介于两者之间的各类地点。
居住地址
对于美国境内寄往家中或私人住宅(包括在家办公地点)的货件,将收取住宅区递送费。可使用 FedEx Home Delivery 通过 FedEx Ground 进行住宅区递送,将在个 1 工作日(具体根据距离目的地的远近)送达。
例如:
- 教区长住所
- 修道院
- 牧师住所
- 多单元住宅,例如
- 公寓大楼
- 共管公寓
- 大学宿舍
- 销售和/或分销产品的住宅
使用地址验证API的提示
使用地址验证API有下列一些有用提示:
- 使用正确的空格:确保空格的位置正确,避免使用不必要的空格。
- 使用正确的拼写:避免任何拼写和印刷排版错误。同时请确保正确使用数字零(0)和字母O。
- 避免使用特殊字符:请不要使用地址所不需要的特殊字符,如缩写后面的句号(Ave与Ave.)。
- 提供额外地址和街道信息:提供额外地址信息可以提高地址结果的准确性。
- 建筑物或门牌号 - 1、1A、1½、One
- 街道名称 - Main、George Washington、42nd
- 街道后缀 - 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个地址。
- 至少要填写的必填字段因国家/地区而异。
例如,美国地址要求至少填写一行地址以及邮政编码或城市及州代码,而AUS(澳大利亚地址格式)地址可以省略州代码,甚至邮政编码也可以省略。
- 地址解析结果因国家/地区而异。
注意:地址验证API可能并不适用于所有国家/地区。请参见支持地址验证API的国家/地区部分。
JSON API Collection
Response