Flutter集成Google Places API：地址Autocomplete区域限制异常求助

API 探路者

2026-8-4

Google Places Autocomplete 严格区域限定问题排查与解决

已实现Google Places API的Autocomplete搜索，结果基本能限定在指定区域，但偶尔会出现超出半径的无关结果。添加strictbounds参数后，结合types: 'address'会导致无结果或仅单个结果；移除types则仅显示POI，无法满足仅需地址的需求。

核心原因分析

strictbounds会强制所有结果必须完全落在指定的bounds范围内，而types: 'address'仅匹配精确的街道级地址，两者结合时，若bounds内的精确街道地址数据较少，就会出现结果极少的情况。同时，radius与bounds同时使用可能存在逻辑冲突（API优先采用bounds，radius会被忽略）。

具体解决方法

替换types参数为geocode
geocode类型包含了address的所有结果，同时覆盖了更广泛的地理编码数据（如行政区、街道片区等），在strictbounds限制下能返回更多符合区域要求的地址类结果。
移除冗余的radius参数
当同时指定bounds和radius时，API会优先使用bounds范围，radius参数无效，移除后可避免参数干扰。
验证location和bounds参数格式
确保location是"纬度,经度"的字符串格式（如波兹南的坐标"52.4064,16.9252"），bounds的西南/东北坐标顺序正确，范围覆盖目标城市及周边必要区域。
使用当地语言关键词搜索
因language设为pl，使用波兰语地址关键词（如ulica开头的街道名）能提升匹配精度，获得更多符合要求的结果。

调整后的请求代码示例

Uri uri = Uri.https("maps.googleapis.com", "maps/api/place/autocomplete/json", {
  "input": query,
  "location": "52.4064,16.9252", // 明确波兹南中心坐标
  "language": "pl",
  "bounds": "52.22,15.33|53.13,17.36",
  "strictbounds": "true",
  "types": "geocode", // 替换为geocode扩大匹配范围
  "sessiontoken": _sessionToken,
  "key": apiKey,
});