腾讯位置服务 MCP 接入
在AI应用场景中,与真实世界取得连接,进行个性化推荐(推荐餐厅、酒店、活动、景区等),行程规划,获取实时出行信息等,让AI服务于人们现实生活,是很多企业与开发者迫切希望实现的。
对此腾讯位置服务推出基于MCP协议的位置服务开发接口,助开发者们快速实现基于地理位置的AI服务。
环境变量
创建APIKey 腾讯位置服务MCP 依赖WebServiceAPI构建,因此需要先创建key,并开启WebServiceAPI功能,取得相关接口调用配额后方可使用,
具体方法可参见: https://lbs.qq.com/service/webService/webServiceGuide/overview
- 需要将 API_KEY 环境变量配置为您在腾讯位置服务创建的 API Key。
使用说明
腾讯位置服务MCP Server依赖地图WebServiceAPI构建,因此受WebServiceAPI接口本身限制,需要具备以下相应接口的调用权限和配额方可使用。 点击查看:WebServiceAPI调用限制说明、WebServiceAPI入门指南
在用户与智能体对话的过程中,智能体根据对话内容判断是否需要调用外部工具(MCPServer)获取信息来解答用户问题,MCPServer根据智能体提供的参数,会调用对应的WebServiceAPI接口获取结果,智能体理解其中内容,并加以整理最后回复给用户。
智能体可能在这一过程中调用多个MCPServer中的工具接口(可能对应多个WebServiceAPI接口),因此相关接口都需要具备调用权限和配额。
应用示例
城市/区域搜索 根据指定的市、区范围(名称或区域代码)、地点关键词,搜索符合的地点信息。 应用场景:如搜索北京的景点、酒店、购物场景,搜索某个地方的详细地址等。
(注:不同大模型因其推理、计算能力不同,实际应用效果可能不同,本示例仅供参考)
🗺️ 功能清单
工具标识 | 功能描述 | 核心参数 |
---|---|---|
geocoder | 提供由文字地址到经纬度的转换能力,并返回结构化的省市区地址信息 | address (必填,包含省市区信息的格式化地址或包含城市名的地点关键词) |
placeSuggestion | 根据关键词和城市搜索地点信息,返回地点名称、地址、经纬度、分类等 | keyword (必填,关键词或地点名称),region (选填,搜索城市) |
placeSearchNearby | 搜索指定中心点经纬度周边的地点信息,返回地点名称、地址、经纬度、分类等 | location (必填,搜索中心点经纬度,格式 lat,lng ),keyword (必填,搜索关键词) |
directionDriving | 规划驾车路线,支持参考路况、少收费、不走高速等偏好,返回路线预估用时、距离、过路费等信息 | from (必填,起点经纬度,格式 lat,lng ),to (必填,终点经纬度,格式 lat,lng ) |
placeAlongby | 在路线沿途搜索符合条件的地点,返回地点名称、地址、经纬度、分类等 | polyline (必填,路线经纬度点串),keyword (必填,搜索关键词) |
placeDetail | 根据 POI ID 获取 POI 详情信息,包括名称、地址、经纬度、分类等 | id (必填,POI ID) |
matrix | 批量计算多个起终点之间的路面距离(导航距离) | from (必填,起点经纬度,格式 lat,lng ),to (必填,终点经纬度,格式 lat,lng ),mode (必填,通行方式:driving 、walking 、bicycling ) |
reverseGeocoder | 输入经纬度坐标,返回语义化地址、省市区信息等 | location (必填,经纬度坐标,格式 lat,lng ) |
ipLocation | 通过 IP 地址获取当前所在省、市、区信息 | ip (必填,IP 地址,IPv4 或 IPv6) |
weather | 查询行政区划代码对应的城市实时天气或预报天气 | adcode (必填,行政区划代码),type (选填,查询类型:now 或 future ,默认为 now ) |
directionWalking | 规划步行路线,返回路线总距离、预估用时等信息 | from (必填,起点经纬度,格式 lat,lng ),to (必填,终点经纬度,格式 lat,lng ) |
directionBicycling | 规划自行车骑行路线,返回路线总距离、预估用时等信息 | from (必填,起点经纬度,格式 lat,lng ),to (必填,终点经纬度,格式 lat,lng ) |
directionTransit | 规划公共交通路线,返回多组乘坐方案及详细信息 | from (必填,起点经纬度,格式 lat,lng ),to (必填,终点经纬度,格式 lat,lng ) |
futureDrivingDirection | 根据未来出发时间规划驾车路线,考虑预测路况,返回预估用时、总距离等信息 | departure_time (必填,出发时间,时间戳格式),from (必填,起点经纬度,格式 lat,lng ),to (必填,终点经纬度,格式 lat,lng ) |
waypointOrder | 对途经点进行最顺路排序并规划驾车路线,支持最多 16 个途经点 | from (必填,起点经纬度,格式 lat,lng ),to (必填,终点经纬度,格式 lat,lng ),waypoints (选填,途经点经纬度,最多 16 个,格式 lat1,lng1;lat2,lng2... ),need_waypoint_order (选填,是否需要对途经点排序,值为 true 或 false ) |