如何结合商家名称与地址，通过Google Places API Text Search匹配GMSPlace？

核心问题 #

使用Google Places Text Search接口精准匹配商家名称+坐标时返回空结果，但通用关键词查询正常，说明问题出在查询词构造或搜索参数配置上，而非API权限或基础功能问题。

具体解决办法 #

1. 优化文本查询词构造 #

• 处理特殊字符：商家名称中的&等特殊符号可能被API解析为语法符号，替换为英文拼写（比如P&M改为P and M）后重试
• 精准组合查询：不要只传商家名称，补充核心地址片段（如城市名+国家），比如用"P&M Photo Media Luzern Switzerland"替代纯名称，减少歧义
• 精简关键词：如果名称中包含非核心后缀（如“Media”），尝试临时删除后测试，避免API因关键词过多过滤结果

2. 调整位置搜索参数 #

• 替换locationBias为locationRestriction：locationBias仅偏向该区域搜索，而locationRestriction会强制只在指定范围内返回结果，更适合精准匹配：

  request.locationRestriction = GMSPlaceCircularLocationOption(location, 1000.0)
  

• 扩大搜索半径：从500米调整为1000-2000米，确保目标地点在搜索范围内

3. 改用更适合精准匹配的API接口 #

Text Search更适合模糊/泛搜索，精准匹配单个地点推荐用Find Place from Query接口，示例代码调整如下：

func findExactPlace(query: String, location: CLLocationCoordinate2D) {
    let properties = [GMSPlaceProperty.name, GMSPlaceProperty.placeID, GMSPlaceProperty.openingHours, GMSPlaceProperty.website].map { $0.rawValue }
    let request = GMSPlaceFindPlaceRequest(textQuery: query, placeProperties: properties)
    request.locationBias = GMSPlaceCircularLocationOption(location, 1000.0)
    
    GMSPlacesClient.shared().findPlace(with: request) { [weak self] result, error in
        guard let self = self else { return }
        if let error = error {
            DispatchQueue.main.async { self.errorMessage = error.localizedDescription }
            return
        }
        if let place = result?.place {
            DispatchQueue.main.async {
                self.placeResult = place
                self.placeResults = [place]
            }
        }
    }
}

另外，也可以尝试反向地理编码：先通过MKMapItem的坐标调用Google Reverse Geocoding API获取对应Place ID，再用Place Details API拉取营业时间等详情。

4. 排查API日志与参数 #

• 登录Google Cloud Console查看Places API的请求日志，确认实际发送的查询词、位置参数是否符合预期
• 在代码中增加空结果的提示逻辑，便于调试时快速定位问题

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