Google Maps Places搜索框自动补全失效技术求助

这种突然罢工的情况真的闹心，我之前维护的项目也碰到过类似的Places API异常，咱们一步步拆解问题，找出根源：

最可能的几个原因及排查步骤 #

1. API密钥的权限/配额出问题了 #

这是最常见的“突然失效”原因，先去Google Cloud Console查这几点：

• 确认Places API是启用状态（别被误关了）；
• 看「配额」页面，检查Autocomplete - GetQueryPredictions的调用量有没有超过限额，有没有触发限流；
• 检查计费状态：如果是免费额度用完了，或者账单有逾期，API会被限制返回精简结果甚至无结果。

2. 自动补全的配置参数被误改 #

如果最近调整过代码里的AutocompleteOptions，可能是参数设置太严格导致过滤掉了结果：

• 检查types字段：比如如果设成了['country']，那输入城市只会返回国家（就像你碰到的Kraków只返回Poland）；建议用['geocode']或者['establishment']，根据你的需求调整；
• 检查componentRestrictions：是不是不小心把国家限制错了，或者叠加了其他不必要的限制；
• 检查location和radius：如果设置了过小的搜索半径，可能会过滤掉目标地点。

举个正确的配置示例：

const autocomplete = new google.maps.places.Autocomplete(document.getElementById('your-input'), {
  types: ['geocode'],
  componentRestrictions: { country: 'pl' },
  fields: ['formatted_address', 'name', 'geometry'] // 明确指定需要返回的字段，避免冗余
});

3. 直接测试API请求，排除前端解析问题 #

手动构造请求在浏览器地址栏访问（替换成你的API密钥）：

https://maps.googleapis.com/maps/api/place/js/AutocompletionService.GetQueryPredictions?input=Kraków&key=YOUR_API_KEY

• 如果返回的predictions数组里只有Poland，那说明API本身返回的就是这个，问题出在API配置或参数；
• 如果返回正常有Kraków的条目，那就是前端代码解析响应的时候出了问题，比如之前的字段路径被修改，或者事件监听逻辑有bug。

4. SDK版本兼容性问题 #

Google Maps JS SDK的每周更新版（默认v=weekly）偶尔会有兼容性bug，试试指定稳定版本：

<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&libraries=places&v=3.54"></script>

5. 密钥的访问限制异常 #

如果你的API密钥设置了HTTP referrer限制或IP限制，检查：

• 域名有没有变更，不在允许的referrer列表里；
• 服务器/客户端IP有没有变化，超出了IP白名单范围。

针对你碰到的「输入Kraków只返回Poland」的特定情况 #

很大概率是types参数设置成了['country']或者'(regions)'且范围配置不对，导致API只返回国家级别结果。先检查代码里的Autocomplete初始化配置，把types改成['geocode']再测试。

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