TomTom POIs搜索API返回结果总数异常问题咨询

问题根源与修正方案 #

1. 无地理范围约束导致抽样统计 #

TomTom POI搜索API仅指定countrySet=US但未添加具体地理范围（如经纬度+radius、bbox或城市/州参数）时，为保证性能会采用抽样估算返回匹配总数，而非遍历全量POI。这就是相同请求的totalResults在90-100间波动的原因——每次抽样样本不同，统计结果自然随机。

2. relatedPois=all参数干扰结果准确性 #

设置relatedPois=all会让API返回与搜索词相关的POI（如同类汽修店），而非严格匹配"Firestone Complete Auto Care"的门店。这不仅混入非目标结果，还会加剧总数统计的随机性，因为相关POI的匹配逻辑存在模糊性。

修正操作 #

• 添加明确地理范围：若要获取美国全量Firestone门店，建议分区域搜索（按州、城市，或用bbox边界框），避免跨国家的无约束搜索。例如添加lat=37.7749&lon=-122.4194&radius=100000指定旧金山周边100公里范围，API会准确统计该区域内的匹配POI。
• 移除relatedPois=all参数：若仅需精准匹配目标门店，删除该参数，确保结果仅包含严格符合搜索词的POI。
• 指定limit参数：虽然不影响总数统计，但如需单页获取更多结果，可设置limit=100（API允许的最大单页返回数），结合offset分页获取全量结果。

修正后的请求示例 #

https://api.tomtom.com/search/2/poiSearch/Firestone%20Complete%20Auto%20Care.json?countrySet=US&view=Unified&key=[API_KEY]&offset=10&limit=100&lat=37.7749&lon=-122.4194&radius=50000

内容的提问来源于stack exchange，提问作者Nicolás Slimmens