如何限制Google Places Autocomplete仅返回住宅类地址？

Google Places Autocomplete目前没有提供直接指定“住宅类地址”的官方类型参数，但可以通过类型组合+前端事后过滤的方式实现近似需求，具体方案如下：

1. 基础配置：缩小初始建议范围 #

先将Autocomplete的类型设置为['address']，这会过滤掉商家、景点等非地址类结果，只返回结构化地址：

const autocomplete = new google.maps.places.Autocomplete(document.getElementById('address-input'), {
  types: ['address'],
  // 可选：添加国家/地区限制，进一步缩小范围
  componentRestrictions: { country: 'cn' }
});

2. 事后过滤：校验选中地址的类型 #

利用place_changed事件获取选中地点的详情，检查其types字段是否包含住宅相关标识。常见的住宅类类型包括：residential、house、apartment、condominium：

autocomplete.addListener('place_changed', () => {
  const place = autocomplete.getPlace();
  const input = document.getElementById('address-input');
  
  // 检查是否匹配住宅类类型
  const validResidentialTypes = ['residential', 'house', 'apartment', 'condominium'];
  const isResidential = place.types.some(type => validResidentialTypes.includes(type));
  
  if (!isResidential) {
    // 清空输入并提示用户
    input.value = '';
    alert('请选择住宅类地址（如家庭住址、公寓、住宅大楼等）');
    return;
  }
  
  // 这里处理合法的住宅地址
  console.log('选中的住宅地址：', place.formatted_address);
});

3. 补充优化：关键词辅助判断 #

部分住宅地址的types可能未明确标注住宅类型，可结合formatted_address中的关键词辅助校验，比如检查是否包含“公寓”、“小区”、“住宅”、“House”、“Apartment”等：

const addressKeywords = ['公寓', '小区', '住宅', 'House', 'Apartment', 'Condo'];
const hasResidentialKeyword = addressKeywords.some(keyword => 
  place.formatted_address.includes(keyword)
);

// 组合类型校验和关键词校验
if (!isResidential && !hasResidentialKeyword) {
  // 执行提示逻辑
}

局限性说明 #

• 初始Autocomplete建议仍可能包含非住宅地址（如写字楼地址），但通过事后过滤可确保最终选中的是符合要求的地址；
• 部分地区的地址类型标注可能不够精准，需要根据目标用户所在区域调整校验的类型和关键词。

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