高德地图 (Amap)
本技能使用高德地图 Web 服务 API 提供地理位置服务。
使用方式
使用前必须在高德开放平台申请 Web 服务 API Key,并设置为环境变量 AMAP_KEY:
export AMAP_KEY="你的Web服务API Key"
Clawdbot 会自动读取这个环境变量来调用 API。
适用场景
当用户提出以下类型的请求时,应优先使用本技能:
- "帮我查一下[城市]的天气"
- "搜索[地点]附近的[东西]"
- "查找[关键词]的位置"
- "从[A]到[B]怎么走?"
- "查询[地址]的经纬度"
- "这个坐标[经度,纬度]是哪里?"
主要能力
- 天气查询:查询指定城市的实时天气或天气预报。注意:API 需要城市的 adcode;如果不知道 adcode,可先通过行政区划查询功能获取。
查询实时天气:
curl "https://restapi.amap.com/v3/weather/weatherInfo?key=$AMAP_KEY&city=[城市adcode]&extensions=base"
查询天气预报:
curl "https://restapi.amap.com/v3/weather/weatherInfo?key=$AMAP_KEY&city=[城市adcode]&extensions=all"
- 地点搜索 (POI):根据关键字在指定城市搜索地点信息。
curl "https://restapi.amap.com/v3/place/text?key=$AMAP_KEY&keywords=[关键词]&city=[城市]"
- 驾车路径规划:规划两个地点之间的驾车路线。注意:API 需要起终点的经纬度坐标;如果用户提供的是地址,需要先通过地理编码功能将地址转换为坐标。
curl "https://restapi.amap.com/v3/direction/driving?key=$AMAP_KEY&origin=[起点经纬度]&destination=[终点经纬度]"
- 地理编码 (地址 → 坐标):将结构化的地址信息转换为经纬度坐标。
curl "https://restapi.amap.com/v3/geocode/geo?key=$AMAP_KEY&address=[地址]"
- 逆地理编码 (坐标 → 地址):将经纬度坐标转换为结构化的地址信息。
curl "https://restapi.amap.com/v3/geocode/regeo?key=$AMAP_KEY&location=[经纬度]"
- 行政区划查询 (获取 adcode):查询省、市、区、街道的行政区划信息,包括 adcode 和边界。
curl "https://restapi.amap.com/v3/config/district?key=$AMAP_KEY&keywords=[关键词]&subdistrict=0"
限制
资料未提供除需申请 API Key 并设置环境变量 AMAP_KEY 之外的其他限制或收费信息。