随申行mcp服务

产品介绍

本目前支持查询坐标在上海市内的公交、地铁信息。

商务合作

1. 商务合作需求，请发送邮件至 databd@shmaas.cn 。
2. 商务合作完成后，系统会为商户配置商户id及盐值，用于请求鉴权。

发送请求

• 请求过程：连接初始化、发送业务请求
• 请求地址：https://apigtw.shmaas.net/ai-biz

连接初始化接口文档

• 请求地址: https://apigtw.shmaas.net/ai-biz/sse
• 请求方式：GET
• 返回示例：

id:ba9de9a6-2ba6-4a00-a43e-7ef941891a94
event:endpoint
data:/mcp?sessionId=ba9de9a6-2ba6-4a00-a43e-7ef941891a94

其中data:后的path及查询参数作为业务请求的path及参数，示例拼接地址：https://apigtw.shmaas.net/ai-biz/sse/mcp?sessionId=ba9de9a6-2ba6-4a00-a43e-7ef941891a94

发送业务请求接口文档

• 请求地址：与上述连接初始化接口返回的data拼接后的地址
• 请求方式：POST
• 请求参数：包含根级参数与params参数，具体如下

根级参数

参数名	类型	必填	说明	示例值
jsonrpc	string	是	JSON-RPC协议版本	"2.0"
method	string	是	调用的方法名	"tools/call"
id	string	是	请求唯一标识符	"e3f3b929-1"
params	object	是	方法参数对象	-

params 参数

参数名	类型	必填	说明	示例值
name	string	是	实际业务方法名	"findNearByTrafficBus"
arguments	object	是	业务参数	{"nearRadiusDistance":500,"cityCode":"310100","lat":"39.9042","lon":116.4074}

请求体组装参数示例

{
    "jsonrpc":"2.0",
    "method":"tools/call",
    "id":"e3f3b929-1",
    "params":{
        "name":"findNearByTrafficBus",
        "arguments":{
            "nearRadiusDistance":500,
            "cityCode":"310100",
            "lat":"39.9042",
            "lon":116.4074
        }
    }
}

请求头参数

参考开放平台接入网关（地址：https://open-web.shmaas.cn/docs/guide ），需将请求的arguments原始报文按如下工具排序，根据排序后的网关计算X-Sign：

package com.maas.ai.util;

import com.alibaba.fastjson2.JSON;

import java.util.*;

/**
 * Map排序工具类
 * 用于将Map中的参数按key的ASCII码排序，并递归处理嵌套的Map
 */
public class MapSortUtil {

    /**
     * 将Map中的参数按key的ASCII码排序，并递归处理嵌套的Map
     * @param params 参数Map
     * @return 排序后的JSON字符串
     */
    public static String sortAndConvertToJson(Map<String, Object> params) {
        Map<String, Object> sortedMap = sortMapByKey(params);
        return JSON.toJSONString(sortedMap);
    }

    /**
     * 递归排序Map，处理嵌套的Map和List
     * @param map 待排序的Map
     * @return 排序后的Map
     */
    @SuppressWarnings("unchecked")
    public static Map<String, Object> sortMapByKey(Map<String, Object> map) {
        if (map == null) {
            return null;
        }
        
        // 使用TreeMap按key的ASCII码自动排序
        Map<String, Object> sortedMap = new TreeMap<>();
        
        for (Map.Entry<String, Object> entry : map.entrySet()) {
            Object value = entry.getValue();
            
            if (value instanceof Map) {
                // 递归处理嵌套的Map
                sortedMap.put(entry.getKey(), sortMapByKey((Map<String, Object>) value));
            } else if (value instanceof List) {
                // 处理List中可能嵌套的Map
                List<?> list = (List<?>) value;
                List<Object> processedList = new ArrayList<>();
                for (Object item : list) {
                    if (item instanceof Map) {
                        processedList.add(sortMapByKey((Map<String, Object>) item));
                    } else {
                        processedList.add(item);
                    }
                }
                sortedMap.put(entry.getKey(), processedList);
            } else {
                sortedMap.put(entry.getKey(), value);
            }
        }
        
        return sortedMap;
    }
}

能力介绍

现有MCP协议功能

目前提供2款MCP协议的功能，具体信息如下：

