怎么调用 Bing 地图 关键词搜索 API?
search使用 platform="bing_maps"、action="search" 调用“关键词搜索”能力;返回列表,默认 20 条、单次最多 30 条,主要包含 rank、place_id、name、url、category、address 等 18 个字段。
Bing 地图 search 的参数分别是什么意思?
keyword必填- 在地图上搜什么,商家名或品类(如 coffee、pizza)。
language可选- 结果语言,两位语言代码(如 en、de)。
latitude可选- 地图中心纬度(-90 到 90),和 longitude 一起给;不给按 Bing 的默认位置,结果可能不在你要的城市。
Microsoft 文档说明 Bing 地图本地搜索按查询词加用户位置、矩形或圆形范围,返回该位置周围的商家实体;该官方接口已对免费账户退役,且只支持美国商家。这里只确认 Bing 地图按地图位置搜商家;本接口的 latitude、longitude 是 EveryInfra 定义的地图中心,不是那个官方接口,也不受它的地区限制。官方来源:Microsoft Learn:Bing 地图本地搜索按位置返回商家来源核查:
longitude可选- 地图中心经度(-180 到 180),和 latitude 一起给。
page可选- 第几页,从 1 开始,每页 limit 个,最多 20 页。
Bing 地图 返回字段与含义(9)
- rank
- 该商家在这次搜索结果里的名次,从 1 开始。
- place_id
- Bing 地图的商家 ID(如 YNF9439D454244F274),在 Bing 地图链接里用来定位这个商家。
- lat
- 纬度。
- lng
- 经度。
- rating
- 评分,多半来自第三方点评站(见 rating_source),按那家的分制。
- review_count
- 评分来源站上的点评数。
- rating_source
- 评分和点评数来自哪家点评站(如 Yelp、TripAdvisor);Bing 自己不打分。
- open_state
- 搜索时的营业状态原文(如 Open、Closed),按搜索那一刻和商家当地时间。
- hours_text
- 营业时间提示原文(如 Open until 8 PM);Bing 没给就不出现。