Google Maps Places API附近搜索结果不一致问题及解决方法

问题现象 #

使用Google Maps Places API的附近搜索功能时，存在增大搜索半径后结果数量不增反减的异常情况：

• 示例场景：搜索4000米范围内的“古巴菜”返回4条结果，将半径扩大至6000米后仅返回3条结果，新结果包含更远地点，但丢失了原小半径内的部分结果。
• 原始请求示例：

val uri = "https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=${currentLocation.latitude},${currentLocation.longitude}&fields=geometry, name, vicinity, price_level, rating&name=$cuisineType&radius=$distance&rating=$rating&maxprice=$price&key=(my key)"

临时解决方案 #

通过添加rankBy=distance参数并移除radius参数，可返回最多20条从坐标点由近及远排序的结果，能覆盖更多符合条件的地点。

原因解析 #

• 排序逻辑差异：未指定rankBy时，API默认按相关性排序而非距离。扩大半径后，更大范围内的高相关性结果会挤占原小半径内低相关性结果的位置，导致原部分结果被挤出单次返回的20条结果上限。
• 分页限制影响：Google Places API单次请求最多返回20条结果，超出结果需通过pagetoken分页获取。扩大半径后，符合条件的总结果数可能增加，但原小半径内的部分结果因排序靠后，无法出现在首次返回的结果页中。
• 相关性动态调整：API的相关性评分结合了地点知名度、用户评价、匹配度等多维度因素，扩大搜索范围后，新纳入的高相关性地点会拉低原小半径内部分地点的排序优先级，使其无法进入首次返回的结果列表。

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