根据经纬度及距离查询附近公交

params.name=findNearByTrafficBus

业务参数说明

请求参数

名称	参数类型	描述	是否必须	说明
cityCode	string	城市编码	是	默认310100；
isGetStopArrive	string	是否获取到站信息	否	1-获取，其他不获取；默认不获取；
lon	string	经度	是
lat	string	纬度	是
nearRadiusDistance	string	半径（单位：米）	否	默认1000；
coordinateType	string	坐标类型	否	1：WGS-84，2：GC-J02，默认WGS-84；

响应参数

名称	参数类型	描述	说明
retCode	int	响应编码	0代表调用成功
retMsg	string	响应信息
- nearByTrafficLineStop	object	公交地铁线路的站点信息
indexId	int	数据唯一标识
lineId	string	线路编号
lineName	string	线路名称
stopId	string	站点编号
stopName	string	站点名称
startStopName	string	线路起点站名称
endStopName	string	线路终点站名称
startEarlyLateTime	string	最早始发时间-最晚始发时间	格式hh:mm；
endEarlyLateTime	string	最早到站时间-最晚到站时间	格式hh:mm；
upDown	string	上下行	0-上行，1-下行；
type	string	公共交通类型	1-公交，2-地铁，3-轮渡；
- point	object	当前站点经纬度
lon	string	经度
lat	string	纬度
- sai	object	车辆到站信息
currentBusDistance	string	最近一辆车距离本站距离（单位：米）
currentBusArriveTime	string	最近一辆车预计多久后到达（单位：分钟）
currentBusComfort	string	最近一辆车拥挤程度	0-未知，1-舒适，2-较舒适，3-拥挤
upDown	string	上下行	0-上行，1-下行；
currentBusStopCount	string	最近一辆车距离当前还有几站
currentLicensePlate	string	最近一辆车车牌
currentBarrierFree	string	最近一辆车是否无障碍	bool类型，true/false；
nextBusDistance	string	下一辆车距离本站距离（单位：米）
nextBusArriveTime	string	下一辆车预计多久后到达（单位：分钟）
nextBusStopCount	string	下一辆车距离当前还有几站
nextLicensePlate	string	下一辆车车牌
nextBarrierFree	string	下一辆车是否无障碍	bool类型，true/false；
- dispatchCarSchedule	object	车辆发车时刻表
lineId	string	线路编号
lineName	string	线路名称
direction	string	上下行	0-上行，1-下行；
scheduleCode	int	调度编码	-1-不在运营时间，0-暂无实时数据，1-等待常规发车；
scheduleMsgDefault	string	调度提示
scheduleMsgShort	string	调度提示
- dispatchCars	object	发车明细
vehicle	string	车牌号
time	string	发车时间
countdown	string	倒计时

根据经纬度及距离查询地铁信息

params.name=queryNearByMetro

业务参数说明

请求参数

名称	参数类型	描述	是否必须	说明
cityCode	string	城市编码	是	仅输入310100；
lon	string	经度	是
lat	string	纬度	是
coordinateType	int	坐标系类型	否	1-WGS-84，2-GCJ02；默认2；
nearRadiusDistance	int	半径（单位：米）	否	默认1000，最大3000；

响应参数

