地理编码API请求Components Filter失效及结果异常问题咨询

问题场景 #

请求API：

https://maps.googleapis.com/maps/api/geocode/json?address=Sedanstraße+9&components=locality:Berlin&region=de&language=de&key=..

返回结果：

{"results" : [],"status" : "ZERO_RESULTS"}

已知信息：

• 德国柏林确实存在Sedanstraße 9地址，且两个月前该请求可正常返回（有JUnit测试佐证）
• 将locality改为Frankfurt或Köln时，能得到对应城市的正确地址结果
• 移除locality参数后，API返回Lüdenscheid的Sedanstraße 9地址，而非德国所有同名地址的多结果集

核心疑问与解答 #

1. 为何柏林地址请求返回ZERO_RESULTS？ #

• 数据更新导致地址状态变更：Google Geocoding API的底层地址数据库会定期迭代更新，可能是柏林的Sedanstraße 9在最近的更新中被标记为无效、移除，或是官方地址标识发生了调整（比如街道名称标准化更改、门牌号归属的行政区域调整）。
• components参数匹配逻辑调整：使用locality:Berlin时，API会严格限定在柏林的行政边界内匹配地址。如果后台数据中该地址的行政区域关联出现错误（比如被误映射到其他区域），就会导致精准匹配失败。而Frankfurt和Köln的同地址数据未受此次更新影响，所以能正常匹配。

2. 移除locality后为何只返回Lüdenscheid的地址？ #

Google Geocoding API默认会优先返回匹配度最高的单一结果，而非所有可能的同名地址：

• Lüdenscheid的Sedanstraße 9可能因为数据完整性更高、用户查询频次更多、行政层级关联更明确等因素，被算法判定为最符合请求的结果。
• 只有当多个地址的匹配权重非常接近，算法无法明确优先级时，才会返回多结果集。当前场景下Lüdenscheid的地址优先级远高于其他城市的同名地址，因此只返回这一条结果。

内容的提问来源于stack exchange，提问作者S.Baier