腾讯位置服务
可用工具 （15 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
geocoder 1 个参数 需填 1 项
提供由文字地址(包含省市区信息的完整地址)到经纬度的转换能力，并同时提供结构化的省市区地址信息
必填参数：address
placeSuggestion 2 个参数 需填 1 项
根据要搜索地点的关键词和搜索的城市（城市名），搜索符合条件的地点信息， 返回包括地点名称、地址、经纬度、分类等（如搜索北京的景点、酒店、购物场景，搜索某个地方的详细地址等）
必填参数：keyword
placeSearchNearby 2 个参数 需填 2 项
附近周边搜索，输入的搜索关键词，中心点经纬度（格式lat,lng）搜索其周边符合条件的地点信息 返回包括地点名称、地址、经纬度、分类等（如搜索北京的景点、酒店、购物场景，搜索某个地方的详细地址等）
必填参数：location、keyword
directionDriving 2 个参数 需填 2 项
根据起终点经纬度，规划驾车路线，支持参考路况、少收费、不走高速等偏好，同时支持返回路线预估用时，路线距离，过路费等信息
必填参数：from、to
placeAlongby 2 个参数 需填 2 项
在路线的沿途进行搜索：输入驾车路线规划接口返回的路线ID（route_id）和搜索关键词，搜索该路线沿途符合该关键词的地点
必填参数：route_id、keyword
placeDetail 1 个参数 需填 1 项
POI详情信息,根据POI ID搜索相关信息,包括：名称、地址、经纬度、分类、省市区信息。如果查询结果为空，则返回POI ID不存在
必填参数：id
matrix 3 个参数 需填 3 项
用于批量计算多个起终点到多个终点的路面距离（或称导航距离）
必填参数：from、to、mode
reverseGeocoder 1 个参数 需填 1 项
输入经纬度坐标，返回其所在位置的语义化地址、省、市、区、乡镇、门牌号、行政区划代码、商圈、地标、道路及交叉口、河流、湖泊、桥等
必填参数：location
ipLocation 1 个参数
通过终端设备IP地址获取其当前所在省、市、区信息。如果用户不传，则置空
该工具无需必填参数，直接调用即可
weather 3 个参数
通过行政区划代码，查询对应城市的实时天气或预报天气。
该工具无需必填参数，直接调用即可
directionWalking 2 个参数 需填 2 项
根据起终点经纬度，规划步行路线，返回包括路线总距离、预估用时等
必填参数：from、to
directionBicycling 2 个参数 需填 2 项
根据起终点经纬度，规划自行车骑行路线，返回包括路线总距离、预估用时等
必填参数：from、to
directionTransit 3 个参数 需填 2 项
公共交通路线规划，根据起终点经纬度，规划公交/地铁线路乘坐方案， 支持指定出发时间（确保线路在首末车时段内），支持时间短、少换乘、少步行、地铁优先等多种偏好，为您规划多组乘坐方案， 同时返回路线总预估用时、总距离、总步行距离、票价，具体线路如何换乘（线路名、上车站、下车站名等）、首末车时间等
必填参数：from、to
futureDrivingDirection 3 个参数 需填 3 项
根据起终点经纬度、未来出发时间，规划驾车驾车路线，路线会考虑未来时间的预测路况进行规划，支持返回预估用时、总距离等信息
必填参数：from、to、departure_time
waypointOrder 4 个参数 需填 2 项
基于驾车路线规划，对输入的途经点以最顺路方式排序并规划路线，排序途经点最多16个。返回结果中的waypoints代表途经点的顺序
必填参数：from、to
服务介绍
腾讯位置服务MCP Server依赖地图WebServiceAPI构建，因此受WebServiceAPI接口本身限制，需要具备以下相应接口的调用权限和配额方可使用。
点击查看：WebServiceAPI调用限制说明、WebServiceAPI入门指南
在用户与智能体对话的过程中，智能体根据对话内容判断是否需要调用外部工具（MCPServer）获取信息来解答用户问题，MCPServer根据智能体提供的参数，会调用对应的WebServiceAPI接口获取结果，智能体理解其中内容，并加以整理最后回复给用户。
智能体可能在这一过程中调用多个MCPServer中的工具接口（可能对应多个WebServiceAPI接口），因此相关接口都需要具备调用权限和配额。
我们根据智能体的常见对话场景，在MCP Server中集成如下WebServiceAPI接口：
工具 / 接口名称 接口路径 说明
geocoder
地址解析 /ws/geocoder/v1?address=* 功能：提供由文字地址到经纬度的转换能力，并同时提供结构化的省市区地址信息
场景：询问智能体某一具体地址的经纬度时使用，常作用于获取周边搜索、路线规划所需的起终点坐标、搜索中心点坐标时使用
placeSuggestion
关键词输入提示 /ws/place/v1/suggestion 在指定城市或全国范围通过地点名称搜索时使用
reverseGeocoder
逆地址解析 /ws/geocoder/v1?location=* 提供由经纬度到文字地址及相关位置信息的转换能力
placeSearchNearby
地点搜索（周边） /ws/place/v1/search 功能：提供周边搜索能力
场景：在询问智能体在某地附近搜索相关地点时使用
placeAlongby
沿途搜索[高级] /ws/place/v1/alongby 场景：在询问智能体从某地到某地沿途相关地点时使用，在前置一般会使用到路线规划获取沿途搜索需要的路线坐标点串
placeDetail
POI详情查询 /ws/place/v1/detail 提供通过POI ID查询其基础详情信息的能力
directionDriving
驾车路线规划 /ws/direction/v1/driving 功能：根据起点、终点（及途经点），结合算路偏好规划驾车路线
场景：与智能体询问某地到某地距离、预估耗时、走哪条路，收费多少等信息时使用
waypointOrder
驾车路线规划
- 途经点智能排序 [高级参数] /ws/direction/v1/driving?waypoint_order=1 场景：当询问智能体有多个目的地要去，先去哪再去哪整体顺序最优，距离最短
futureDrivingDirection
驾车路线规划 - 未来路线规划 [高级参数] /ws/direction/v1/driving?departure_time=* 场景：当询问智能体在未来某时间点出发前往某地，驾车所需用时（本接口会参考未来预估路况进行计算，并返回结果）
directionTransit
公交路线规划 /ws/direction/v1/transit 功能：根据起终点经纬度，规划公交/地铁线路乘坐方案，支持指定出发时间（确保线路在首末车时段内），支持时间短、少换乘、少步行等多种偏好，同时返回路线总预估用时、总距离、总步行距离、票价，具体线路如何换乘（线路名、上车站、下车站名等）、首末车时间等
directionBicycling
骑行路线规划 /ws/direction/v1/bicycling 功能：根据起终点经纬度，规划自行车骑行路线，支持返回路线预估用时、总距离 等
directionWalking
步行路线规划 /ws/direction/v1/walking 功能：根据起终点经纬度，规划步行路线，支持返回路线预估用时、总距离 等
matrix
距离矩阵 驾车：/ws/distance/v1/matrix?mode=driving
步行：/ws/distance/v1/matrix?mode=walking
骑行：/ws/distance/v1/matrix?mode=bicycling 用于批量计算多个起终点到多个终点的路面距离（或称导航距离）
ipLocation
IP 定位 /ws/location/v1/ip 通过终端设备IP地址获取其当前所在地理位置
weather
天气查询 /ws/weather/v1 通过行政区划编码，查询对应城市的实时天气或预报天气