名称	参数类型	描述	说明
retCode	int	响应编码	0表示调用成功，其余失败；
retMsg	string	响应信息
- normalMetroList	object	普通地铁信息
indexId	int	数据库唯一id
lineNo	string	线路编号
lineName	string	线路名称
upDown	int	上下行	0-上行，1-下行；
startStopName	string	线路起点站名称
endStopName	string	线路终点站名称
startEarlyLateTime	string	首班车时间	格式hhmm；
endEarlyLateTime	string	末班车时间	格式hhmm；
priceRange	string	票价范围（单位：元）	eg：3-7；
lineType	int	线路类型	0-普通车，1-夜班车，2-临时保障车（暂无信息），3-区间车，4-大站车；
- station	object	站点信息
stopNo	string	站点编号
stopName	string	站点名称
startEarlyLateTime	string	站点首班车时间	格式hhmm；
endEarlyLateTime	string	站点末班车时间	格式hhmm；
type	int	上下客协议	0或者空表示可上下，1表示仅下；
- point	object	站点位置
lon	string	经度
lat	string	纬度
- dispatchCarSchedule	object	间隔信息
scheduleCode	int	调度编码	-1表示不在运营时间，0表示暂无实时数据，1表示数据正常；
scheduleType	int	调度类型	0表示间隔xx分钟到站，1表示xx点到站；
scheduleTime	string	调度时间
scheduleMsg	string	调度提示
scheduleMsgDefault	string	调度提示
- bigStationMetroList	object	大站地铁信息
indexId	int	数据库唯一id
lineNo	string	线路编号
lineName	string	线路名称
upDown	int	上下行	0-上行，1-下行；
startStopName	string	线路起点站名称
endStopName	string	线路终点站名称
startEarlyLateTime	string	首班车时间	格式hhmm；
endEarlyLateTime	string	末班车时间	格式hhmm；
priceRange	string	票价范围（单位：元）	eg：3-7；
lineType	int	线路类型	0-普通车，1-夜班车，2-临时保障车（暂无信息），3-区间车，4-大站车；
- station	object	站点信息
stopNo	string	站点编号
stopName	string	站点名称
startEarlyLateTime	string	站点首班车时间	格式hhmm；
endEarlyLateTime	string	站点末班车时间	格式hhmm；
type	int	上下客协议	0或者空表示可上下，1表示仅下；
- point	object	站点位置
lon	string	经度
lat	string	纬度
- dispatchCarSchedule	object	间隔信息
scheduleCode	int	调度编码	-1表示不在运营时间，0表示暂无实时数据，1表示数据正常；
scheduleType	int	调度类型	0表示间隔xx分钟到站，1表示xx点到站；
scheduleTime	string	调度时间
scheduleMsg	string	调度提示
scheduleMsgDefault	string	调度提示
- fixedStationMetroList	object	定点上下车地铁信息
indexId	int	数据库唯一id
lineNo	string	线路编号
lineName	string	线路名称
upDown	int	上下行	0-上行，1-下行；
startStopName	string	线路起点站名称
endStopName	string	线路终点站名称
startEarlyLateTime	string	首班车时间	格式hh:mm；
endEarlyLateTime	string	末班车时间	格式hh:mm；
priceRange	string	票价范围（单位：元）	eg：3-7；
lineType	int	线路类型	0-普通车，1-夜班车，2-临时保障车（暂无信息），3-区间车，4-大站车；
- station	object	站点信息
stopNo	string	站点编号
stopName	string	站点名称
startEarlyLateTime	string	站点首班车时间	格式hh:mm；
endEarlyLateTime	string	站点末班车时间	格式hh:mm；
type	int	上下客协议	0或者空表示可上下，1表示仅下；
- point	object	站点位置
lon	string	经度
lat	string	纬度
- dispatchCarSchedule	object	间隔信息
scheduleCode	int	调度编码	-1表示不在运营时间，0表示暂无实时数据，1表示数据正常；
scheduleType	int	调度类型	0表示间隔xx分钟到站，1表示xx点到站；
scheduleTime	string	调度时间
scheduleMsg	string	调度提示
scheduleMsgDefault	string	调度提示

未来规划MCP服务功能

查询轨交站点进出站客流信息

请求参数

名称	参数类型	描述	是否必须	说明
keywords	string	关键字	是	支持模糊搜索；
cityCode	string	城市标示	是	默认输入：310100；
type	string	查询类型	否	0-全部，1-只查线路，2-只查站点；默认输入：0；

响应参数

名称	参数类型	描述	说明
retCode	int	响应编码	0代表查询成功，其余失败；
retMsg	string	响应信息
- trafficStop	object	trafficStop	-
Name	string	名称
NameType	string	名称类型	0-线路，1-站点；
type	int	交通类型	1-公交；
- lineInfo	object	线路信息列表
indexId	string	数据库唯一id
lineId	string	线路编号
lineName	string	线路名称
startStopName	string	起点站名称
endStopName	string	终点站名称
upDown	int	上下行	0-上行，1-下行；
- stopLineInfo	object	站点信息列表
indexId	int	数据库唯一id
lineId	string	线路编号
lineName	string	线路名称
startStopName	string	起点站名称
endStopName	string	终点站名称
upDown	int	上下行	0-上行，1-下行；

