如何在Next.js中通过react-places-autocomplete限制Google Places仅显示住宅地址？

可以通过配置Google Places API参数+前端结果过滤的方式实现需求，具体操作如下：

1. 配置searchOptions添加类型限制 #

react-places-autocomplete的searchOptions会直接透传给Google Places Autocomplete API，添加types: ['address']参数，可让API优先返回结构化地址结果，排除大部分商家、兴趣点等非住宅内容：

<PlacesAutocomplete
  value={searchValue}
  onChange={handleChange}
  searchOptions={{
    componentRestrictions: { country: 'uk' },
    types: ['address'] // 限制返回结果为地址类型
  }}
  debounce={500}
>
  {({ getInputProps, suggestions, loading }) => (
    <Autocomplete
      disablePortal
      blurOnSelect
      loading={loading}
      loadingText='Loading...'
      options={suggestions.map((x) => x.description)}
      sx={{ width }}
      onChange={handleOnSelect}
      value={address}
      renderInput={(params) => <TextField {...getInputProps({ placeholder: 'Address...' })} {...params} label="Search Address" />}
    />
  )}
</PlacesAutocomplete>

2. 可选：前端过滤增强准确性 #

少数情况下，部分带地址属性的兴趣点可能仍会出现在结果中，可通过过滤suggestion的types字段，只保留住宅相关的地址类型：

<PlacesAutocomplete
  value={searchValue}
  onChange={handleChange}
  searchOptions={{
    componentRestrictions: { country: 'uk' },
    types: ['address']
  }}
  debounce={500}
>
  {({ getInputProps, suggestions, loading }) => {
    // 定义允许的住宅相关地址类型
    const allowedAddressTypes = ['street_address', 'premise', 'subpremise', 'neighborhood', 'route'];
    // 过滤仅保留符合类型的结果
    const filteredSuggestions = suggestions.filter(suggestion => 
      suggestion.types.some(type => allowedAddressTypes.includes(type))
    );

    return (
      <Autocomplete
        disablePortal
        blurOnSelect
        loading={loading}
        loadingText='Loading...'
        options={filteredSuggestions.map((x) => x.description)}
        sx={{ width }}
        onChange={handleOnSelect}
        value={address}
        renderInput={(params) => <TextField {...getInputProps({ placeholder: 'Address...' })} {...params} label="Search Address" />}
      />
    )
  }}
</PlacesAutocomplete>

关键说明 #

• types: ['address']是Google Places API官方参数，用于限定返回结果为地址类条目；
• 每个suggestion对象的types字段对应Google Place的类型标签，可根据需求调整allowedAddressTypes中的值，匹配更严格或宽泛的住宅地址类型；
• 该方案无需额外依赖，仅通过现有API参数和前端逻辑即可实现需求。

内容的提问来源于stack exchange，提问作者J. Whitehead