Google Maps Places API 50km半径限制未生效？该行为是否正常？

结论 #

这种行为是API的正常预期，并非文档矛盾或功能异常。

原因说明 #

关于Google Maps Places API Autocomplete接口的radius和strictBounds参数，实际行为有这些细节需要注意：

• radius的50km上限是自动截断，而非绝对过滤：当传入超过50km的半径值时，API会自动将其调整为50km，但这个参数只是告诉API“优先考虑该范围内的结果”，不是强制只返回该范围内的内容。
• strictBounds=true不保证100%范围限制：这个参数的作用是让API优先返回指定区域内的匹配项，但如果该范围内没有足够多符合关键词的结果，API会放宽限制，返回区域外的相关结果，避免用户得到空结果。
• 关键词的通用性影响结果：你测试用的“Jean Jaurès”是法国很常见的街道名，若50km范围内匹配数量不足，API就会返回其他地区的同名地址。

处理建议 #

如果需要严格确保结果在指定范围内，可以这么做：

• 在拿到Autocomplete的预测结果后，调用Place Details API获取每个结果的坐标，自行计算与中心点的距离，手动过滤掉超过50km的结果。
• 搭配components参数，指定国家、城市等行政区域，进一步缩小搜索范围，提升限制的有效性。

内容的提问来源于stack exchange，提问作者phdezann