查询停车设施运营情况

请求参数

名称	参数类型	描述	是否必须	说明
parkingId	string	停车位置唯一标识	是

响应参数

名称	参数类型	描述	说明
retCode	int	返回编码	0代表调用成功
retMsg	string	返回信息
status	string	本次API访问状态	如果成功返回1，如果失败返回0
info	string	本次API访问状态说明
- parkingpoinfo	object	parkingpoinfo
parkingId	string	停车设施唯一标识
leftBerth	string	剩余泊位
fiveMinsIn	string	5分钟进场车辆数
dayTotalIn	string	当日累计停放车辆数
turnoverRate	string	周转率
saturate	string	饱和度
statTime	string	统计时间

查询停车设施列表信息

请求参数

名称	参数类型	描述	是否必须	说明
districtId	string	区域标识代码	否	黄浦区-HP，虹口区-HK，依此类推……
businessArea	string	商圈标签	否
longitude	string	经度	否	当queryType=1，经度不允许为空；
latitude	string	纬度	否	当queryType=1，纬度不允许为空；
township	string	街镇区划名称	否	参照国家统计局上海市街镇区划
queryType	int	接口查询方式	是	1-位置查询（返回基于位置的停车设施），2-标签查询（返回基于标签的停车设施）；

响应参数

名称	参数类型	描述	说明
retCode	int	响应编码	0代表调用成功
retMsg	string	响应信息
status	string	本次API访问状态	如果成功返回1，如果失败返回0
info	string	本次API访问状态说明
count	string	本次请求返回的停车设施数量
- parkingLots	object	parkingLots
- parkingLot	object	停车设施列表清单
parkingId	string	停车场库唯一标识
parkingName	string	停车场库名称
lotStatus	int	停车场库状态	0-异常，1-正常；
leftBerthStatus	int	是否存在实时泊位	0-否，1-是；

核验网约车近一年月均营运行为轮廓

请求参数

名称	参数类型	描述	是否必须	说明
plateNo	string	车牌号	是	加密字段，需加密输入；车牌格式：地区缩写+数字英文；
vin	string	车辆识别码（vin码）	是	加密字段，需加密传输；支持后6位查询；
orderOutline	int	轮廓代码	是	1：近一年月均<1单，2：1单≤近一年月均<10单，3：10单≤近一年月均<30单，4：30单≤近一年月均<60单，5：60单≤近一年月均<90单，6：90单≤近一年月均<150单，7：150单≤近一年月均<300单，8：近一年月均≥300单；
customerCode	string	客户代码	是	加密字段，需加密传输；
authInfo	string	授权信息	是	加密字段，需加密传输；

响应参数

名称	参数类型	描述	说明
retCode	int	响应编码	0表示调用成功，其他失败；
retMsg	string	响应信息
checkResult	string	核验结果	0：一致，1：不一致，2：未查得；
resultDescription	string	核验提示	0-入参轮廓值过大，1-入参轮廓值过小；

查询周边公交基本信息（按经纬度）

请求参数

名称	参数类型	描述	是否必须	说明
paramType	string	参数类型	是	仅支持输入3（经纬度）
coordinateType	string	坐标类型	是	1-wgs84，2-gcj02；
nearDistance	int	半径(单位: 米)	否	默认1000，最大3000
- point	object	经纬度集合	是	支持多坐标集合入参；数据量较大，建议一次入参一个坐标；
lon	string	经度	是
lat	string	纬度	是

响应参数

名称	参数类型	描述	说明
retCode	string	响应编码	0代表调用成功，其余失败；
retMsg	string	响应信息
- gpsLineList	object	坐标集合线路信息	按照坐标集合顺序提供busLineStop信息
- busLineStop	object	线路信息
indexId	string	数据库唯一id
stopId	string	站点编号
stopName	string	站点名称
upDown	int	上下行	0-上行，1-下行；
lineId	string	线路编号
lineName	string	线路名称
startStopName	string	该线路起点站名称
endStopName	string	该线路终点站名称
startEarlyLateTime	string	最早始发时间	格式hhmm；
endEarlyLateTime	string	最晚到站时间	格式hhmm；
- point	object	位置信息
lon	string	当前站点经度
lat	string	当前站点纬度
- bustopList	object	线路站点列表
stopId	string	站点编码
stopName	string	站点名称
upDown	int	上下行	0-上行，1-下行；
stopLevels	int	站点序号
type	int	类型	废弃字段

