Google地址验证API调用与官网演示USPS数据不一致问题

我们使用Google Address Validation API的v1:validateAddress端点，传入的输入参数为：

{"address": { "addressLines": ["8418 N Overland Ctt, Kansas City, MO 64154"],"regionCode": "US"},"enableUspsCass": true}

官网交互式演示工具的响应 #

官网演示返回的响应里，uspsData下的standardizedAddress包含拆分的独立字段，并且通过USPS自动将地址中的"Ctt"修正为"CT"：

"uspsData": {
"standardizedAddress": {
"firstAddressLine": "8418 N OVERLAND CT",
"city": "KANSAS CITY",
"state": "MO",
"zipCode": "64154"
},
...
}

C#客户端调用的响应 #

我们采用NuGet包**Google.Apis.AddressValidation.v1（版本1.57.0.3294）或Google.Maps.AddressValidation.V1（gRPC客户端）**调用API时，返回的响应存在两处明显不一致：

"uspsData": {
"standardizedAddress": {
"firstAddressLine": "8418 N OVERLAND CTT, KANSAS CITY, MO 64154"
},
"dpvFootnote": "A1",
"carrierRoute": "R081",
"cassProcessed": true
}

具体差异 #

• 官网演示中USPS标准化地址的city、state、zipCode为独立属性，但C#客户端返回的响应中这些字段缺失，所有地址信息被合并到firstAddressLine中；
• 官网演示中地址里的"Ctt"被自动修正为"CT"，但C#客户端返回的地址仍保留"CTT"，即使已设置enableUspsCass: true。

内容的提问来源于stack exchange，提问作者Baljinder Singh Sandhu