怎么调用 DuckDuckGo 地图 关键词搜索 API?
search使用 platform="duckduckgo_maps"、action="search" 调用“关键词搜索”能力;返回列表,默认 20 条、单次最多 50 条,主要包含 rank、name、apple_maps_id、yelp_id、category、address 等 24 个字段。
DuckDuckGo 地图 search 的参数分别是什么意思?
keyword必填- 在地图上搜什么,地点名或品类(如 coffee、museum)。
DuckDuckGo 帮助页说明它和多家信息来源合作提供搜索,其中地图来自 Apple。这里只确认 DuckDuckGo 地图用的是 Apple 的地图数据,所以结果行带 Apple 地图 ID;本接口 keyword 按地点名或品类在给定地图中心周围搜,该来源不说明搜索条数、评分来源或营业时间字段。官方来源:DuckDuckGo 帮助:地图数据来自 Apple来源核查:
latitude必填- 地图中心纬度(-90 到 90),必填;结果是这个中心周围一屏里的地点。
longitude必填- 地图中心经度(-180 到 180),必填。
DuckDuckGo 地图 返回字段与含义(14)
- rank
- 该地点在这次结果里的名次,从 1 开始。
- apple_maps_id
- 这个地点的 Apple 地图 ID(纯数字),可作为 apple_maps.places 的 place_ids 读营业时间、设施等详情;没有就不出现。
- yelp_id
- 这个地点在 Yelp 上的商家短名;评分和点评摘录来自 Yelp。
- country_code
- 两位国家代码。
- timezone
- 地点所在时区(IANA 名,如 America/New_York)。
- lat
- 纬度。
- lng
- 经度。
- menu_url
- 菜单页面链接(餐饮类地点常有)。
- rating
- Yelp 评分,1–5。
- review_count
- Yelp 上的点评数。
- price
- 价位,用 $ 个数表示($ 到 $$$$);没有就不出现。
- open_state
- 搜索时的营业状态原文,按地点当地时间。
- opening_hours
- 每周营业时间,键是星期(monday…sunday),值是「开始 - 结束」原文;当天不营业的那天不出现。
- top_reviews
- 几条点评摘录(rating 评分、text 摘录、date 日期 YYYY-MM-DD),不带点评人信息。