查询市域铁路班次信息

请求参数

名称	参数类型	描述	是否必须	说明
lineNo	string	线路编码	是
stationId	string	站点编码	是
direction	string	上下行	是	0-上行，1-下行；

响应参数

名称	参数类型	描述	说明
retCode	int	响应编码	0代表成功，其余失败；
retMsg	string	响应信息
- cityRailWaySchedule	object	班次信息列表
lineNo	string	线路编码
lineName	string	线路名称
direction	int	上下行	0-上行，1-下行；
stationCode	string	站点编码
stationName	string	站点名称
trainNo	string	车辆编号
arriveTime	string	到达时间
departTime	string	出发时间

其他信息接口

接口名称	查询机场航班起降营运信息
查询铁路始发终到时刻信息	查询线路上所有公交车辆
查询周边公交基本信息（按经纬度）	查询附近市域铁路信息
查询轨交线路基础信息	查询轨交线路站点列表
查询轨交站点基础信息	查询轨交站点进出站客流信息
查询市域铁路线路基础信息	查询市域铁路站点基础信息
查询所有轨交线路列表	查询景区场馆基础信息
查询景区场馆列表	查询景区场馆实时在园人数
查询附近停车场库列表（按经纬度）	查询停车设施基本信息
查询停车设施列表信息	查询停车设施运营情况
查询墓园殡仪馆基础信息	查询墓园殡仪馆列表
查询公园绿地基础信息	查询公园绿地列表
查询体育场馆基础信息	查询体育场馆列表
查询体育场馆开放时间	查询体育场馆预定信息
查询文化场馆基础信息	查询文化场馆列表
查询文化场馆开放时间	查询图书馆馆藏信息
查询图书馆借阅信息	查询博物馆展览信息
查询美术馆展览信息	查询文化馆活动信息
查询科技馆展览信息	查询纪念馆展览信息
查询剧院演出信息	查询电影院放映信息
查询演出场所基础信息	查询演出活动列表
查询旅游景点基础信息	查询旅游景点列表
查询旅游线路信息	查询酒店住宿信息
查询餐饮场所基础信息	查询购物场所基础信息
查询休闲娱乐场所基础信息	查询健身场所基础信息
查询教育培训场所基础信息	查询医疗保健场所基础信息
查询金融服务场所基础信息	查询邮政服务场所基础信息
查询政务服务场所基础信息	查询法律服务场所基础信息
查询交通服务场所基础信息	查询物流服务场所基础信息
查询仓储服务场所基础信息	查询加工服务场所基础信息
查询维修服务场所基础信息	查询租赁服务场所基础信息
查询中介服务场所基础信息	查询咨询服务场所基础信息
查询检测服务场所基础信息	查询认证服务场所基础信息
查询公证服务场所基础信息	查询鉴定服务场所基础信息
查询评估服务场所基础信息	查询拍卖服务场所基础信息

预测信息接口

此外我们还提供了预测信息服务，接口及描述如下

接口名称	接口描述
停车场进出场车辆数预测	预测指定时段停车场进出场车辆数量
停车场饱和度预测服务	预测未来时段停车场占用率情况
轨交进出站客流预测服务	预测轨交站点/线路进出站客流规模
公交线路客流预测服务	预测公交线网客流高峰及时段分布
航空到达出发客流预测服务	预测机场到达与出发客流总量
铁路到达出发客流预测服务	预测车站/线路铁路客运量及时段
停车场剩余泊位数预测服务	动态预测停车场未来剩余泊位数
长途客运客流预测服务	预测长途客运线路客流量及时段
网约车网格下单量预测	预测城市网格内网约车下单需求
网约车网格完单量预测	预测网格内网约车成功完单数量
网约车网格等待时长预测	预测网约车用户平均等待时长
公交线路需求分析服务	分析公交线网客流分布与需求
交通态势预测服务	预测指定区域未来交通通行状态