下载
## 1. API市场-AIS数据接口 ### 1.1. 按MMSI查询船舶最新AIS信息 **接口描述**:按MMSI查询船舶最新AIS信息 **接口地址**:`/v1/mkt/ais/latest/mmsi` **请求方式**:`GET` **请求数据类型**: **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | | mmsi | 船舶MMSI | query | true | integer(int32) | **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | mmsi|船舶MMSI|integer(int32)| | postime|位置时间|string(date-time)| | lon|经度|number| | lat|纬度|number| | status|AIS状态|string| | imo|船舶IMO|string| | callsign|船舶呼号|string| | vesselName|船舶名称|string| | vesselType|船舶类型|string| | flagCtry|船旗国|string| | length|船长(米)|number| | breadth|船宽(米)|number| | a|AIS安装位置距船艏距离(米)|number| | b|AIS安装位置距船艉距离(米)|number| | c|AIS安装位置距左舷距离(米)|number| | d|AIS安装位置距右舷距离(米)|number| | eta|AIS ETA(UTC)|string(date-time)| | dest|AIS目的地|string| | draught|当前吃水(米)|number| | cog|航迹向|number| | hdg|船艏向|number| | sog|对地速度(节)|number| | rot|转向率|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 1.2. 按MMSI查询船舶历史AIS信息 **接口描述**:按MMSI查询船舶历史AIS信息 **接口地址**:`/v1/mkt/ais/track` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |mmsi|船舶MMSI|body|true|integer(int32)| |startTime|开始时间(yyyy-MM-dd HH:mm:ss)|body|true|string(date-time)| |endTime|结束时间(yyyy-MM-dd HH:mm:ss)|body|true|string(date-time)| |spare|是否稀疏|body|true|boolean| |spareFactor|稀疏参数(整10分钟倍数,稀疏配置[spare=true]时生效 默认:按10分钟稀疏|body|true|integer(int32)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | mmsi|船舶MMSI|integer(int32)| | postime|位置时间|string(date-time)| | lon|经度|number| | lat|纬度|number| | status|AIS状态|string| | eta|AIS ETA(UTC)|string(date-time)| | dest|AIS目的地|string| | draught|当前吃水(米)|number| | cog|航迹向|number| | hdg|船艏向|number| | sog|对地速度(节)|number| | rot|转向率|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 1.3. 按IMO查询船舶最新AIS信息 **接口描述**:按IMO查询船舶最新AIS信息 **接口地址**:`/v1/mkt/ais/latest/imo` **请求方式**:`GET` **请求数据类型**: **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | | imo | 船舶IMO | query | true | string | **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | mmsi|船舶MMSI|integer(int32)| | postime|位置时间|string(date-time)| | lon|经度|number| | lat|纬度|number| | status|AIS状态|string| | imo|船舶IMO|string| | callsign|船舶呼号|string| | vesselName|船舶名称|string| | vesselType|船舶类型|string| | flagCtry|船旗国|string| | length|船长(米)|number| | breadth|船宽(米)|number| | a|AIS安装位置距船艏距离(米)|number| | b|AIS安装位置距船艉距离(米)|number| | c|AIS安装位置距左舷距离(米)|number| | d|AIS安装位置距右舷距离(米)|number| | eta|AIS ETA(UTC)|string(date-time)| | dest|AIS目的地|string| | draught|当前吃水(米)|number| | cog|航迹向|number| | hdg|船艏向|number| | sog|对地速度(节)|number| | rot|转向率|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 1.4. 按自定义区域查询最新AIS信息 **接口描述**:按自定义区域查询最新AIS信息 **接口地址**:`/v1/mkt/ais/region` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |region|区域对象(支持圆形、矩形及任意线段组合的多边形)|body|true|object| | regionType|对象类型, 区域查询时必填|body|false|string| | leftTop|矩形左上角坐标,regionType='rectangle'时必填|body|false|object| | lon|经度|body|false|number| | lat|纬度|body|false|number| | rightBottom|矩形右下角坐标,regionType='rectangle'时必填|body|false|object| | lon|经度|body|false|number| | lat|纬度|body|false|number| | center|圆心坐标,regionType='circle'时必填|body|false|object| | lon|经度|body|false|number| | lat|纬度|body|false|number| | radius|圆形半径(海里),regionType='circle'时必填|body|false|number| | points|多边形连续点,不少于三个,regionType='polygon'时必填|body|false|array[object]| | lon|经度|body|false|number| | lat|纬度|body|false|number| | moveAngle|扇形对角线方向(度),regionType='sector'时必填|body|false|number| | scaleAngle|扇形对角线方向单侧夹角(度),regionType='sector'时必填|body|false|number| |lastUpdateWithinHour|AIS最后更新时间范围,默认6小时内|body|false|integer(int32)| |mmsiList|船舶MMSI列表,用于指定船舶查询,不得超过3000条|body|false|array[integer(int32)]| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | mmsi|船舶MMSI|integer(int32)| | postime|位置时间|string(date-time)| | lon|经度|number| | lat|纬度|number| | status|AIS状态|string| | imo|船舶IMO|string| | callsign|船舶呼号|string| | vesselName|船舶名称|string| | vesselType|船舶类型|string| | flagCtry|船旗国|string| | length|船长(米)|number| | breadth|船宽(米)|number| | a|AIS安装位置距船艏距离(米)|number| | b|AIS安装位置距船艉距离(米)|number| | c|AIS安装位置距左舷距离(米)|number| | d|AIS安装位置距右舷距离(米)|number| | eta|AIS ETA(UTC)|string(date-time)| | dest|AIS目的地|string| | draught|当前吃水(米)|number| | cog|航迹向|number| | hdg|船艏向|number| | sog|对地速度(节)|number| | rot|转向率|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 1.5. 按自定义区域查询最新AIS及船舶基础信息 **接口描述**:按自定义区域查询最新AIS及船舶基础信息 **接口地址**:`/v1/mkt/ais/region/vessel` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |region|区域对象(支持圆形、矩形及任意线段组合的多边形)|body|true|object| | regionType|对象类型, 区域查询时必填|body|false|string| | leftTop|矩形左上角坐标,regionType='rectangle'时必填|body|false|object| | lon|经度|body|false|number| | lat|纬度|body|false|number| | rightBottom|矩形右下角坐标,regionType='rectangle'时必填|body|false|object| | lon|经度|body|false|number| | lat|纬度|body|false|number| | center|圆心坐标,regionType='circle'时必填|body|false|object| | lon|经度|body|false|number| | lat|纬度|body|false|number| | radius|圆形半径(海里),regionType='circle'时必填|body|false|number| | points|多边形连续点,不少于三个,regionType='polygon'时必填|body|false|array[object]| | lon|经度|body|false|number| | lat|纬度|body|false|number| | moveAngle|扇形对角线方向(度),regionType='sector'时必填|body|false|number| | scaleAngle|扇形对角线方向单侧夹角(度),regionType='sector'时必填|body|false|number| |lastUpdateWithinHour|AIS最后更新时间范围,默认6小时内|body|false|integer(int32)| |mmsiList|船舶MMSI列表,用于指定船舶查询,不得超过3000条|body|false|array[integer(int32)]| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | mmsi|船舶MMSI|integer(int32)| | postime|位置时间|string(date-time)| | lon|经度|number| | lat|纬度|number| | status|AIS状态|string| | imo|船舶IMO|string| | callsign|船舶呼号|string| | vesselName|船舶名称|string| | vesselType|船舶类型|string| | flagCtry|船旗国|string| | length|船长(米)|number| | breadth|船宽(米)|number| | a|AIS安装位置距船艏距离(米)|number| | b|AIS安装位置距船艉距离(米)|number| | c|AIS安装位置距左舷距离(米)|number| | d|AIS安装位置距右舷距离(米)|number| | eta|AIS ETA(UTC)|string(date-time)| | dest|AIS目的地|string| | draught|当前吃水(米)|number| | cog|航迹向|number| | hdg|船艏向|number| | sog|对地速度(节)|number| | rot|转向率|number| | vesselInfo|船舶信息|object| | mmsi|船舶MMSI|integer(int32)| | imo|船舶IMO|string| | callsign|船舶呼号|string| | nameEn|船舶英文名|string| | nameCn|船舶中文名|string| | vesselType|一级船型|string| | vesselTypeNameCn|一级船型中文名|string| | vesselTypeNameEn|一级船型英文名|string| | vesselSubType|二级船型|string| | vesselSubTypeNameCn|二级船型中文名|string| | vesselSubTypeNameEn|二级船型英文名|string| | vesselSub2Type|三级船型|string| | vesselSub2TypeNameCn|三级船型中文名|string| | vesselSub2TypeNameEn|三级船型英文名|string| | flagCtry|船旗国|string| | flagCtryNameCn|船旗国中文名|string| | flagCtryNameEn|船旗国英文名|string| | classSociety|船级社|string| | classSocietyNameCn|船级社中文名|string| | classSocietyNameEn|船级社英文名|string| | buildYearMonth|建造年月|string| | retireYearMonth|失效时间|integer(int32)| | preMmsi|前任MMSI|integer(int32)| | nextMmsi|后任MMSI|integer(int32)| | registryPort|船籍港|string| | dwt|载重吨(吨)|integer(int32)| | grt|总吨|integer(int32)| | net|净吨|integer(int32)| | teu|载箱数|integer(int32)| | liquid|液体体积(立方米)|integer(int32)| | gas|气体体积(立方米)|integer(int32)| | length|船长(米)|number| | width|船宽(米)|number| | height|船高(米)|number| | draught|设计吃水(米)|number| | speed|设计航速(节)|number| | numberofcars|载车数|integer(int32)| | passengercapacity|载客数|integer(int32)| | operatorBody|经营主体英文名|string| | operatorBodyCn|经营主体中文名|string| | manageBody|管理主体英文名|string| | manageBodyCn|管理主体中文名|string| | ownerBody|所有者主体英文名|string| | ownerBodyCn|所有者主体中文名|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 1.6. 按自定义船队查询最新AIS信息 **接口描述**:按自定义船队查询最新AIS信息 **接口地址**:`/v1/mkt/ais/fleet` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |mmsiList|船舶MMSI列表|body|false|array[integer(int32)]| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | mmsi|船舶MMSI|integer(int32)| | postime|位置时间|string(date-time)| | lon|经度|number| | lat|纬度|number| | status|AIS状态|string| | imo|船舶IMO|string| | callsign|船舶呼号|string| | vesselName|船舶名称|string| | vesselType|船舶类型|string| | flagCtry|船旗国|string| | length|船长(米)|number| | breadth|船宽(米)|number| | a|AIS安装位置距船艏距离(米)|number| | b|AIS安装位置距船艉距离(米)|number| | c|AIS安装位置距左舷距离(米)|number| | d|AIS安装位置距右舷距离(米)|number| | eta|AIS ETA(UTC)|string(date-time)| | dest|AIS目的地|string| | draught|当前吃水(米)|number| | cog|航迹向|number| | hdg|船艏向|number| | sog|对地速度(节)|number| | rot|转向率|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 1.7. 按自定义船队查询最新AIS及船舶基础信息 **接口描述**:按自定义船队查询最新AIS及船舶基础信息 **接口地址**:`/v1/mkt/ais/fleet/vessel` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |mmsiList|船舶MMSI列表|body|false|array[integer(int32)]| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | mmsi|船舶MMSI|integer(int32)| | postime|位置时间|string(date-time)| | lon|经度|number| | lat|纬度|number| | status|AIS状态|string| | imo|船舶IMO|string| | callsign|船舶呼号|string| | vesselName|船舶名称|string| | vesselType|船舶类型|string| | flagCtry|船旗国|string| | length|船长(米)|number| | breadth|船宽(米)|number| | a|AIS安装位置距船艏距离(米)|number| | b|AIS安装位置距船艉距离(米)|number| | c|AIS安装位置距左舷距离(米)|number| | d|AIS安装位置距右舷距离(米)|number| | eta|AIS ETA(UTC)|string(date-time)| | dest|AIS目的地|string| | draught|当前吃水(米)|number| | cog|航迹向|number| | hdg|船艏向|number| | sog|对地速度(节)|number| | rot|转向率|number| | vesselInfo|船舶信息|object| | mmsi|船舶MMSI|integer(int32)| | imo|船舶IMO|string| | callsign|船舶呼号|string| | nameEn|船舶英文名|string| | nameCn|船舶中文名|string| | vesselType|一级船型|string| | vesselTypeNameCn|一级船型中文名|string| | vesselTypeNameEn|一级船型英文名|string| | vesselSubType|二级船型|string| | vesselSubTypeNameCn|二级船型中文名|string| | vesselSubTypeNameEn|二级船型英文名|string| | vesselSub2Type|三级船型|string| | vesselSub2TypeNameCn|三级船型中文名|string| | vesselSub2TypeNameEn|三级船型英文名|string| | flagCtry|船旗国|string| | flagCtryNameCn|船旗国中文名|string| | flagCtryNameEn|船旗国英文名|string| | classSociety|船级社|string| | classSocietyNameCn|船级社中文名|string| | classSocietyNameEn|船级社英文名|string| | buildYearMonth|建造年月|string| | retireYearMonth|失效时间|integer(int32)| | preMmsi|前任MMSI|integer(int32)| | nextMmsi|后任MMSI|integer(int32)| | registryPort|船籍港|string| | dwt|载重吨(吨)|integer(int32)| | grt|总吨|integer(int32)| | net|净吨|integer(int32)| | teu|载箱数|integer(int32)| | liquid|液体体积(立方米)|integer(int32)| | gas|气体体积(立方米)|integer(int32)| | length|船长(米)|number| | width|船宽(米)|number| | height|船高(米)|number| | draught|设计吃水(米)|number| | speed|设计航速(节)|number| | numberofcars|载车数|integer(int32)| | passengercapacity|载客数|integer(int32)| | operatorBody|经营主体英文名|string| | operatorBodyCn|经营主体中文名|string| | manageBody|管理主体英文名|string| | manageBodyCn|管理主体中文名|string| | ownerBody|所有者主体英文名|string| | ownerBodyCn|所有者主体中文名|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 1.8. 按MMSI查询指定船舶断面穿越信息 **接口描述**:按MMSI查询指定船舶断面穿越信息 **接口地址**:`/v1/mkt/ais/cross/line` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |startTime|开始时间(yyyy-MM-dd HH:mm:ss)|body|true|string(date-time)| |endTime|结束时间(yyyy-MM-dd HH:mm:ss)|body|true|string(date-time)| |lineDirection|断面方向 H:水平(南北穿越) V: 垂直(东西穿越)|body|true|string| |line|切面对象(多点连成的线,格式:lon1 lat1,lon2 lat2,..)|body|true|string| |mmsi|船舶MMSI|body|true|integer(int32)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | preAis|上一AIS信息|object| | postime|位置时间(yyyy-MM-dd HH:mm:ss)|string(date-time)| | lon|经度|number| | lat|纬度|number| | crossPoint|穿越点信息|object| | postime|位置时间(yyyy-MM-dd HH:mm:ss)|string(date-time)| | lon|经度|number| | lat|纬度|number| | crossDirection|穿越方向,N由南向北,S由北向南,W由东向西,E由西向东|string| | currAis|当前AIS信息|object| | postime|位置时间(yyyy-MM-dd HH:mm:ss)|string(date-time)| | lon|经度|number| | lat|纬度|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 1.9. 查询所有船舶断面穿越信息 **接口描述**:查询所有船舶断面穿越信息 **接口地址**:`/v1/mkt/ais/cross/line/all` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |startTime|开始时间(yyyy-MM-dd HH:mm:ss)|body|true|string(date-time)| |endTime|结束时间(yyyy-MM-dd HH:mm:ss)|body|true|string(date-time)| |lineDirection|断面方向 H:水平(南北穿越) V: 垂直(东西穿越)|body|true|string| |line|切面对象(多点连成的线,格式:lon1 lat1,lon2 lat2,..)|body|true|string| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | mmsi|船舶mmsi|integer(int32)| | crossDirection|穿越方向,N由南向北,S由北向南,W由东向西,E由西向东|string| | crossPostime|位置时间(yyyy-MM-dd HH:mm:ss)|string(date-time)| | crossLon|经度|number| | crossLat|纬度|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 1.10. 按MMSI查询指定船舶区域进出信息 **接口描述**:按MMSI查询指定船舶区域进出信息 **接口地址**:`/v1/mkt/ais/cross/region` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |mmsi|船舶MMSI|body|true|integer(int32)| |startTime|开始时间(yyyy-MM-dd HH:mm:ss)|body|true|string(date-time)| |endTime|结束时间(yyyy-MM-dd HH:mm:ss)|body|true|string(date-time)| |region|区域对象(支持圆形、矩形及任意线段组合的多边形)|body|true|object| | regionType|对象类型, 区域查询时必填|body|false|string| | leftTop|矩形左上角坐标,regionType='rectangle'时必填|body|false|object| | lon|经度|body|false|number| | lat|纬度|body|false|number| | rightBottom|矩形右下角坐标,regionType='rectangle'时必填|body|false|object| | lon|经度|body|false|number| | lat|纬度|body|false|number| | center|圆心坐标,regionType='circle'时必填|body|false|object| | lon|经度|body|false|number| | lat|纬度|body|false|number| | radius|圆形半径(海里),regionType='circle'时必填|body|false|number| | points|多边形连续点,不少于三个,regionType='polygon'时必填|body|false|array[object]| | lon|经度|body|false|number| | lat|纬度|body|false|number| | moveAngle|扇形对角线方向(度),regionType='sector'时必填|body|false|number| | scaleAngle|扇形对角线方向单侧夹角(度),regionType='sector'时必填|body|false|number| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | preAis|上一AIS信息|object| | postime|位置时间(yyyy-MM-dd HH:mm:ss)|string(date-time)| | lon|经度|number| | lat|纬度|number| | currAis|当前AIS信息|object| | postime|位置时间(yyyy-MM-dd HH:mm:ss)|string(date-time)| | lon|经度|number| | lat|纬度|number| | crossPoint|穿越点信息|object| | postime|位置时间(yyyy-MM-dd HH:mm:ss)|string(date-time)| | lon|经度|number| | lat|纬度|number| | crossType|穿越方向|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ## 2. API市场-港口数据接口 ### 2.1. 按港口名称代码等信息模糊查询港口 **接口描述**:按港口名称代码等信息模糊查询港口 **接口地址**:`/v1/mkt/ports/fuzzy` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |kw|查询关键字|body|true|string| |recordNum|返回记录条数(默认10条)|body|false|integer(int32)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | portCode|港口代码|string| | nameCn|港口中文名|string| | nameEn|港口英文名|string| | aliasNames|港口曾用名|string| | ctryCode|国家代码|string| | ctryNameCn|国家中文名|string| | ctryNameEn|国家英文名|string| | unlocode|unlocode|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 2.2. 按港口代码查询港口基础信息 **接口描述**:按港口代码查询港口基础信息 **接口地址**:`/v1/mkt/ports/detail` **请求方式**:`GET` **请求数据类型**: **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | | portCode | 港口代码 | query | true | string | **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | portCode|港口代码|string| | nameCn|港口中文名|string| | nameEn|港口英文名|string| | aliasNames|港口曾用名|string| | portType|港口类型(B-基本港,T-普通码头,O-原油码头,F-浮仓)|string| | portTypeNameCn|港口类型中文描述|string| | portTypeNameEn|港口类型英文描述|string| | lon|港口经度|number| | lat|港口纬度|number| | tzOffset|港口时区|integer(int32)| | ctryCode|国家代码|string| | ctryNameCn|国家中文名|string| | ctryNameEn|国家英文名|string| | continentCode|洲代码|string| | continentNameCn|洲中文名|string| | continentNameEn|洲英文名|string| | tradeAreaCode|贸易区代码|string| | tradeAreaNameCn|贸易区中文名称|string| | tradeAreaNameEn|贸易区英文名称|string| | unlocode|unlocode|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 2.3. 按港口代码查询预计抵港船舶列表 **接口描述**:按港口代码查询预计抵港船舶列表 **接口地址**:`/v1/mkt/ports/vessel/schedule` **请求方式**:`GET` **请求数据类型**: **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | | portCode | 港口代码 | query | true | string | **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | mmsi|船舶MMSI|integer(int32)| | imo|船舶IMO|string| | callsign|船舶呼号|string| | nameEn|船舶英文名|string| | nameCn|船舶中文名|string| | vesselType|一级船型|string| | vesselTypeNameCn|一级船型中文名|string| | vesselTypeNameEn|一级船型英文名|string| | vesselSubType|二级船型|string| | vesselSubTypeNameCn|二级船型中文名|string| | vesselSubTypeNameEn|二级船型英文名|string| | vesselSub2Type|三级船型|string| | vesselSub2TypeNameCn|三级船型中文名|string| | vesselSub2TypeNameEn|三级船型英文名|string| | flagCtry|船旗国|string| | flagCtryNameCn|船旗国中文名|string| | flagCtryNameEn|船旗国英文名|string| | classSociety|船级社|string| | classSocietyNameCn|船级社中文名|string| | classSocietyNameEn|船级社英文名|string| | buildYearMonth|建造年月|string| | retireYearMonth|失效时间|integer(int32)| | preMmsi|前任MMSI|integer(int32)| | nextMmsi|后任MMSI|integer(int32)| | registryPort|船籍港|string| | dwt|载重吨(吨)|integer(int32)| | grt|总吨|integer(int32)| | net|净吨|integer(int32)| | teu|载箱数|integer(int32)| | liquid|液体体积(立方米)|integer(int32)| | gas|气体体积(立方米)|integer(int32)| | length|船长(米)|number| | width|船宽(米)|number| | height|船高(米)|number| | draught|设计吃水(米)|number| | speed|设计航速(节)|number| | numberofcars|载车数|integer(int32)| | passengercapacity|载客数|integer(int32)| | operatorBody|经营主体英文名|string| | operatorBodyCn|经营主体中文名|string| | manageBody|管理主体英文名|string| | manageBodyCn|管理主体中文名|string| | ownerBody|所有者主体英文名|string| | ownerBodyCn|所有者主体中文名|string| | dynamicType|一级动态类型: 0-航行,1-锚泊,5-靠泊,6-搁浅|string| | dynamicSubType|二级动态类型: 00-航行(途中),01-航行(到港),10-锚泊(途中),11-锚泊(到港),50-靠泊(作业),51-靠泊(修理),52-靠泊(建造),53-靠泊(检验),60-搁浅|string| | legStartPortCode|启运港|string| | legStartPortNameCn|启运港中文名|string| | legStartPortNameEn|启运港英文名|string| | legStartPortCtryCode|启运港国家|string| | legStartPortCtryNameCn|启运港国家中文名|string| | legStartPortCtryNameEn|启运港国家英文名|string| | legEndPortCode|目的港|string| | legEndPortNameCn|目的港中文名|string| | legEndPortNameEn|目的港英文名|string| | legEndPortCtryCode|目的港国家|string| | legEndPortCtryNameCn|目的港国家中文名|string| | legEndPortCtryNameEn|目的港国家英文名|string| | legStartPostime|航段开始时间|string(date-time)| | legStartPostimeLocal|航段开始时间(LT)|string(date-time)| | eta|船舶预计到港时间|string(date-time)| | etaLocal|船舶预计到港时间(LT)|string(date-time)| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 2.4. 按港口代码查询当前锚泊船舶列表 **接口描述**:按港口代码查询当前锚泊船舶列表 **接口地址**:`/v1/mkt/ports/vessel/moor` **请求方式**:`GET` **请求数据类型**: **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | | portCode | 港口代码 | query | true | string | **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | mmsi|船舶MMSI|integer(int32)| | imo|船舶IMO|string| | callsign|船舶呼号|string| | nameEn|船舶英文名|string| | nameCn|船舶中文名|string| | vesselType|一级船型|string| | vesselTypeNameCn|一级船型中文名|string| | vesselTypeNameEn|一级船型英文名|string| | vesselSubType|二级船型|string| | vesselSubTypeNameCn|二级船型中文名|string| | vesselSubTypeNameEn|二级船型英文名|string| | vesselSub2Type|三级船型|string| | vesselSub2TypeNameCn|三级船型中文名|string| | vesselSub2TypeNameEn|三级船型英文名|string| | flagCtry|船旗国|string| | flagCtryNameCn|船旗国中文名|string| | flagCtryNameEn|船旗国英文名|string| | classSociety|船级社|string| | classSocietyNameCn|船级社中文名|string| | classSocietyNameEn|船级社英文名|string| | buildYearMonth|建造年月|string| | retireYearMonth|失效时间|integer(int32)| | preMmsi|前任MMSI|integer(int32)| | nextMmsi|后任MMSI|integer(int32)| | registryPort|船籍港|string| | dwt|载重吨(吨)|integer(int32)| | grt|总吨|integer(int32)| | net|净吨|integer(int32)| | teu|载箱数|integer(int32)| | liquid|液体体积(立方米)|integer(int32)| | gas|气体体积(立方米)|integer(int32)| | length|船长(米)|number| | width|船宽(米)|number| | height|船高(米)|number| | draught|设计吃水(米)|number| | speed|设计航速(节)|number| | numberofcars|载车数|integer(int32)| | passengercapacity|载客数|integer(int32)| | operatorBody|经营主体英文名|string| | operatorBodyCn|经营主体中文名|string| | manageBody|管理主体英文名|string| | manageBodyCn|管理主体中文名|string| | ownerBody|所有者主体英文名|string| | ownerBodyCn|所有者主体中文名|string| | dynamicType|一级动态类型: 0-航行,1-锚泊,5-靠泊,6-搁浅|string| | dynamicSubType|二级动态类型: 00-航行(途中),01-航行(到港),10-锚泊(途中),11-锚泊(到港),50-靠泊(作业),51-靠泊(修理),52-靠泊(建造),53-靠泊(检验),60-搁浅|string| | legStartPortCode|启运港|string| | legStartPortNameCn|启运港中文名|string| | legStartPortNameEn|启运港英文名|string| | legStartPortCtryCode|启运港国家|string| | legStartPortCtryNameCn|启运港国家中文名|string| | legStartPortCtryNameEn|启运港国家英文名|string| | legEndPortCode|目的港|string| | legEndPortNameCn|目的港中文名|string| | legEndPortNameEn|目的港英文名|string| | legEndPortCtryCode|目的港国家|string| | legEndPortCtryNameCn|目的港国家中文名|string| | legEndPortCtryNameEn|目的港国家英文名|string| | legStartPostime|航段开始时间|string(date-time)| | legStartPostimeLocal|航段开始时间(LT)|string(date-time)| | arrivalTime|船舶实际到港时间|string(date-time)| | arrivalTimeLocal|船舶实际到港时间(LT)|string(date-time)| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 2.5. 按港口代码查询当前靠泊船舶列表 **接口描述**:按港口代码查询当前靠泊船舶列表 **接口地址**:`/v1/mkt/ports/vessel/berth` **请求方式**:`GET` **请求数据类型**: **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | | portCode | 港口代码 | query | true | string | **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | mmsi|船舶MMSI|integer(int32)| | imo|船舶IMO|string| | callsign|船舶呼号|string| | nameEn|船舶英文名|string| | nameCn|船舶中文名|string| | vesselType|一级船型|string| | vesselTypeNameCn|一级船型中文名|string| | vesselTypeNameEn|一级船型英文名|string| | vesselSubType|二级船型|string| | vesselSubTypeNameCn|二级船型中文名|string| | vesselSubTypeNameEn|二级船型英文名|string| | vesselSub2Type|三级船型|string| | vesselSub2TypeNameCn|三级船型中文名|string| | vesselSub2TypeNameEn|三级船型英文名|string| | flagCtry|船旗国|string| | flagCtryNameCn|船旗国中文名|string| | flagCtryNameEn|船旗国英文名|string| | classSociety|船级社|string| | classSocietyNameCn|船级社中文名|string| | classSocietyNameEn|船级社英文名|string| | buildYearMonth|建造年月|string| | retireYearMonth|失效时间|integer(int32)| | preMmsi|前任MMSI|integer(int32)| | nextMmsi|后任MMSI|integer(int32)| | registryPort|船籍港|string| | dwt|载重吨(吨)|integer(int32)| | grt|总吨|integer(int32)| | net|净吨|integer(int32)| | teu|载箱数|integer(int32)| | liquid|液体体积(立方米)|integer(int32)| | gas|气体体积(立方米)|integer(int32)| | length|船长(米)|number| | width|船宽(米)|number| | height|船高(米)|number| | draught|设计吃水(米)|number| | speed|设计航速(节)|number| | numberofcars|载车数|integer(int32)| | passengercapacity|载客数|integer(int32)| | operatorBody|经营主体英文名|string| | operatorBodyCn|经营主体中文名|string| | manageBody|管理主体英文名|string| | manageBodyCn|管理主体中文名|string| | ownerBody|所有者主体英文名|string| | ownerBodyCn|所有者主体中文名|string| | dynamicType|一级动态类型: 0-航行,1-锚泊,5-靠泊,6-搁浅|string| | dynamicSubType|二级动态类型: 00-航行(途中),01-航行(到港),10-锚泊(途中),11-锚泊(到港),50-靠泊(作业),51-靠泊(修理),52-靠泊(建造),53-靠泊(检验),60-搁浅|string| | legStartPortCode|启运港|string| | legStartPortNameCn|启运港中文名|string| | legStartPortNameEn|启运港英文名|string| | legStartPortCtryCode|启运港国家|string| | legStartPortCtryNameCn|启运港国家中文名|string| | legStartPortCtryNameEn|启运港国家英文名|string| | legEndPortCode|目的港|string| | legEndPortNameCn|目的港中文名|string| | legEndPortNameEn|目的港英文名|string| | legEndPortCtryCode|目的港国家|string| | legEndPortCtryNameCn|目的港国家中文名|string| | legEndPortCtryNameEn|目的港国家英文名|string| | legStartPostime|航段开始时间|string(date-time)| | legStartPostimeLocal|航段开始时间(LT)|string(date-time)| | arrivalTime|船舶实际到港时间|string(date-time)| | arrivalTimeLocal|船舶实际到港时间(LT)|string(date-time)| | berthTime|靠泊时间|string(date-time)| | berthTimeLocal|靠泊时间(LT)|string(date-time)| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 2.6. 按港口代码查询当前修理船舶列表 **接口描述**:按港口代码查询当前修理船舶列表 **接口地址**:`/v1/mkt/ports/vessel/repair` **请求方式**:`GET` **请求数据类型**: **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | | portCode | 港口代码 | query | true | string | **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | mmsi|船舶MMSI|integer(int32)| | imo|船舶IMO|string| | callsign|船舶呼号|string| | nameEn|船舶英文名|string| | nameCn|船舶中文名|string| | vesselType|一级船型|string| | vesselTypeNameCn|一级船型中文名|string| | vesselTypeNameEn|一级船型英文名|string| | vesselSubType|二级船型|string| | vesselSubTypeNameCn|二级船型中文名|string| | vesselSubTypeNameEn|二级船型英文名|string| | vesselSub2Type|三级船型|string| | vesselSub2TypeNameCn|三级船型中文名|string| | vesselSub2TypeNameEn|三级船型英文名|string| | flagCtry|船旗国|string| | flagCtryNameCn|船旗国中文名|string| | flagCtryNameEn|船旗国英文名|string| | classSociety|船级社|string| | classSocietyNameCn|船级社中文名|string| | classSocietyNameEn|船级社英文名|string| | buildYearMonth|建造年月|string| | retireYearMonth|失效时间|integer(int32)| | preMmsi|前任MMSI|integer(int32)| | nextMmsi|后任MMSI|integer(int32)| | registryPort|船籍港|string| | dwt|载重吨(吨)|integer(int32)| | grt|总吨|integer(int32)| | net|净吨|integer(int32)| | teu|载箱数|integer(int32)| | liquid|液体体积(立方米)|integer(int32)| | gas|气体体积(立方米)|integer(int32)| | length|船长(米)|number| | width|船宽(米)|number| | height|船高(米)|number| | draught|设计吃水(米)|number| | speed|设计航速(节)|number| | numberofcars|载车数|integer(int32)| | passengercapacity|载客数|integer(int32)| | operatorBody|经营主体英文名|string| | operatorBodyCn|经营主体中文名|string| | manageBody|管理主体英文名|string| | manageBodyCn|管理主体中文名|string| | ownerBody|所有者主体英文名|string| | ownerBodyCn|所有者主体中文名|string| | dynamicType|一级动态类型: 0-航行,1-锚泊,5-靠泊,6-搁浅|string| | dynamicSubType|二级动态类型: 00-航行(途中),01-航行(到港),10-锚泊(途中),11-锚泊(到港),50-靠泊(作业),51-靠泊(修理),52-靠泊(建造),53-靠泊(检验),60-搁浅|string| | legStartPortCode|启运港|string| | legStartPortNameCn|启运港中文名|string| | legStartPortNameEn|启运港英文名|string| | legStartPortCtryCode|启运港国家|string| | legStartPortCtryNameCn|启运港国家中文名|string| | legStartPortCtryNameEn|启运港国家英文名|string| | legEndPortCode|目的港|string| | legEndPortNameCn|目的港中文名|string| | legEndPortNameEn|目的港英文名|string| | legEndPortCtryCode|目的港国家|string| | legEndPortCtryNameCn|目的港国家中文名|string| | legEndPortCtryNameEn|目的港国家英文名|string| | legStartPostime|航段开始时间|string(date-time)| | legStartPostimeLocal|航段开始时间(LT)|string(date-time)| | arrivalTime|船舶实际到港时间|string(date-time)| | arrivalTimeLocal|船舶实际到港时间(LT)|string(date-time)| | berthTime|靠泊时间|string(date-time)| | berthTimeLocal|靠泊时间(LT)|string(date-time)| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 2.7. 按港口代码分页查询历史靠泊记录 **接口描述**:按港口代码分页查询历史靠泊记录 **接口地址**:`/v1/mkt/ports/vessel/berth/history` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |portCode|港口代码|body|true|string| |startTime|开始时间(靠泊)|body|true|string(date-time)| |endTime|结束时间(靠泊)|body|true|string(date-time)| |searchType|检索类型,1: 按靠泊时间检索,2: 按到港时间检索,3:按离港时间检索|body|true|integer(int32)| |page|分页参数|body|false|object| | pageNum|页数|body|false|integer(int32)| | pageSize|每页记录数|body|false|integer(int32)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | totalElements||integer(int64)| | totalPages||integer(int32)| | size||integer(int32)| | content||array[object]| | mmsi|船舶MMSI|integer(int32)| | imo|船舶IMO|string| | callsign|船舶呼号|string| | nameEn|船舶英文名|string| | nameCn|船舶中文名|string| | vesselType|一级船型|string| | vesselTypeNameCn|一级船型中文名|string| | vesselTypeNameEn|一级船型英文名|string| | vesselSubType|二级船型|string| | vesselSubTypeNameCn|二级船型中文名|string| | vesselSubTypeNameEn|二级船型英文名|string| | vesselSub2Type|三级船型|string| | vesselSub2TypeNameCn|三级船型中文名|string| | vesselSub2TypeNameEn|三级船型英文名|string| | flagCtry|船旗国|string| | flagCtryNameCn|船旗国中文名|string| | flagCtryNameEn|船旗国英文名|string| | classSociety|船级社|string| | classSocietyNameCn|船级社中文名|string| | classSocietyNameEn|船级社英文名|string| | buildYearMonth|建造年月|string| | retireYearMonth|失效时间|integer(int32)| | preMmsi|前任MMSI|integer(int32)| | nextMmsi|后任MMSI|integer(int32)| | registryPort|船籍港|string| | dwt|载重吨(吨)|integer(int32)| | grt|总吨|integer(int32)| | net|净吨|integer(int32)| | teu|载箱数|integer(int32)| | liquid|液体体积(立方米)|integer(int32)| | gas|气体体积(立方米)|integer(int32)| | length|船长(米)|number| | width|船宽(米)|number| | height|船高(米)|number| | draught|设计吃水(米)|number| | speed|设计航速(节)|number| | numberofcars|载车数|integer(int32)| | passengercapacity|载客数|integer(int32)| | operatorBody|经营主体英文名|string| | operatorBodyCn|经营主体中文名|string| | manageBody|管理主体英文名|string| | manageBodyCn|管理主体中文名|string| | ownerBody|所有者主体英文名|string| | ownerBodyCn|所有者主体中文名|string| | legStartPortCode|启运港|string| | legStartPortNameCn|启运港中文名|string| | legStartPortNameEn|启运港英文名|string| | legStartPortCtryCode|启运港国家|string| | legStartPortCtryNameCn|启运港国家中文名|string| | legStartPortCtryNameEn|启运港国家英文名|string| | legStartBerthUuid|启运港泊位uuid|string| | legStartBerthNameCn|启运港泊位中文名|string| | legStartBerthNameEn|启运港泊位英文名|string| | legEndPortCode|目的港|string| | legEndPortNameCn|目的港中文名|string| | legEndPortNameEn|目的港英文名|string| | legEndPortCtryCode|目的港国家|string| | legEndPortCtryNameCn|目的港国家中文名|string| | legEndPortCtryNameEn|目的港国家英文名|string| | legEndBerthUuid|目的港泊位uuid|string| | legEndBerthNameCn|目的港泊位中文名|string| | legEndBerthNameEn|目的港泊位英文名|string| | legStartTime|航段开始时间|string(date-time)| | legStartTimeLocal|航段开始时间(LT)|string(date-time)| | arrivalTime|到港时间|string(date-time)| | arrivalTimeLocal|到港时间(LT)|string(date-time)| | berthTime|靠泊时间|string(date-time)| | berthTimeLocal|靠泊时间(LT)|string(date-time)| | legEndTime|航段结束时间|string(date-time)| | legEndTimeLocal|航段结束时间(LT)|string(date-time)| | sailDuration|航行时长(小时)|number| | sailDistance|航行里程(海里)|number| | averageSpeed|平均航速(节)|number| | number||integer(int32)| | sort||object| | empty||boolean| | sorted||boolean| | unsorted||boolean| | numberOfElements||integer(int32)| | pageable||object| | offset||integer(int64)| | sort||object| | empty||boolean| | sorted||boolean| | unsorted||boolean| | pageSize||integer(int32)| | pageNumber||integer(int32)| | paged||boolean| | unpaged||boolean| | first||boolean| | last||boolean| | empty||boolean| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 2.8. 按港口代码查询当日在锚数量指标 **接口描述**:按港口代码查询当日在锚数量指标 **接口地址**:`/v1/mkt/ports/efficiency/moor-num` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |portCode|港口代码|body|true|string| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | min|最小值(艘数或时长,时长单位小时)|number| | max|最大值(艘数或时长,时长单位小时)|number| | avg|平均值(艘数或时长,时长单位小时)|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 2.9. 按港口代码查询当日在泊数量指标 **接口描述**:按港口代码查询当日在泊数量指标 **接口地址**:`/v1/mkt/ports/efficiency/berth-num` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |portCode|港口代码|body|true|string| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | min|最小值(艘数或时长,时长单位小时)|number| | max|最大值(艘数或时长,时长单位小时)|number| | avg|平均值(艘数或时长,时长单位小时)|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 2.10. 按港口代码查询当日在港数量指标 **接口描述**:按港口代码查询当日在港数量指标 **接口地址**:`/v1/mkt/ports/efficiency/stay-num` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |portCode|港口代码|body|true|string| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | min|最小值(艘数或时长,时长单位小时)|number| | max|最大值(艘数或时长,时长单位小时)|number| | avg|平均值(艘数或时长,时长单位小时)|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 2.11. 按港口代码查询当日锚泊时长指标 **接口描述**:按港口代码查询当日锚泊时长指标 **接口地址**:`/v1/mkt/ports/efficiency/moor-duration` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |portCode|港口代码|body|true|string| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | min|最小值(艘数或时长,时长单位小时)|number| | max|最大值(艘数或时长,时长单位小时)|number| | avg|平均值(艘数或时长,时长单位小时)|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 2.12. 按港口代码查询当日作业时长指标 **接口描述**:按港口代码查询当日作业时长指标 **接口地址**:`/v1/mkt/ports/efficiency/berth-duration` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |portCode|港口代码|body|true|string| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | min|最小值(艘数或时长,时长单位小时)|number| | max|最大值(艘数或时长,时长单位小时)|number| | avg|平均值(艘数或时长,时长单位小时)|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 2.13. 按港口代码查询当日在港时长指标 **接口描述**:按港口代码查询当日在港时长指标 **接口地址**:`/v1/mkt/ports/efficiency/stay-duration` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |portCode|港口代码|body|true|string| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | min|最小值(艘数或时长,时长单位小时)|number| | max|最大值(艘数或时长,时长单位小时)|number| | avg|平均值(艘数或时长,时长单位小时)|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 2.14. 按港口代码查询当日平均等泊时长指标 **接口描述**:按港口代码查询当日平均等泊时长指标 **接口地址**:`/v1/mkt/ports/efficiency/moor-avg` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |portCode|港口代码|body|true|string| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | min|最小值(艘数或时长,时长单位小时)|number| | max|最大值(艘数或时长,时长单位小时)|number| | avg|平均值(艘数或时长,时长单位小时)|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 2.15. 按港口代码查询当日平均作业时长指标 **接口描述**:按港口代码查询当日平均作业时长指标 **接口地址**:`/v1/mkt/ports/efficiency/berth-avg` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |portCode|港口代码|body|true|string| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | min|最小值(艘数或时长,时长单位小时)|number| | max|最大值(艘数或时长,时长单位小时)|number| | avg|平均值(艘数或时长,时长单位小时)|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 2.16. 按港口代码查询当日平均停留时长指标 **接口描述**:按港口代码查询当日平均停留时长指标 **接口地址**:`/v1/mkt/ports/efficiency/stay-avg` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |portCode|港口代码|body|true|string| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | min|最小值(艘数或时长,时长单位小时)|number| | max|最大值(艘数或时长,时长单位小时)|number| | avg|平均值(艘数或时长,时长单位小时)|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 2.17. 按港口代码查询在锚数量指标K线 **接口描述**:按港口代码查询在锚数量指标K线 **接口地址**:`/v1/mkt/ports/efficiency/moor-num/k` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |portCode|港口代码|body|true|string| |startTime|开始时间(yyyy-MM-dd HH:mm:ss)|body|false|string(date-time)| |endTime|结束时间(yyyy-MM-dd HH:mm:ss)|body|false|string(date-time)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | dateStr|指标日期字符串|string| | num|艘数|object| | open|开盘值|number| | close|收盘值|number| | min|最小值|number| | max|最大值|number| | avg|平均值|number| | mid|中位值|number| | dwt|载重吨|object| | open|开盘值|number| | close|收盘值|number| | min|最小值|number| | max|最大值|number| | avg|平均值|number| | mid|中位值|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 2.18. 按港口代码查询在泊数量指标K线 **接口描述**:按港口代码查询在泊数量指标K线 **接口地址**:`/v1/mkt/ports/efficiency/berth-num/k` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |portCode|港口代码|body|true|string| |startTime|开始时间(yyyy-MM-dd HH:mm:ss)|body|false|string(date-time)| |endTime|结束时间(yyyy-MM-dd HH:mm:ss)|body|false|string(date-time)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | dateStr|指标日期字符串|string| | num|艘数|object| | open|开盘值|number| | close|收盘值|number| | min|最小值|number| | max|最大值|number| | avg|平均值|number| | mid|中位值|number| | dwt|载重吨|object| | open|开盘值|number| | close|收盘值|number| | min|最小值|number| | max|最大值|number| | avg|平均值|number| | mid|中位值|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 2.19. 按港口代码查询在港数量指标K线 **接口描述**:按港口代码查询在港数量指标K线 **接口地址**:`/v1/mkt/ports/efficiency/stay-num/k` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |portCode|港口代码|body|true|string| |startTime|开始时间(yyyy-MM-dd HH:mm:ss)|body|false|string(date-time)| |endTime|结束时间(yyyy-MM-dd HH:mm:ss)|body|false|string(date-time)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | dateStr|指标日期字符串|string| | num|艘数|object| | open|开盘值|number| | close|收盘值|number| | min|最小值|number| | max|最大值|number| | avg|平均值|number| | mid|中位值|number| | dwt|载重吨|object| | open|开盘值|number| | close|收盘值|number| | min|最小值|number| | max|最大值|number| | avg|平均值|number| | mid|中位值|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 2.20. 按港口代码查询锚泊时长指标K线 **接口描述**:按港口代码查询锚泊时长指标K线 **接口地址**:`/v1/mkt/ports/efficiency/moor-duration/k` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |portCode|港口代码|body|true|string| |startTime|开始时间(yyyy-MM-dd HH:mm:ss)|body|false|string(date-time)| |endTime|结束时间(yyyy-MM-dd HH:mm:ss)|body|false|string(date-time)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | open|开盘值|number| | close|收盘值|number| | min|最小值|number| | max|最大值|number| | avg|平均值|number| | mid|中位值|number| | dateStr|指标日期|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 2.21. 按港口代码查询作业时长指标K线 **接口描述**:按港口代码查询作业时长指标K线 **接口地址**:`/v1/mkt/ports/efficiency/berth-duration/k` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |portCode|港口代码|body|true|string| |startTime|开始时间(yyyy-MM-dd HH:mm:ss)|body|false|string(date-time)| |endTime|结束时间(yyyy-MM-dd HH:mm:ss)|body|false|string(date-time)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | open|开盘值|number| | close|收盘值|number| | min|最小值|number| | max|最大值|number| | avg|平均值|number| | mid|中位值|number| | dateStr|指标日期|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 2.22. 按港口代码查询在港时长指标K线 **接口描述**:按港口代码查询在港时长指标K线 **接口地址**:`/v1/mkt/ports/efficiency/stay-duration/k` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |portCode|港口代码|body|true|string| |startTime|开始时间(yyyy-MM-dd HH:mm:ss)|body|false|string(date-time)| |endTime|结束时间(yyyy-MM-dd HH:mm:ss)|body|false|string(date-time)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | open|开盘值|number| | close|收盘值|number| | min|最小值|number| | max|最大值|number| | avg|平均值|number| | mid|中位值|number| | dateStr|指标日期|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 2.23. 按港口代码查询平均等泊时长指标K线 **接口描述**:按港口代码查询平均等泊时长指标K线 **接口地址**:`/v1/mkt/ports/efficiency/moor-avg/k` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |portCode|港口代码|body|true|string| |startTime|开始时间(yyyy-MM-dd HH:mm:ss)|body|false|string(date-time)| |endTime|结束时间(yyyy-MM-dd HH:mm:ss)|body|false|string(date-time)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | open|开盘值|number| | close|收盘值|number| | min|最小值|number| | max|最大值|number| | avg|平均值|number| | mid|中位值|number| | dateStr|指标日期|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 2.24. 按港口代码查询平均作业时长指标K线 **接口描述**:按港口代码查询平均作业时长指标K线 **接口地址**:`/v1/mkt/ports/efficiency/berth-avg/k` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |portCode|港口代码|body|true|string| |startTime|开始时间(yyyy-MM-dd HH:mm:ss)|body|false|string(date-time)| |endTime|结束时间(yyyy-MM-dd HH:mm:ss)|body|false|string(date-time)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | open|开盘值|number| | close|收盘值|number| | min|最小值|number| | max|最大值|number| | avg|平均值|number| | mid|中位值|number| | dateStr|指标日期|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 2.25. 按港口代码查询平均停留时长指标K线 **接口描述**:按港口代码查询平均停留时长指标K线 **接口地址**:`/v1/mkt/ports/efficiency/stay-avg/k` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |portCode|港口代码|body|true|string| |startTime|开始时间(yyyy-MM-dd HH:mm:ss)|body|false|string(date-time)| |endTime|结束时间(yyyy-MM-dd HH:mm:ss)|body|false|string(date-time)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | open|开盘值|number| | close|收盘值|number| | min|最小值|number| | max|最大值|number| | avg|平均值|number| | mid|中位值|number| | dateStr|指标日期|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 2.26. 按港口代码批量查询流量指标集合 **接口描述**:按港口代码批量查询流量指标集合 **接口地址**:`/v1/mkt/ports/efficiency/term` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |portCodes|港口代码列表|body|false|array[string]| |startTime|开始时间(yyyy-MM-dd HH:mm:ss)|body|false|string(date-time)| |endTime|结束时间(yyyy-MM-dd HH:mm:ss)|body|false|string(date-time)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | portCode|港口|string| | portNameCn|港口中文名|string| | portNameEn|港口英文名|string| | lon|港口中心点经度|number| | lat|港口中心点纬度|number| | ctryCode|港口国家代码|string| | ctryNameCn|港口国家中文名|string| | ctryNameEn|港口国家英文名|string| | averageMoorDurationAvg|平均港口等泊时间|number| | averageMoorNumAvg|平均港口等泊数量|number| | averageMoorDwtAvg|平均港口等泊载重吨|number| | averageBerthDurationAvg|平均港口靠泊时间|number| | averageBerthNumAvg|平均港口靠泊数量|number| | averageBerthDwtAvg|平均港口靠泊载重吨|number| | averageStayDurationAvg|平均港口停留时间|number| | averageStayNumAvg|平均港口停留船舶|number| | averageStayDwtAvg|平均港口作业载重吨|number| | moorDurationAvg|平均当前在锚时间|number| | berthDurationAvg|平均当前在泊时间|number| | stayDurationAvg|平均当前在港时间|number| | moorNumAvg|平均在锚数量|number| | moorDwtAvg|平均在锚载重吨|number| | berthNumAvg|平均在泊数量|number| | berthDwtAvg|平均在泊载重吨|number| | stayNumAvg|平均在港数量|number| | stayDwtAvg|平均在港载重吨|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 2.27. 按自定义区域查询港口基础信息 **接口描述**:按自定义区域查询港口基础信息 **接口地址**:`/v1/mkt/ports/region` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |region|区域对象(支持圆形、矩形及任意线段组合的多边形)|body|true|object| | regionType|对象类型, 区域查询时必填|body|false|string| | leftTop|矩形左上角坐标,regionType='rectangle'时必填|body|false|object| | lon|经度|body|false|number| | lat|纬度|body|false|number| | rightBottom|矩形右下角坐标,regionType='rectangle'时必填|body|false|object| | lon|经度|body|false|number| | lat|纬度|body|false|number| | center|圆心坐标,regionType='circle'时必填|body|false|object| | lon|经度|body|false|number| | lat|纬度|body|false|number| | radius|圆形半径(海里),regionType='circle'时必填|body|false|number| | points|多边形连续点,不少于三个,regionType='polygon'时必填|body|false|array[object]| | lon|经度|body|false|number| | lat|纬度|body|false|number| | moveAngle|扇形对角线方向(度),regionType='sector'时必填|body|false|number| | scaleAngle|扇形对角线方向单侧夹角(度),regionType='sector'时必填|body|false|number| |portCodes|港口代码列表|body|false|array[string]| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | portCode|港口代码|string| | nameCn|港口中文名|string| | nameEn|港口英文名|string| | aliasNames|港口曾用名|string| | portType|港口类型(B-基本港,T-普通码头,O-原油码头,F-浮仓)|string| | portTypeNameCn|港口类型中文描述|string| | portTypeNameEn|港口类型英文描述|string| | lon|港口经度|number| | lat|港口纬度|number| | tzOffset|港口时区|integer(int32)| | ctryCode|国家代码|string| | ctryNameCn|国家中文名|string| | ctryNameEn|国家英文名|string| | continentCode|洲代码|string| | continentNameCn|洲中文名|string| | continentNameEn|洲英文名|string| | tradeAreaCode|贸易区代码|string| | tradeAreaNameCn|贸易区中文名称|string| | tradeAreaNameEn|贸易区英文名称|string| | unlocode|unlocode|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 2.28. 根据港口代码查询历史天气 **接口描述**:根据港口代码查询历史天气 **接口地址**:`/v1/mkt/ports/weather/history` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |portCode|港口|body|true|string| |startTime|开始日期(港口当地时间)|body|true|string(date-time)| |endTime|结束日期(港口当地时间)|body|true|string(date-time)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | portCode|港口代码|string| | current|当前天气详情|object| | utcTime|数据UTC时间|string(date-time)| | localTime|数据当地时间|string(date-time)| | weatherLevel|港口作业气象等级(HEAVY:大雪、中雪、大雨、中雨,LIGHT:小雪、雪、 小雨、雨、 rain and snow,FINE:其他)|string| | pressure|气压|number| | humidity|湿度|number| | dewPoint|露水|number| | windSpeed|风速|number| | windSpeedLevel|风速等级|string| | windSpeedLevelCn|风速等级描述|string| | windDeg|风向|number| | windDegCn|风向描述|string| | windGust|风势|number| | weathers|天气详情数据|array[object]| | main|主要信息|string| | description|中文描述|string| | iconCode|图标原始代码|string| | iconData|图标原始数据(BASE64)|string| | descEn|图标英文名称|string| | descCn|图标中文名称|string| | fellLike|体感|object| | feelLike|当前/实时温度体感|number| | day|当天白天体感|number| | night|当天晚上体感|number| | eve|当天午夜体感|number| | morn|当天早晨体感|number| | temperature|温度|object| | temp|当前/实时气温|number| | tempMax|当前气温最大值(城区内可观测的温度最大值)|number| | tempMin|当前气温最小值(城区内可观测的温度最小值)|number| | day|当天白天气温|number| | night|当天晚上气温|number| | eve|当天午夜气温|number| | morn|当天早晨气温|number| | min|当天气温最小值|number| | max|当天气温最大值|number| | rain|降雨量|object| | rain1H|实时(1小时)降雨量|number| | rain|当天降雨量|number| | portCode|港口代码|string| | lon|港口经度|number| | lat|港口纬度|number| | utcDay|数据日期|integer(int32)| | sunrise|日出时间|string(date-time)| | sunset|日落时间|string(date-time)| | uvi|紫外线强度|number| | clouds|云|number| | visibility|可视度|number| | dailyTempMax|当日最高气温|number| | dailyTempMin|当日最低气温|number| | dailyRain|日降雨量|number| | dailyHumidity|日湿度|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 2.29. 按港口代码查询当日指标集合均值 **接口描述**:按港口代码查询当日指标集合均值 **接口地址**:`/v1/mkt/ports/efficiency/avg/full` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |portCode|港口代码|body|true|string| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | portCode|港口|string| | portNameCn|港口中文名|string| | portNameEn|港口英文名|string| | lon|港口中心点经度|number| | lat|港口中心点纬度|number| | ctryCode|港口国家代码|string| | ctryNameCn|港口国家中文名|string| | ctryNameEn|港口国家英文名|string| | averageMoorDurationAvg|平均港口等泊时间|number| | averageMoorNumAvg|平均港口等泊数量|number| | averageMoorDwtAvg|平均港口等泊载重吨|number| | averageBerthDurationAvg|平均港口靠泊时间|number| | averageBerthNumAvg|平均港口靠泊数量|number| | averageBerthDwtAvg|平均港口靠泊载重吨|number| | averageStayDurationAvg|平均港口停留时间|number| | averageStayNumAvg|平均港口停留船舶|number| | averageStayDwtAvg|平均港口作业载重吨|number| | moorDurationAvg|平均当前在锚时间|number| | berthDurationAvg|平均当前在泊时间|number| | stayDurationAvg|平均当前在港时间|number| | moorNumAvg|平均在锚数量|number| | moorDwtAvg|平均在锚载重吨|number| | berthNumAvg|平均在泊数量|number| | berthDwtAvg|平均在泊载重吨|number| | stayNumAvg|平均在港数量|number| | stayDwtAvg|平均在港载重吨|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 2.30. 按港口代码查询当日数量指标集合均值 **接口描述**:按港口代码查询当日锚泊指标集合均值 **接口地址**:`/v1/mkt/ports/efficiency/avg/num` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |portCode|港口代码|body|true|string| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | portCode|港口|string| | portNameCn|港口中文名|string| | portNameEn|港口英文名|string| | lon|港口中心点经度|number| | lat|港口中心点纬度|number| | ctryCode|港口国家代码|string| | ctryNameCn|港口国家中文名|string| | ctryNameEn|港口国家英文名|string| | averageMoorNumAvg|平均港口等泊数量|number| | averageBerthNumAvg|平均港口靠泊数量|number| | averageStayNumAvg|平均港口停留船舶|number| | moorNumAvg|平均在锚数量|number| | berthNumAvg|平均在泊数量|number| | stayNumAvg|平均在港数量|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 2.31. 按港口代码查询当日时长指标集合均值 **接口描述**:按港口代码查询当日作业指标集合均值 **接口地址**:`/v1/mkt/ports/efficiency/avg/duration` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |portCode|港口代码|body|true|string| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | portCode|港口|string| | portNameCn|港口中文名|string| | portNameEn|港口英文名|string| | lon|港口中心点经度|number| | lat|港口中心点纬度|number| | ctryCode|港口国家代码|string| | ctryNameCn|港口国家中文名|string| | ctryNameEn|港口国家英文名|string| | averageMoorDurationAvg|平均港口等泊时间|number| | averageBerthDurationAvg|平均港口靠泊时间|number| | averageStayDurationAvg|平均港口停留时间|number| | moorDurationAvg|平均当前在锚时间|number| | berthDurationAvg|平均当前在泊时间|number| | stayDurationAvg|平均当前在港时间|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 2.32. 按港口代码查询当日载重吨指标集合均值 **接口描述**:按港口代码查询当日停留指标集合均值 **接口地址**:`/v1/mkt/ports/efficiency/avg/dwt` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |portCode|港口代码|body|true|string| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | portCode|港口|string| | portNameCn|港口中文名|string| | portNameEn|港口英文名|string| | lon|港口中心点经度|number| | lat|港口中心点纬度|number| | ctryCode|港口国家代码|string| | ctryNameCn|港口国家中文名|string| | ctryNameEn|港口国家英文名|string| | averageMoorDwtAvg|平均港口等泊载重吨|number| | averageBerthDwtAvg|平均港口靠泊载重吨|number| | averageStayDwtAvg|平均港口作业载重吨|number| | moorDwtAvg|平均在锚载重吨|number| | berthDwtAvg|平均在泊载重吨|number| | stayDwtAvg|平均在港载重吨|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 2.33. 按动态查询港口当前船舶数量 **接口描述**:按动态查询港口当前船舶数量,主要包括预抵、锚泊、靠泊、修理等【港口-港口动态】 **接口地址**:`/v1/mkt/ports/dynamics/new` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |portCodes|港口代码列表|body|false|array[string]| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | portCode|港口代码|string| | estimate|预抵数量|integer(int32)| | moor|锚泊(港口)数量|integer(int32)| | moorHalfway|锚泊(途中)数量|integer(int32)| | sail|航线(港口)数量|integer(int32)| | berth|靠泊数量|integer(int32)| | repair|修理数量|integer(int32)| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ## 3. API市场-船舶数据接口 ### 3.1. 按船名MMSI等信息模糊检索船舶 **接口描述**:按船名MMSI等信息模糊检索船舶 **接口地址**:`/v1/mkt/vessels/fuzzy` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |kw|查询关键字|body|true|string| |recordNum|返回记录条数|body|false|integer(int32)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | mmsi|船舶MMSI|integer(int32)| | imo|船舶IMO|string| | callsign|船舶呼号|string| | nameEn|船舶英文名|string| | nameCn|船舶中文名|string| | vesselType|一级船型|string| | vesselTypeNameCn|一级船型中文名|string| | vesselTypeNameEn|一级船型英文名|string| | vesselSubType|二级船型|string| | vesselSubTypeNameCn|二级船型中文名|string| | vesselSubTypeNameEn|二级船型英文名|string| | vesselSub2Type|三级船型|string| | vesselSub2TypeNameCn|三级船型中文名|string| | vesselSub2TypeNameEn|三级船型英文名|string| | flagCtry|船旗国|string| | flagCtryNameCn|船旗国中文名|string| | flagCtryNameEn|船旗国英文名|string| | retireYearMonth|失效时间|integer(int32)| | postime|记录时间|string(date-time)| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 3.2. 按MMSI查询船舶基础信息 **接口描述**:按MMSI查询船舶基础信息 **接口地址**:`/v1/mkt/vessels/detail/mmsi` **请求方式**:`GET` **请求数据类型**: **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | | mmsi | mmsi | query | true | integer(int32) | **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | mmsi|船舶MMSI|integer(int32)| | imo|船舶IMO|string| | callsign|船舶呼号|string| | nameEn|船舶英文名|string| | nameCn|船舶中文名|string| | vesselType|一级船型|string| | vesselTypeNameCn|一级船型中文名|string| | vesselTypeNameEn|一级船型英文名|string| | vesselSubType|二级船型|string| | vesselSubTypeNameCn|二级船型中文名|string| | vesselSubTypeNameEn|二级船型英文名|string| | vesselSub2Type|三级船型|string| | vesselSub2TypeNameCn|三级船型中文名|string| | vesselSub2TypeNameEn|三级船型英文名|string| | flagCtry|船旗国|string| | flagCtryNameCn|船旗国中文名|string| | flagCtryNameEn|船旗国英文名|string| | classSociety|船级社|string| | classSocietyNameCn|船级社中文名|string| | classSocietyNameEn|船级社英文名|string| | buildYearMonth|建造年月|string| | retireYearMonth|失效时间|integer(int32)| | preMmsi|前任MMSI|integer(int32)| | nextMmsi|后任MMSI|integer(int32)| | registryPort|船籍港|string| | dwt|载重吨(吨)|integer(int32)| | grt|总吨|integer(int32)| | net|净吨|integer(int32)| | teu|载箱数|integer(int32)| | liquid|液体体积(立方米)|integer(int32)| | gas|气体体积(立方米)|integer(int32)| | length|船长(米)|number| | width|船宽(米)|number| | height|船高(米)|number| | draught|设计吃水(米)|number| | speed|设计航速(节)|number| | numberofcars|载车数|integer(int32)| | passengercapacity|载客数|integer(int32)| | operatorBody|经营主体英文名|string| | operatorBodyCn|经营主体中文名|string| | manageBody|管理主体英文名|string| | manageBodyCn|管理主体中文名|string| | ownerBody|所有者主体英文名|string| | ownerBodyCn|所有者主体中文名|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 3.3. 按IMO查询船舶基础信息 **接口描述**:按IMO查询船舶基础信息 **接口地址**:`/v1/mkt/vessels/detail/imo` **请求方式**:`GET` **请求数据类型**: **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | | imo | imo | query | true | string | **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | mmsi|船舶MMSI|integer(int32)| | imo|船舶IMO|string| | callsign|船舶呼号|string| | nameEn|船舶英文名|string| | nameCn|船舶中文名|string| | vesselType|一级船型|string| | vesselTypeNameCn|一级船型中文名|string| | vesselTypeNameEn|一级船型英文名|string| | vesselSubType|二级船型|string| | vesselSubTypeNameCn|二级船型中文名|string| | vesselSubTypeNameEn|二级船型英文名|string| | vesselSub2Type|三级船型|string| | vesselSub2TypeNameCn|三级船型中文名|string| | vesselSub2TypeNameEn|三级船型英文名|string| | flagCtry|船旗国|string| | flagCtryNameCn|船旗国中文名|string| | flagCtryNameEn|船旗国英文名|string| | classSociety|船级社|string| | classSocietyNameCn|船级社中文名|string| | classSocietyNameEn|船级社英文名|string| | buildYearMonth|建造年月|string| | retireYearMonth|失效时间|integer(int32)| | preMmsi|前任MMSI|integer(int32)| | nextMmsi|后任MMSI|integer(int32)| | registryPort|船籍港|string| | dwt|载重吨(吨)|integer(int32)| | grt|总吨|integer(int32)| | net|净吨|integer(int32)| | teu|载箱数|integer(int32)| | liquid|液体体积(立方米)|integer(int32)| | gas|气体体积(立方米)|integer(int32)| | length|船长(米)|number| | width|船宽(米)|number| | height|船高(米)|number| | draught|设计吃水(米)|number| | speed|设计航速(节)|number| | numberofcars|载车数|integer(int32)| | passengercapacity|载客数|integer(int32)| | operatorBody|经营主体英文名|string| | operatorBodyCn|经营主体中文名|string| | manageBody|管理主体英文名|string| | manageBodyCn|管理主体中文名|string| | ownerBody|所有者主体英文名|string| | ownerBodyCn|所有者主体中文名|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 3.4. 按MMSI查询船舶实时动态信息 **接口描述**:按MMSI查询船舶实时动态信息 **接口地址**:`/v1/mkt/vessels/status/current` **请求方式**:`GET` **请求数据类型**: **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | | mmsi | mmsi | query | true | integer(int32) | **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | mmsi|船舶MMSI|integer(int32)| | dynamicType|一级动态类型: 0-航行,1-锚泊,5-靠泊,6-搁浅|string| | dynamicSubType|二级动态类型: 00-航行(途中),01-航行(到港),10-锚泊(途中),11-锚泊(到港),50-靠泊(作业),51-靠泊(修理),60-搁浅|string| | legStartPortCode|启运港|string| | legStartPortNameCn|启运港中文名|string| | legStartPortNameEn|启运港英文名|string| | legStartPortCtryCode|启运港国家|string| | legStartPortCtryNameCn|启运港国家中文名|string| | legStartPortCtryNameEn|启运港国家英文名|string| | legEndPortCode|目的港|string| | legEndPortNameCn|目的港中文名|string| | legEndPortNameEn|目的港英文名|string| | legEndPortCtryCode|目的港国家|string| | legEndPortCtryNameCn|目的港国家中文名|string| | legEndPortCtryNameEn|目的港国家英文名|string| | legStartTime|航段开始时间|string(date-time)| | legStartTimeLocal|航段开始时间(LT)|string(date-time)| | legEndTime|航段结束时间|string(date-time)| | legEndTimeLocal|航段结束时间(LT)|string(date-time)| | arrivalTime|船舶到港时间|string(date-time)| | arrivalTimeLocal|船舶到港时间(LT)|string(date-time)| | startPostime|当前动态形成时间|string(date-time)| | startPostimeLocal|当前动态形成时间(LT)|string(date-time)| | sailDuration|航行时长(小时)|number| | sailDistance|航行里程(海里)|number| | averageSpeed|平均航速(节)|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 3.5. 按MMSI查询船舶历史动态信息 **接口描述**:按MMSI查询船舶历史动态信息 **接口地址**:`/v1/mkt/vessels/status/history` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |mmsi|船舶MMSI|body|true|integer(int32)| |startTime|开始时间(yyyy-MM-dd HH:mm:ss)|body|true|string(date-time)| |endTime|结束时间(yyyy-MM-dd HH:mm:ss)|body|true|string(date-time)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | mmsi|船舶MMSI|integer(int32)| | legStartPortCode|启运港|string| | legStartPortNameCn|启运港中文名|string| | legStartPortNameEn|启运港英文名|string| | legStartPortCtryCode|启运港国家|string| | legStartPortCtryNameCn|启运港国家中文名|string| | legStartPortCtryNameEn|启运港国家英文名|string| | legEndPortCode|目的港|string| | legEndPortNameCn|目的港中文名|string| | legEndPortNameEn|目的港英文名|string| | legEndPortCtryCode|目的港国家|string| | legEndPortCtryNameCn|目的港国家中文名|string| | legEndPortCtryNameEn|目的港国家英文名|string| | legStartTime|航段开始时间|string(date-time)| | legStartTimeLocal|航段开始时间(LT)|string(date-time)| | arrivalTime|到港时间|string(date-time)| | arrivalTimeLocal|到港时间(LT)|string(date-time)| | berthTime|靠泊时间|string(date-time)| | berthTimeLocal|靠泊时间(LT)|string(date-time)| | legEndTime|航段结束时间|string(date-time)| | legEndTimeLocal|航段结束时间(LT)|string(date-time)| | sailDuration|航行时长(小时)|number| | sailDistance|航行里程(海里)|number| | averageSpeed|平均航速(节)|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 3.6. 按MMSI批量查询船舶航行统计摘要信息 **接口描述**:按MMSI批量查询船舶航行统计摘要信息 **接口地址**:`/v1/mkt/vessels/analytics/summary` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |mmsiList|MMSI列表|body|false|array[integer(int32)]| |startYearMonth|统计开始月份,格式yyyyMM|body|true|string| |endYearMonth|统计结束月份,格式yyyyMM|body|true|string| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | berthDuration|靠泊时间|number| | berthTimes|靠泊次数|integer(int32)| | moorDurationPort|港内锚泊时间|number| | moorDurationHalfway|港外锚泊时间|number| | sailDuration|航行时间|number| | sailDistance|航行里程|number| | aisAbnormalDuration|异常时间|number| | strandedDuration|搁浅时间|number| | sailRate|航行占比,航行时间/(航行时间+港内锚泊时间+港外锚泊时间+靠泊时间+搁浅时间+异常时间)|string| | moorDurationPortRate|港内锚泊占比,港内锚泊时间/(航行时间+港内锚泊时间+港外锚泊时间+靠泊时间+搁浅时间+异常时间)|string| | moorDurationHalfwayRate|港外锚泊占比,港外锚泊时间/(航行时间+港内锚泊时间+港外锚泊时间+靠泊时间+搁浅时间+异常时间)|string| | berthRate|靠泊占比,靠泊时间/(航行时间+港内锚泊时间+港外锚泊时间+靠泊时间+搁浅时间+异常时间)|string| | strandedRate|搁浅占比,搁浅时间/(航行时间+港内锚泊时间+港外锚泊时间+靠泊时间+搁浅时间+异常时间)|string| | aisAbnormalRate|异常占比,异常时间/(航行时间+港内锚泊时间+港外锚泊时间+靠泊时间+搁浅时间+异常时间)|string| | avgSpeed|平均航速,航行距离/航行时间|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 3.7. 按MMSI批量查询船舶航行统计信息(按港口) **接口描述**:按MMSI批量查询船舶航行统计(按港口) **接口地址**:`/v1/mkt/vessels/analytics/calls` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |mmsiList|MMSI列表|body|false|array[integer(int32)]| |startTime|开始时间|body|true|string(date-time)| |endTime|结束时间|body|true|string(date-time)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | portNum|挂靠港口数|integer(int32)| | berthTimes|挂靠次数|integer(int32)| | berthDirectTimes|直挂次数|integer(int32)| | countryNum|国家/地区次数|integer(int32)| | fullLoadTimes|港口卸货次数|integer(int32)| | emptyLoadTimes|港口装货次数|integer(int32)| | callDetail|统计分析|array[object]| | portCode|港口代码|string| | portNameCn|中文名|string| | portNameEn|英文名|string| | portCtryCode|港口国家代码|string| | portCtryNameCn|港口国家中文名|string| | portCtryNameEn|港口国家英文名|string| | lastBerthDate|最后挂靠时间|string(date-time)| | berthTimes|挂靠次数|integer(int32)| | berthDirectTimes|直挂次数|integer(int32)| | fullLoadTimes|港口卸货次数|integer(int32)| | emptyLoadTimes|港口装货次数|integer(int32)| | averageMoorDuration|平均锚泊时长(小时)|number| | averageBerthDuration|平均作业时长(小时)|number| | averageOnPortDuration|平均在港时长(小时)|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 3.8. 按MMSI批量查询船舶航行统计信息(按航段) **接口描述**:按MMSI批量查询船舶航行统计(按航段) **接口地址**:`/v1/mkt/vessels/analytics/leg` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |mmsiList|MMSI列表|body|false|array[integer(int32)]| |startTime|开始时间|body|true|string(date-time)| |endTime|结束时间|body|true|string(date-time)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | legStartPortCode|启运港|string| | legStartPortNameCn|启运港中文名|string| | legStartPortNameEn|启运港英文名|string| | legStartPortCtryCode|启运港国家|string| | legEndPortCode|目的港|string| | legEndPortNameCn|目的港中文名|string| | legEndPortNameEn|目的港英文名|string| | legEndPortCtryCode|目的港国家|string| | amount|航行次数|integer(int32)| | maxSailingDistance|最长航程(海里)|number| | minSailingDistance|最短航程(海里)|number| | avgSailingDistance|总平均航程(海里)|number| | avgSailingDuration|总平均航时(小时)|number| | avgSailingSpeed|总平均航速(节)|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 3.9. 按MMSI批量查询船舶维修明细 **接口描述**:按MMSI批量查询船舶维修明细 **接口地址**:`/v1/mkt/vessels/analytics/repair` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |mmsiList|MMSI列表|body|false|array[integer(int32)]| |startTime|开始时间|body|true|string(date-time)| |endTime|结束时间|body|true|string(date-time)| |portCodes|修理港代码|body|true|array[string]| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | mmsi|维修船舶MMSI|integer(int32)| | vesselDetail|维修船舶详情|object| | mmsi|船舶MMSI|integer(int32)| | imo|船舶IMO|string| | callsign|船舶呼号|string| | nameEn|船舶英文名|string| | nameCn|船舶中文名|string| | vesselType|一级船型|string| | vesselTypeNameCn|一级船型中文名|string| | vesselTypeNameEn|一级船型英文名|string| | vesselSubType|二级船型|string| | vesselSubTypeNameCn|二级船型中文名|string| | vesselSubTypeNameEn|二级船型英文名|string| | vesselSub2Type|三级船型|string| | vesselSub2TypeNameCn|三级船型中文名|string| | vesselSub2TypeNameEn|三级船型英文名|string| | flagCtry|船旗国|string| | flagCtryNameCn|船旗国中文名|string| | flagCtryNameEn|船旗国英文名|string| | classSociety|船级社|string| | classSocietyNameCn|船级社中文名|string| | classSocietyNameEn|船级社英文名|string| | buildYearMonth|建造年月|string| | retireYearMonth|失效时间|integer(int32)| | preMmsi|前任MMSI|integer(int32)| | nextMmsi|后任MMSI|integer(int32)| | registryPort|船籍港|string| | dwt|载重吨(吨)|integer(int32)| | grt|总吨|integer(int32)| | net|净吨|integer(int32)| | teu|载箱数|integer(int32)| | liquid|液体体积(立方米)|integer(int32)| | gas|气体体积(立方米)|integer(int32)| | length|船长(米)|number| | width|船宽(米)|number| | height|船高(米)|number| | draught|设计吃水(米)|number| | speed|设计航速(节)|number| | numberofcars|载车数|integer(int32)| | passengercapacity|载客数|integer(int32)| | operatorBody|经营主体英文名|string| | operatorBodyCn|经营主体中文名|string| | manageBody|管理主体英文名|string| | manageBodyCn|管理主体中文名|string| | ownerBody|所有者主体英文名|string| | ownerBodyCn|所有者主体中文名|string| | startTime|开始修理时间|string(date-time)| | endTime|结束修理时间|string(date-time)| | portCode|港口代码|string| | portDetail|维修港口信息|object| | portCode|港口代码|string| | nameCn|港口中文名|string| | nameEn|港口英文名|string| | aliasNames|港口曾用名|string| | portType|港口类型(B-基本港,T-普通码头,O-原油码头,F-浮仓)|string| | portTypeNameCn|港口类型中文描述|string| | portTypeNameEn|港口类型英文描述|string| | lon|港口经度|number| | lat|港口纬度|number| | tzOffset|港口时区|integer(int32)| | ctryCode|国家代码|string| | ctryNameCn|国家中文名|string| | ctryNameEn|国家英文名|string| | continentCode|洲代码|string| | continentNameCn|洲中文名|string| | continentNameEn|洲英文名|string| | tradeAreaCode|贸易区代码|string| | tradeAreaNameCn|贸易区中文名称|string| | tradeAreaNameEn|贸易区英文名称|string| | unlocode|unlocode|string| | berthUuid|维修泊位UUID|string| | berthNameCn|泊位中文名称|string| | berthNameEn|泊位英文名称|string| | startLon|开始维修位置经度|number| | startLat|开始维修位置纬度|number| | dockUuid|船坞UUID|string| | dockNameCn|船坞中文名称|string| | dockNameEn|船坞英文名称|string| | shipyardUuid|修理厂UUID|string| | shipyardNameCn|修理厂中文名称|string| | shipyardNameEn|修理厂英文名称|string| | repairTypeCn|中文修理类型|string| | repairTypeEn|英文修理类型|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 3.10. 按MMSI批量查询船舶加油明细 **接口描述**:按MMSI批量查询船舶加油明细 **接口地址**:`/v1/mkt/vessels/analytics/refuel` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |mmsiList|MMSI列表|body|false|array[integer(int32)]| |startTime|开始时间|body|true|string(date-time)| |endTime|结束时间|body|true|string(date-time)| |querySupplyShip|是否查询供油船 true 查询供油船 false 查询被供油船 |body|false|boolean| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | consumeMmsi|船舶MMSI|integer(int32)| | supplyMmsi|供油船MMSI|integer(int32)| | consumeVessel|船舶详情|object| | mmsi|船舶MMSI|integer(int32)| | imo|船舶IMO|string| | callsign|船舶呼号|string| | nameEn|船舶英文名|string| | nameCn|船舶中文名|string| | vesselType|一级船型|string| | vesselTypeNameCn|一级船型中文名|string| | vesselTypeNameEn|一级船型英文名|string| | vesselSubType|二级船型|string| | vesselSubTypeNameCn|二级船型中文名|string| | vesselSubTypeNameEn|二级船型英文名|string| | vesselSub2Type|三级船型|string| | vesselSub2TypeNameCn|三级船型中文名|string| | vesselSub2TypeNameEn|三级船型英文名|string| | flagCtry|船旗国|string| | flagCtryNameCn|船旗国中文名|string| | flagCtryNameEn|船旗国英文名|string| | classSociety|船级社|string| | classSocietyNameCn|船级社中文名|string| | classSocietyNameEn|船级社英文名|string| | buildYearMonth|建造年月|string| | retireYearMonth|失效时间|integer(int32)| | preMmsi|前任MMSI|integer(int32)| | nextMmsi|后任MMSI|integer(int32)| | registryPort|船籍港|string| | dwt|载重吨(吨)|integer(int32)| | grt|总吨|integer(int32)| | net|净吨|integer(int32)| | teu|载箱数|integer(int32)| | liquid|液体体积(立方米)|integer(int32)| | gas|气体体积(立方米)|integer(int32)| | length|船长(米)|number| | width|船宽(米)|number| | height|船高(米)|number| | draught|设计吃水(米)|number| | speed|设计航速(节)|number| | numberofcars|载车数|integer(int32)| | passengercapacity|载客数|integer(int32)| | operatorBody|经营主体英文名|string| | operatorBodyCn|经营主体中文名|string| | manageBody|管理主体英文名|string| | manageBodyCn|管理主体中文名|string| | ownerBody|所有者主体英文名|string| | ownerBodyCn|所有者主体中文名|string| | supplyVessel|供油船详情|object| | mmsi|船舶MMSI|integer(int32)| | imo|船舶IMO|string| | callsign|船舶呼号|string| | nameEn|船舶英文名|string| | nameCn|船舶中文名|string| | vesselType|一级船型|string| | vesselTypeNameCn|一级船型中文名|string| | vesselTypeNameEn|一级船型英文名|string| | vesselSubType|二级船型|string| | vesselSubTypeNameCn|二级船型中文名|string| | vesselSubTypeNameEn|二级船型英文名|string| | vesselSub2Type|三级船型|string| | vesselSub2TypeNameCn|三级船型中文名|string| | vesselSub2TypeNameEn|三级船型英文名|string| | flagCtry|船旗国|string| | flagCtryNameCn|船旗国中文名|string| | flagCtryNameEn|船旗国英文名|string| | classSociety|船级社|string| | classSocietyNameCn|船级社中文名|string| | classSocietyNameEn|船级社英文名|string| | buildYearMonth|建造年月|string| | retireYearMonth|失效时间|integer(int32)| | preMmsi|前任MMSI|integer(int32)| | nextMmsi|后任MMSI|integer(int32)| | registryPort|船籍港|string| | dwt|载重吨(吨)|integer(int32)| | grt|总吨|integer(int32)| | net|净吨|integer(int32)| | teu|载箱数|integer(int32)| | liquid|液体体积(立方米)|integer(int32)| | gas|气体体积(立方米)|integer(int32)| | length|船长(米)|number| | width|船宽(米)|number| | height|船高(米)|number| | draught|设计吃水(米)|number| | speed|设计航速(节)|number| | numberofcars|载车数|integer(int32)| | passengercapacity|载客数|integer(int32)| | operatorBody|经营主体英文名|string| | operatorBodyCn|经营主体中文名|string| | manageBody|管理主体英文名|string| | manageBodyCn|管理主体中文名|string| | ownerBody|所有者主体英文名|string| | ownerBodyCn|所有者主体中文名|string| | eventStartTime|加油开始时间|string(date-time)| | eventEndTime|加油结束时间|string(date-time)| | refuelCapacity|加油量(吨)|number| | portDetail|加油船所属港口信息|object| | portCode|港口代码|string| | nameCn|港口中文名|string| | nameEn|港口英文名|string| | aliasNames|港口曾用名|string| | portType|港口类型(B-基本港,T-普通码头,O-原油码头,F-浮仓)|string| | portTypeNameCn|港口类型中文描述|string| | portTypeNameEn|港口类型英文描述|string| | lon|港口经度|number| | lat|港口纬度|number| | tzOffset|港口时区|integer(int32)| | ctryCode|国家代码|string| | ctryNameCn|国家中文名|string| | ctryNameEn|国家英文名|string| | continentCode|洲代码|string| | continentNameCn|洲中文名|string| | continentNameEn|洲英文名|string| | tradeAreaCode|贸易区代码|string| | tradeAreaNameCn|贸易区中文名称|string| | tradeAreaNameEn|贸易区英文名称|string| | unlocode|unlocode|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 3.11. 按MMSI批量查询船舶托轮明细 **接口描述**:按MMSI批量查询船舶托轮明细 **接口地址**:`/v1/mkt/vessels/analytics/tug` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |mmsiList|MMSI列表|body|false|array[integer(int32)]| |startTime|开始时间|body|true|string(date-time)| |endTime|结束时间|body|true|string(date-time)| |querySupplyShip|是否查询拖轮船(true:查询拖轮船,false:查询被拖轮船)|body|false|boolean| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | consumeMmsi|船舶MMSI|integer(int32)| | tugMmsi|拖轮MMSI|integer(int32)| | consumeVessel|船舶详情|object| | mmsi|船舶MMSI|integer(int32)| | imo|船舶IMO|string| | callsign|船舶呼号|string| | nameEn|船舶英文名|string| | nameCn|船舶中文名|string| | vesselType|一级船型|string| | vesselTypeNameCn|一级船型中文名|string| | vesselTypeNameEn|一级船型英文名|string| | vesselSubType|二级船型|string| | vesselSubTypeNameCn|二级船型中文名|string| | vesselSubTypeNameEn|二级船型英文名|string| | vesselSub2Type|三级船型|string| | vesselSub2TypeNameCn|三级船型中文名|string| | vesselSub2TypeNameEn|三级船型英文名|string| | flagCtry|船旗国|string| | flagCtryNameCn|船旗国中文名|string| | flagCtryNameEn|船旗国英文名|string| | classSociety|船级社|string| | classSocietyNameCn|船级社中文名|string| | classSocietyNameEn|船级社英文名|string| | buildYearMonth|建造年月|string| | retireYearMonth|失效时间|integer(int32)| | preMmsi|前任MMSI|integer(int32)| | nextMmsi|后任MMSI|integer(int32)| | registryPort|船籍港|string| | dwt|载重吨(吨)|integer(int32)| | grt|总吨|integer(int32)| | net|净吨|integer(int32)| | teu|载箱数|integer(int32)| | liquid|液体体积(立方米)|integer(int32)| | gas|气体体积(立方米)|integer(int32)| | length|船长(米)|number| | width|船宽(米)|number| | height|船高(米)|number| | draught|设计吃水(米)|number| | speed|设计航速(节)|number| | numberofcars|载车数|integer(int32)| | passengercapacity|载客数|integer(int32)| | operatorBody|经营主体英文名|string| | operatorBodyCn|经营主体中文名|string| | manageBody|管理主体英文名|string| | manageBodyCn|管理主体中文名|string| | ownerBody|所有者主体英文名|string| | ownerBodyCn|所有者主体中文名|string| | tugVessel|拖轮船舶详情|object| | mmsi|船舶MMSI|integer(int32)| | imo|船舶IMO|string| | callsign|船舶呼号|string| | nameEn|船舶英文名|string| | nameCn|船舶中文名|string| | vesselType|一级船型|string| | vesselTypeNameCn|一级船型中文名|string| | vesselTypeNameEn|一级船型英文名|string| | vesselSubType|二级船型|string| | vesselSubTypeNameCn|二级船型中文名|string| | vesselSubTypeNameEn|二级船型英文名|string| | vesselSub2Type|三级船型|string| | vesselSub2TypeNameCn|三级船型中文名|string| | vesselSub2TypeNameEn|三级船型英文名|string| | flagCtry|船旗国|string| | flagCtryNameCn|船旗国中文名|string| | flagCtryNameEn|船旗国英文名|string| | classSociety|船级社|string| | classSocietyNameCn|船级社中文名|string| | classSocietyNameEn|船级社英文名|string| | buildYearMonth|建造年月|string| | retireYearMonth|失效时间|integer(int32)| | preMmsi|前任MMSI|integer(int32)| | nextMmsi|后任MMSI|integer(int32)| | registryPort|船籍港|string| | dwt|载重吨(吨)|integer(int32)| | grt|总吨|integer(int32)| | net|净吨|integer(int32)| | teu|载箱数|integer(int32)| | liquid|液体体积(立方米)|integer(int32)| | gas|气体体积(立方米)|integer(int32)| | length|船长(米)|number| | width|船宽(米)|number| | height|船高(米)|number| | draught|设计吃水(米)|number| | speed|设计航速(节)|number| | numberofcars|载车数|integer(int32)| | passengercapacity|载客数|integer(int32)| | operatorBody|经营主体英文名|string| | operatorBodyCn|经营主体中文名|string| | manageBody|管理主体英文名|string| | manageBodyCn|管理主体中文名|string| | ownerBody|所有者主体英文名|string| | ownerBodyCn|所有者主体中文名|string| | eventStartTime|拖轮作业开始时间|string(date-time)| | eventEndTime|拖轮作业结束时间|string(date-time)| | portDetail|拖轮作业附近港口信息|object| | portCode|港口代码|string| | nameCn|港口中文名|string| | nameEn|港口英文名|string| | aliasNames|港口曾用名|string| | portType|港口类型(B-基本港,T-普通码头,O-原油码头,F-浮仓)|string| | portTypeNameCn|港口类型中文描述|string| | portTypeNameEn|港口类型英文描述|string| | lon|港口经度|number| | lat|港口纬度|number| | tzOffset|港口时区|integer(int32)| | ctryCode|国家代码|string| | ctryNameCn|国家中文名|string| | ctryNameEn|国家英文名|string| | continentCode|洲代码|string| | continentNameCn|洲中文名|string| | continentNameEn|洲英文名|string| | tradeAreaCode|贸易区代码|string| | tradeAreaNameCn|贸易区中文名称|string| | tradeAreaNameEn|贸易区英文名称|string| | unlocode|unlocode|string| | totalhorsepowerofmainengines|拖轮总马力|integer(int64)| | tugDuration|拖行时长(小时)|number(double)| | tugDistance|拖行距离(海里)|number(double)| | tugStatus|拖行状态|string| | tugStatusNameCn|拖行状态中文名称|string| | tugStatusNameEn|拖行状态英文名称|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 3.12. 按MMSI批量查询装卸货明细 **接口描述**:按MMSI批量查询装卸货明细 **接口地址**:`/v1/mkt/vessels/analytics/load` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |mmsiList|MMSI列表|body|false|array[integer(int32)]| |startTime|开始时间|body|true|string(date-time)| |endTime|结束时间|body|true|string(date-time)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | mmsi|船舶MMSI|integer(int32)| | mmsi2|对手船舶MMSI|integer(int32)| | vessel|船舶详情|object| | mmsi|船舶MMSI|integer(int32)| | imo|船舶IMO|string| | callsign|船舶呼号|string| | nameEn|船舶英文名|string| | nameCn|船舶中文名|string| | vesselType|一级船型|string| | vesselTypeNameCn|一级船型中文名|string| | vesselTypeNameEn|一级船型英文名|string| | vesselSubType|二级船型|string| | vesselSubTypeNameCn|二级船型中文名|string| | vesselSubTypeNameEn|二级船型英文名|string| | vesselSub2Type|三级船型|string| | vesselSub2TypeNameCn|三级船型中文名|string| | vesselSub2TypeNameEn|三级船型英文名|string| | flagCtry|船旗国|string| | flagCtryNameCn|船旗国中文名|string| | flagCtryNameEn|船旗国英文名|string| | classSociety|船级社|string| | classSocietyNameCn|船级社中文名|string| | classSocietyNameEn|船级社英文名|string| | buildYearMonth|建造年月|string| | retireYearMonth|失效时间|integer(int32)| | preMmsi|前任MMSI|integer(int32)| | nextMmsi|后任MMSI|integer(int32)| | registryPort|船籍港|string| | dwt|载重吨(吨)|integer(int32)| | grt|总吨|integer(int32)| | net|净吨|integer(int32)| | teu|载箱数|integer(int32)| | liquid|液体体积(立方米)|integer(int32)| | gas|气体体积(立方米)|integer(int32)| | length|船长(米)|number| | width|船宽(米)|number| | height|船高(米)|number| | draught|设计吃水(米)|number| | speed|设计航速(节)|number| | numberofcars|载车数|integer(int32)| | passengercapacity|载客数|integer(int32)| | operatorBody|经营主体英文名|string| | operatorBodyCn|经营主体中文名|string| | manageBody|管理主体英文名|string| | manageBodyCn|管理主体中文名|string| | ownerBody|所有者主体英文名|string| | ownerBodyCn|所有者主体中文名|string| | vessel2|对手船舶详情|object| | mmsi|船舶MMSI|integer(int32)| | imo|船舶IMO|string| | callsign|船舶呼号|string| | nameEn|船舶英文名|string| | nameCn|船舶中文名|string| | vesselType|一级船型|string| | vesselTypeNameCn|一级船型中文名|string| | vesselTypeNameEn|一级船型英文名|string| | vesselSubType|二级船型|string| | vesselSubTypeNameCn|二级船型中文名|string| | vesselSubTypeNameEn|二级船型英文名|string| | vesselSub2Type|三级船型|string| | vesselSub2TypeNameCn|三级船型中文名|string| | vesselSub2TypeNameEn|三级船型英文名|string| | flagCtry|船旗国|string| | flagCtryNameCn|船旗国中文名|string| | flagCtryNameEn|船旗国英文名|string| | classSociety|船级社|string| | classSocietyNameCn|船级社中文名|string| | classSocietyNameEn|船级社英文名|string| | buildYearMonth|建造年月|string| | retireYearMonth|失效时间|integer(int32)| | preMmsi|前任MMSI|integer(int32)| | nextMmsi|后任MMSI|integer(int32)| | registryPort|船籍港|string| | dwt|载重吨(吨)|integer(int32)| | grt|总吨|integer(int32)| | net|净吨|integer(int32)| | teu|载箱数|integer(int32)| | liquid|液体体积(立方米)|integer(int32)| | gas|气体体积(立方米)|integer(int32)| | length|船长(米)|number| | width|船宽(米)|number| | height|船高(米)|number| | draught|设计吃水(米)|number| | speed|设计航速(节)|number| | numberofcars|载车数|integer(int32)| | passengercapacity|载客数|integer(int32)| | operatorBody|经营主体英文名|string| | operatorBodyCn|经营主体中文名|string| | manageBody|管理主体英文名|string| | manageBodyCn|管理主体中文名|string| | ownerBody|所有者主体英文名|string| | ownerBodyCn|所有者主体中文名|string| | eventStartTime|装卸货开始时间|string(date-time)| | eventEndTime|装卸货结束时间|string(date-time)| | portDetail|装卸货作业附近港口信息|object| | portCode|港口代码|string| | nameCn|港口中文名|string| | nameEn|港口英文名|string| | aliasNames|港口曾用名|string| | portType|港口类型(B-基本港,T-普通码头,O-原油码头,F-浮仓)|string| | portTypeNameCn|港口类型中文描述|string| | portTypeNameEn|港口类型英文描述|string| | lon|港口经度|number| | lat|港口纬度|number| | tzOffset|港口时区|integer(int32)| | ctryCode|国家代码|string| | ctryNameCn|国家中文名|string| | ctryNameEn|国家英文名|string| | continentCode|洲代码|string| | continentNameCn|洲中文名|string| | continentNameEn|洲英文名|string| | tradeAreaCode|贸易区代码|string| | tradeAreaNameCn|贸易区中文名称|string| | tradeAreaNameEn|贸易区英文名称|string| | unlocode|unlocode|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ## 4. API市场-航线网络数据接口 ### 4.1. 按港口对查询港口间距离信息 **接口描述**:按港口对查询港口间距离信息 **接口地址**:`/v1/mkt/routes/distance` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |startPortCode|始发港口代码|body|true|string| |endPortCode|目的港口代码|body|true|string| |ignoreBeringStrait|是否避开白令海峡,默认避开|body|false|boolean| |ignoreKielCanal|是否避开基尔运河,默认不避开|body|false|boolean| |ignorePanamaCanal|是否避开巴拿马运河,默认不避开|body|false|boolean| |ignoreSuezCanal|是否避开苏伊士运河,默认不避开|body|false|boolean| |excludeNodes|避开海峡节点列表|body|false|array[string]| |withECA|是否计算低硫区航行距离|body|false|boolean| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | distance|规划航线总里程(海里)|number| | ecaLength|规划航线低硫区航行里程(海里)|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 4.2. 按港口对智能规划航线信息 **接口描述**:按港口对智能规划航线信息 **接口地址**:`/v1/mkt/routes/plan` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |startPortCode|始发港口代码|body|true|string| |endPortCode|目的港口代码|body|true|string| |ignoreBeringStrait|是否避开白令海峡,默认避开|body|false|boolean| |ignoreKielCanal|是否避开基尔运河,默认不避开|body|false|boolean| |ignorePanamaCanal|是否避开巴拿马运河,默认不避开|body|false|boolean| |ignoreSuezCanal|是否避开苏伊士运河,默认不避开|body|false|boolean| |excludeNodes|避开海峡节点列表|body|false|array[string]| |withECA|是否计算低硫区航行距离|body|false|boolean| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | distance|规划航线总里程(海里)|number| | ecaLength|规划航线低硫区航行里程(海里)|number| | tracks|规划航线轨迹点|array[object]| | lon|经度|number| | lat|纬度|number| | nodes|规划航线穿越节点|array[object]| | nodeCode|节点代码|string| | nameEn|节点英文名|string| | nameCn|节点中文名|string| | direction|H: 水平方向, V: 垂直方向|string| | directDesc|节点方向描述|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 4.3. 按港口对查询经验航线信息 **接口描述**:按港口对查询经验航线信息 **接口地址**:`/v1/mkt/routes/experience` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |startPortCode|始发港口代码|body|true|string| |endPortCode|目的港口代码|body|true|string| |ignoreBeringStrait|是否避开白令海峡,默认避开|body|false|boolean| |ignoreKielCanal|是否避开基尔运河,默认不避开|body|false|boolean| |ignorePanamaCanal|是否避开巴拿马运河,默认不避开|body|false|boolean| |ignoreSuezCanal|是否避开苏伊士运河,默认不避开|body|false|boolean| |excludeNodes|避开海峡节点列表|body|false|array[string]| |withECA|是否计算低硫区航行距离|body|false|boolean| |returnCount|返回航线数量,最小值:1,最大值:5|body|false|integer(int32)| |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | distance|规划航线总里程(海里)|number| | ecaLength|规划航线低硫区航行里程(海里)|number| | tracks|规划航线轨迹点|array[object]| | lon|经度|number| | lat|纬度|number| | nodes|规划航线穿越节点|array[object]| | nodeCode|节点代码|string| | nameEn|节点英文名|string| | nameCn|节点中文名|string| | direction|H: 水平方向, V: 垂直方向|string| | directDesc|节点方向描述|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 4.4. 按航线始发目的地查询当前船舶列表(按港口) **接口描述**:按航线始发目的地查询当前船舶列表(按港口) **接口地址**:`/v1/mkt/routes/vessels/current/port` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |mmsiList|MMSI列表|body|false|array[integer(int32)]| |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |flagCtry|船旗国|body|false|string| |dwt|最小载重吨|body|false|integer(int32)| |dwt2|最大载重吨|body|false|integer(int32)| |grt|最小总吨|body|false|integer(int32)| |grt2|最大总吨|body|false|integer(int32)| |teu|最小载箱数|body|false|integer(int32)| |teu2|最大载箱数|body|false|integer(int32)| |page|分页参数|body|true|object| | pageNum|页数|body|false|integer(int32)| | pageSize|每页记录数|body|false|integer(int32)| |startNodeCode|始发地代码(港口代码)|body|true|string| |endNodeCode|目的地代码(港口代码)|body|true|string| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | totalElements||integer(int64)| | totalPages||integer(int32)| | size||integer(int32)| | content||array[object]| | mmsi|船舶MMSI|integer(int32)| | imo|船舶IMO|string| | callsign|船舶呼号|string| | nameEn|船舶英文名|string| | nameCn|船舶中文名|string| | vesselType|一级船型|string| | vesselTypeNameCn|一级船型中文名|string| | vesselTypeNameEn|一级船型英文名|string| | vesselSubType|二级船型|string| | vesselSubTypeNameCn|二级船型中文名|string| | vesselSubTypeNameEn|二级船型英文名|string| | vesselSub2Type|三级船型|string| | vesselSub2TypeNameCn|三级船型中文名|string| | vesselSub2TypeNameEn|三级船型英文名|string| | flagCtry|船旗国|string| | flagCtryNameCn|船旗国中文名|string| | flagCtryNameEn|船旗国英文名|string| | classSociety|船级社|string| | classSocietyNameCn|船级社中文名|string| | classSocietyNameEn|船级社英文名|string| | buildYearMonth|建造年月|string| | retireYearMonth|失效时间|integer(int32)| | preMmsi|前任MMSI|integer(int32)| | nextMmsi|后任MMSI|integer(int32)| | registryPort|船籍港|string| | dwt|载重吨(吨)|integer(int32)| | grt|总吨|integer(int32)| | net|净吨|integer(int32)| | teu|载箱数|integer(int32)| | liquid|液体体积(立方米)|integer(int32)| | gas|气体体积(立方米)|integer(int32)| | length|船长(米)|number| | width|船宽(米)|number| | height|船高(米)|number| | draught|设计吃水(米)|number| | speed|设计航速(节)|number| | numberofcars|载车数|integer(int32)| | passengercapacity|载客数|integer(int32)| | operatorBody|经营主体英文名|string| | operatorBodyCn|经营主体中文名|string| | manageBody|管理主体英文名|string| | manageBodyCn|管理主体中文名|string| | ownerBody|所有者主体英文名|string| | ownerBodyCn|所有者主体中文名|string| | vesselStatus|船舶动态信息|object| | mmsi|船舶MMSI|integer(int32)| | dynamicType|一级动态类型: 0-航行,1-锚泊,5-靠泊,6-搁浅|string| | dynamicSubType|二级动态类型: 00-航行(途中),01-航行(到港),10-锚泊(途中),11-锚泊(到港),50-靠泊(作业),51-靠泊(修理),60-搁浅|string| | legStartPortCode|启运港|string| | legStartPortNameCn|启运港中文名|string| | legStartPortNameEn|启运港英文名|string| | legStartPortCtryCode|启运港国家|string| | legStartPortCtryNameCn|启运港国家中文名|string| | legStartPortCtryNameEn|启运港国家英文名|string| | legEndPortCode|目的港|string| | legEndPortNameCn|目的港中文名|string| | legEndPortNameEn|目的港英文名|string| | legEndPortCtryCode|目的港国家|string| | legEndPortCtryNameCn|目的港国家中文名|string| | legEndPortCtryNameEn|目的港国家英文名|string| | legStartTime|航段开始时间|string(date-time)| | legStartTimeLocal|航段开始时间(LT)|string(date-time)| | legEndTime|航段结束时间|string(date-time)| | legEndTimeLocal|航段结束时间(LT)|string(date-time)| | arrivalTime|船舶到港时间|string(date-time)| | arrivalTimeLocal|船舶到港时间(LT)|string(date-time)| | startPostime|当前动态形成时间|string(date-time)| | startPostimeLocal|当前动态形成时间(LT)|string(date-time)| | sailDuration|航行时长(小时)|number| | sailDistance|航行里程(海里)|number| | averageSpeed|平均航速(节)|number| | number||integer(int32)| | sort||object| | empty||boolean| | sorted||boolean| | unsorted||boolean| | numberOfElements||integer(int32)| | pageable||object| | offset||integer(int64)| | sort||object| | empty||boolean| | sorted||boolean| | unsorted||boolean| | pageSize||integer(int32)| | pageNumber||integer(int32)| | paged||boolean| | unpaged||boolean| | first||boolean| | last||boolean| | empty||boolean| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 4.5. 按航线始发目的地查询当前船舶列表(按国家) **接口描述**:按航线始发目的地查询当前船舶列表(按国家) **接口地址**:`/v1/mkt/routes/vessels/current/ctry` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |mmsiList|MMSI列表|body|false|array[integer(int32)]| |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |flagCtry|船旗国|body|false|string| |dwt|最小载重吨|body|false|integer(int32)| |dwt2|最大载重吨|body|false|integer(int32)| |grt|最小总吨|body|false|integer(int32)| |grt2|最大总吨|body|false|integer(int32)| |teu|最小载箱数|body|false|integer(int32)| |teu2|最大载箱数|body|false|integer(int32)| |page|分页参数|body|true|object| | pageNum|页数|body|false|integer(int32)| | pageSize|每页记录数|body|false|integer(int32)| |startNodeCode|始发地代码(国家二字码)|body|true|string| |endNodeCode|目的地代码(国家二字码)|body|true|string| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | totalElements||integer(int64)| | totalPages||integer(int32)| | size||integer(int32)| | content||array[object]| | mmsi|船舶MMSI|integer(int32)| | imo|船舶IMO|string| | callsign|船舶呼号|string| | nameEn|船舶英文名|string| | nameCn|船舶中文名|string| | vesselType|一级船型|string| | vesselTypeNameCn|一级船型中文名|string| | vesselTypeNameEn|一级船型英文名|string| | vesselSubType|二级船型|string| | vesselSubTypeNameCn|二级船型中文名|string| | vesselSubTypeNameEn|二级船型英文名|string| | vesselSub2Type|三级船型|string| | vesselSub2TypeNameCn|三级船型中文名|string| | vesselSub2TypeNameEn|三级船型英文名|string| | flagCtry|船旗国|string| | flagCtryNameCn|船旗国中文名|string| | flagCtryNameEn|船旗国英文名|string| | classSociety|船级社|string| | classSocietyNameCn|船级社中文名|string| | classSocietyNameEn|船级社英文名|string| | buildYearMonth|建造年月|string| | retireYearMonth|失效时间|integer(int32)| | preMmsi|前任MMSI|integer(int32)| | nextMmsi|后任MMSI|integer(int32)| | registryPort|船籍港|string| | dwt|载重吨(吨)|integer(int32)| | grt|总吨|integer(int32)| | net|净吨|integer(int32)| | teu|载箱数|integer(int32)| | liquid|液体体积(立方米)|integer(int32)| | gas|气体体积(立方米)|integer(int32)| | length|船长(米)|number| | width|船宽(米)|number| | height|船高(米)|number| | draught|设计吃水(米)|number| | speed|设计航速(节)|number| | numberofcars|载车数|integer(int32)| | passengercapacity|载客数|integer(int32)| | operatorBody|经营主体英文名|string| | operatorBodyCn|经营主体中文名|string| | manageBody|管理主体英文名|string| | manageBodyCn|管理主体中文名|string| | ownerBody|所有者主体英文名|string| | ownerBodyCn|所有者主体中文名|string| | vesselStatus|船舶动态信息|object| | mmsi|船舶MMSI|integer(int32)| | dynamicType|一级动态类型: 0-航行,1-锚泊,5-靠泊,6-搁浅|string| | dynamicSubType|二级动态类型: 00-航行(途中),01-航行(到港),10-锚泊(途中),11-锚泊(到港),50-靠泊(作业),51-靠泊(修理),60-搁浅|string| | legStartPortCode|启运港|string| | legStartPortNameCn|启运港中文名|string| | legStartPortNameEn|启运港英文名|string| | legStartPortCtryCode|启运港国家|string| | legStartPortCtryNameCn|启运港国家中文名|string| | legStartPortCtryNameEn|启运港国家英文名|string| | legEndPortCode|目的港|string| | legEndPortNameCn|目的港中文名|string| | legEndPortNameEn|目的港英文名|string| | legEndPortCtryCode|目的港国家|string| | legEndPortCtryNameCn|目的港国家中文名|string| | legEndPortCtryNameEn|目的港国家英文名|string| | legStartTime|航段开始时间|string(date-time)| | legStartTimeLocal|航段开始时间(LT)|string(date-time)| | legEndTime|航段结束时间|string(date-time)| | legEndTimeLocal|航段结束时间(LT)|string(date-time)| | arrivalTime|船舶到港时间|string(date-time)| | arrivalTimeLocal|船舶到港时间(LT)|string(date-time)| | startPostime|当前动态形成时间|string(date-time)| | startPostimeLocal|当前动态形成时间(LT)|string(date-time)| | sailDuration|航行时长(小时)|number| | sailDistance|航行里程(海里)|number| | averageSpeed|平均航速(节)|number| | number||integer(int32)| | sort||object| | empty||boolean| | sorted||boolean| | unsorted||boolean| | numberOfElements||integer(int32)| | pageable||object| | offset||integer(int64)| | sort||object| | empty||boolean| | sorted||boolean| | unsorted||boolean| | pageSize||integer(int32)| | pageNumber||integer(int32)| | paged||boolean| | unpaged||boolean| | first||boolean| | last||boolean| | empty||boolean| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 4.6. 按航线始发目的地查询当前船舶列表(按贸易区) **接口描述**:按航线始发目的地查询当前船舶列表(按贸易区) **接口地址**:`/v1/mkt/routes/vessels/current/trade` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |mmsiList|MMSI列表|body|false|array[integer(int32)]| |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |flagCtry|船旗国|body|false|string| |dwt|最小载重吨|body|false|integer(int32)| |dwt2|最大载重吨|body|false|integer(int32)| |grt|最小总吨|body|false|integer(int32)| |grt2|最大总吨|body|false|integer(int32)| |teu|最小载箱数|body|false|integer(int32)| |teu2|最大载箱数|body|false|integer(int32)| |page|分页参数|body|true|object| | pageNum|页数|body|false|integer(int32)| | pageSize|每页记录数|body|false|integer(int32)| |startNodeCode|始发地代码(贸易区代码)|body|true|string| |endNodeCode|目的地代码(贸易区代码)|body|true|string| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | totalElements||integer(int64)| | totalPages||integer(int32)| | size||integer(int32)| | content||array[object]| | mmsi|船舶MMSI|integer(int32)| | imo|船舶IMO|string| | callsign|船舶呼号|string| | nameEn|船舶英文名|string| | nameCn|船舶中文名|string| | vesselType|一级船型|string| | vesselTypeNameCn|一级船型中文名|string| | vesselTypeNameEn|一级船型英文名|string| | vesselSubType|二级船型|string| | vesselSubTypeNameCn|二级船型中文名|string| | vesselSubTypeNameEn|二级船型英文名|string| | vesselSub2Type|三级船型|string| | vesselSub2TypeNameCn|三级船型中文名|string| | vesselSub2TypeNameEn|三级船型英文名|string| | flagCtry|船旗国|string| | flagCtryNameCn|船旗国中文名|string| | flagCtryNameEn|船旗国英文名|string| | classSociety|船级社|string| | classSocietyNameCn|船级社中文名|string| | classSocietyNameEn|船级社英文名|string| | buildYearMonth|建造年月|string| | retireYearMonth|失效时间|integer(int32)| | preMmsi|前任MMSI|integer(int32)| | nextMmsi|后任MMSI|integer(int32)| | registryPort|船籍港|string| | dwt|载重吨(吨)|integer(int32)| | grt|总吨|integer(int32)| | net|净吨|integer(int32)| | teu|载箱数|integer(int32)| | liquid|液体体积(立方米)|integer(int32)| | gas|气体体积(立方米)|integer(int32)| | length|船长(米)|number| | width|船宽(米)|number| | height|船高(米)|number| | draught|设计吃水(米)|number| | speed|设计航速(节)|number| | numberofcars|载车数|integer(int32)| | passengercapacity|载客数|integer(int32)| | operatorBody|经营主体英文名|string| | operatorBodyCn|经营主体中文名|string| | manageBody|管理主体英文名|string| | manageBodyCn|管理主体中文名|string| | ownerBody|所有者主体英文名|string| | ownerBodyCn|所有者主体中文名|string| | vesselStatus|船舶动态信息|object| | mmsi|船舶MMSI|integer(int32)| | dynamicType|一级动态类型: 0-航行,1-锚泊,5-靠泊,6-搁浅|string| | dynamicSubType|二级动态类型: 00-航行(途中),01-航行(到港),10-锚泊(途中),11-锚泊(到港),50-靠泊(作业),51-靠泊(修理),60-搁浅|string| | legStartPortCode|启运港|string| | legStartPortNameCn|启运港中文名|string| | legStartPortNameEn|启运港英文名|string| | legStartPortCtryCode|启运港国家|string| | legStartPortCtryNameCn|启运港国家中文名|string| | legStartPortCtryNameEn|启运港国家英文名|string| | legEndPortCode|目的港|string| | legEndPortNameCn|目的港中文名|string| | legEndPortNameEn|目的港英文名|string| | legEndPortCtryCode|目的港国家|string| | legEndPortCtryNameCn|目的港国家中文名|string| | legEndPortCtryNameEn|目的港国家英文名|string| | legStartTime|航段开始时间|string(date-time)| | legStartTimeLocal|航段开始时间(LT)|string(date-time)| | legEndTime|航段结束时间|string(date-time)| | legEndTimeLocal|航段结束时间(LT)|string(date-time)| | arrivalTime|船舶到港时间|string(date-time)| | arrivalTimeLocal|船舶到港时间(LT)|string(date-time)| | startPostime|当前动态形成时间|string(date-time)| | startPostimeLocal|当前动态形成时间(LT)|string(date-time)| | sailDuration|航行时长(小时)|number| | sailDistance|航行里程(海里)|number| | averageSpeed|平均航速(节)|number| | number||integer(int32)| | sort||object| | empty||boolean| | sorted||boolean| | unsorted||boolean| | numberOfElements||integer(int32)| | pageable||object| | offset||integer(int64)| | sort||object| | empty||boolean| | sorted||boolean| | unsorted||boolean| | pageSize||integer(int32)| | pageNumber||integer(int32)| | paged||boolean| | unpaged||boolean| | first||boolean| | last||boolean| | empty||boolean| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 4.7. 按航线始发目的地查询当前船舶列表(按洲) **接口描述**:按航线始发目的地查询当前船舶列表(按港洲) **接口地址**:`/v1/mkt/routes/vessels/current/continent` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |mmsiList|MMSI列表|body|false|array[integer(int32)]| |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |flagCtry|船旗国|body|false|string| |dwt|最小载重吨|body|false|integer(int32)| |dwt2|最大载重吨|body|false|integer(int32)| |grt|最小总吨|body|false|integer(int32)| |grt2|最大总吨|body|false|integer(int32)| |teu|最小载箱数|body|false|integer(int32)| |teu2|最大载箱数|body|false|integer(int32)| |page|分页参数|body|true|object| | pageNum|页数|body|false|integer(int32)| | pageSize|每页记录数|body|false|integer(int32)| |startNodeCode|始发地代码(洲代码)|body|true|string| |endNodeCode|目的地代码(洲代码)|body|true|string| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | totalElements||integer(int64)| | totalPages||integer(int32)| | size||integer(int32)| | content||array[object]| | mmsi|船舶MMSI|integer(int32)| | imo|船舶IMO|string| | callsign|船舶呼号|string| | nameEn|船舶英文名|string| | nameCn|船舶中文名|string| | vesselType|一级船型|string| | vesselTypeNameCn|一级船型中文名|string| | vesselTypeNameEn|一级船型英文名|string| | vesselSubType|二级船型|string| | vesselSubTypeNameCn|二级船型中文名|string| | vesselSubTypeNameEn|二级船型英文名|string| | vesselSub2Type|三级船型|string| | vesselSub2TypeNameCn|三级船型中文名|string| | vesselSub2TypeNameEn|三级船型英文名|string| | flagCtry|船旗国|string| | flagCtryNameCn|船旗国中文名|string| | flagCtryNameEn|船旗国英文名|string| | classSociety|船级社|string| | classSocietyNameCn|船级社中文名|string| | classSocietyNameEn|船级社英文名|string| | buildYearMonth|建造年月|string| | retireYearMonth|失效时间|integer(int32)| | preMmsi|前任MMSI|integer(int32)| | nextMmsi|后任MMSI|integer(int32)| | registryPort|船籍港|string| | dwt|载重吨(吨)|integer(int32)| | grt|总吨|integer(int32)| | net|净吨|integer(int32)| | teu|载箱数|integer(int32)| | liquid|液体体积(立方米)|integer(int32)| | gas|气体体积(立方米)|integer(int32)| | length|船长(米)|number| | width|船宽(米)|number| | height|船高(米)|number| | draught|设计吃水(米)|number| | speed|设计航速(节)|number| | numberofcars|载车数|integer(int32)| | passengercapacity|载客数|integer(int32)| | operatorBody|经营主体英文名|string| | operatorBodyCn|经营主体中文名|string| | manageBody|管理主体英文名|string| | manageBodyCn|管理主体中文名|string| | ownerBody|所有者主体英文名|string| | ownerBodyCn|所有者主体中文名|string| | vesselStatus|船舶动态信息|object| | mmsi|船舶MMSI|integer(int32)| | dynamicType|一级动态类型: 0-航行,1-锚泊,5-靠泊,6-搁浅|string| | dynamicSubType|二级动态类型: 00-航行(途中),01-航行(到港),10-锚泊(途中),11-锚泊(到港),50-靠泊(作业),51-靠泊(修理),60-搁浅|string| | legStartPortCode|启运港|string| | legStartPortNameCn|启运港中文名|string| | legStartPortNameEn|启运港英文名|string| | legStartPortCtryCode|启运港国家|string| | legStartPortCtryNameCn|启运港国家中文名|string| | legStartPortCtryNameEn|启运港国家英文名|string| | legEndPortCode|目的港|string| | legEndPortNameCn|目的港中文名|string| | legEndPortNameEn|目的港英文名|string| | legEndPortCtryCode|目的港国家|string| | legEndPortCtryNameCn|目的港国家中文名|string| | legEndPortCtryNameEn|目的港国家英文名|string| | legStartTime|航段开始时间|string(date-time)| | legStartTimeLocal|航段开始时间(LT)|string(date-time)| | legEndTime|航段结束时间|string(date-time)| | legEndTimeLocal|航段结束时间(LT)|string(date-time)| | arrivalTime|船舶到港时间|string(date-time)| | arrivalTimeLocal|船舶到港时间(LT)|string(date-time)| | startPostime|当前动态形成时间|string(date-time)| | startPostimeLocal|当前动态形成时间(LT)|string(date-time)| | sailDuration|航行时长(小时)|number| | sailDistance|航行里程(海里)|number| | averageSpeed|平均航速(节)|number| | number||integer(int32)| | sort||object| | empty||boolean| | sorted||boolean| | unsorted||boolean| | numberOfElements||integer(int32)| | pageable||object| | offset||integer(int64)| | sort||object| | empty||boolean| | sorted||boolean| | unsorted||boolean| | pageSize||integer(int32)| | pageNumber||integer(int32)| | paged||boolean| | unpaged||boolean| | first||boolean| | last||boolean| | empty||boolean| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 4.8. 按航线始发目的地查询历史船舶列表(按港口) **接口描述**:按航线始发目的地查询历史船舶列表(按港口) **接口地址**:`/v1/mkt/routes/vessels/his/port` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |mmsiList|MMSI列表|body|false|array[integer(int32)]| |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |flagCtry|船旗国|body|false|string| |dwt|最小载重吨|body|false|integer(int32)| |dwt2|最大载重吨|body|false|integer(int32)| |grt|最小总吨|body|false|integer(int32)| |grt2|最大总吨|body|false|integer(int32)| |teu|最小载箱数|body|false|integer(int32)| |teu2|最大载箱数|body|false|integer(int32)| |page|分页参数|body|true|object| | pageNum|页数|body|false|integer(int32)| | pageSize|每页记录数|body|false|integer(int32)| |startTime|开始时间(靠泊)|body|true|string(date-time)| |endTime|结束时间(靠泊)|body|true|string(date-time)| |startNodeCode|始发地代码(港口代码)|body|true|string| |endNodeCode|目的地代码(港口代码)|body|true|string| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | totalElements||integer(int64)| | totalPages||integer(int32)| | size||integer(int32)| | content||array[object]| | mmsi|船舶MMSI|integer(int32)| | imo|船舶IMO|string| | callsign|船舶呼号|string| | nameEn|船舶英文名|string| | nameCn|船舶中文名|string| | vesselType|一级船型|string| | vesselTypeNameCn|一级船型中文名|string| | vesselTypeNameEn|一级船型英文名|string| | vesselSubType|二级船型|string| | vesselSubTypeNameCn|二级船型中文名|string| | vesselSubTypeNameEn|二级船型英文名|string| | vesselSub2Type|三级船型|string| | vesselSub2TypeNameCn|三级船型中文名|string| | vesselSub2TypeNameEn|三级船型英文名|string| | flagCtry|船旗国|string| | flagCtryNameCn|船旗国中文名|string| | flagCtryNameEn|船旗国英文名|string| | classSociety|船级社|string| | classSocietyNameCn|船级社中文名|string| | classSocietyNameEn|船级社英文名|string| | buildYearMonth|建造年月|string| | retireYearMonth|失效时间|integer(int32)| | preMmsi|前任MMSI|integer(int32)| | nextMmsi|后任MMSI|integer(int32)| | registryPort|船籍港|string| | dwt|载重吨(吨)|integer(int32)| | grt|总吨|integer(int32)| | net|净吨|integer(int32)| | teu|载箱数|integer(int32)| | liquid|液体体积(立方米)|integer(int32)| | gas|气体体积(立方米)|integer(int32)| | length|船长(米)|number| | width|船宽(米)|number| | height|船高(米)|number| | draught|设计吃水(米)|number| | speed|设计航速(节)|number| | numberofcars|载车数|integer(int32)| | passengercapacity|载客数|integer(int32)| | operatorBody|经营主体英文名|string| | operatorBodyCn|经营主体中文名|string| | manageBody|管理主体英文名|string| | manageBodyCn|管理主体中文名|string| | ownerBody|所有者主体英文名|string| | ownerBodyCn|所有者主体中文名|string| | vesselStatus|船舶动态信息|object| | mmsi|船舶MMSI|integer(int32)| | legStartPortCode|启运港|string| | legStartPortNameCn|启运港中文名|string| | legStartPortNameEn|启运港英文名|string| | legStartPortCtryCode|启运港国家|string| | legStartPortCtryNameCn|启运港国家中文名|string| | legStartPortCtryNameEn|启运港国家英文名|string| | legEndPortCode|目的港|string| | legEndPortNameCn|目的港中文名|string| | legEndPortNameEn|目的港英文名|string| | legEndPortCtryCode|目的港国家|string| | legEndPortCtryNameCn|目的港国家中文名|string| | legEndPortCtryNameEn|目的港国家英文名|string| | legStartTime|航段开始时间|string(date-time)| | legStartTimeLocal|航段开始时间(LT)|string(date-time)| | arrivalTime|到港时间|string(date-time)| | arrivalTimeLocal|到港时间(LT)|string(date-time)| | berthTime|靠泊时间|string(date-time)| | berthTimeLocal|靠泊时间(LT)|string(date-time)| | legEndTime|航段结束时间|string(date-time)| | legEndTimeLocal|航段结束时间(LT)|string(date-time)| | sailDuration|航行时长(小时)|number| | sailDistance|航行里程(海里)|number| | averageSpeed|平均航速(节)|number| | number||integer(int32)| | sort||object| | empty||boolean| | sorted||boolean| | unsorted||boolean| | numberOfElements||integer(int32)| | pageable||object| | offset||integer(int64)| | sort||object| | empty||boolean| | sorted||boolean| | unsorted||boolean| | pageSize||integer(int32)| | pageNumber||integer(int32)| | paged||boolean| | unpaged||boolean| | first||boolean| | last||boolean| | empty||boolean| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 4.9. 按航线始发目的地查询历史船舶列表(按国家) **接口描述**:按航线始发目的地查询历史船舶列表(按国家) **接口地址**:`/v1/mkt/routes/vessels/his/ctry` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |mmsiList|MMSI列表|body|false|array[integer(int32)]| |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |flagCtry|船旗国|body|false|string| |dwt|最小载重吨|body|false|integer(int32)| |dwt2|最大载重吨|body|false|integer(int32)| |grt|最小总吨|body|false|integer(int32)| |grt2|最大总吨|body|false|integer(int32)| |teu|最小载箱数|body|false|integer(int32)| |teu2|最大载箱数|body|false|integer(int32)| |page|分页参数|body|true|object| | pageNum|页数|body|false|integer(int32)| | pageSize|每页记录数|body|false|integer(int32)| |startTime|开始时间(靠泊)|body|true|string(date-time)| |endTime|结束时间(靠泊)|body|true|string(date-time)| |startNodeCode|始发地代码(国家二字码)|body|true|string| |endNodeCode|目的地代码(国家二字码)|body|true|string| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | totalElements||integer(int64)| | totalPages||integer(int32)| | size||integer(int32)| | content||array[object]| | mmsi|船舶MMSI|integer(int32)| | imo|船舶IMO|string| | callsign|船舶呼号|string| | nameEn|船舶英文名|string| | nameCn|船舶中文名|string| | vesselType|一级船型|string| | vesselTypeNameCn|一级船型中文名|string| | vesselTypeNameEn|一级船型英文名|string| | vesselSubType|二级船型|string| | vesselSubTypeNameCn|二级船型中文名|string| | vesselSubTypeNameEn|二级船型英文名|string| | vesselSub2Type|三级船型|string| | vesselSub2TypeNameCn|三级船型中文名|string| | vesselSub2TypeNameEn|三级船型英文名|string| | flagCtry|船旗国|string| | flagCtryNameCn|船旗国中文名|string| | flagCtryNameEn|船旗国英文名|string| | classSociety|船级社|string| | classSocietyNameCn|船级社中文名|string| | classSocietyNameEn|船级社英文名|string| | buildYearMonth|建造年月|string| | retireYearMonth|失效时间|integer(int32)| | preMmsi|前任MMSI|integer(int32)| | nextMmsi|后任MMSI|integer(int32)| | registryPort|船籍港|string| | dwt|载重吨(吨)|integer(int32)| | grt|总吨|integer(int32)| | net|净吨|integer(int32)| | teu|载箱数|integer(int32)| | liquid|液体体积(立方米)|integer(int32)| | gas|气体体积(立方米)|integer(int32)| | length|船长(米)|number| | width|船宽(米)|number| | height|船高(米)|number| | draught|设计吃水(米)|number| | speed|设计航速(节)|number| | numberofcars|载车数|integer(int32)| | passengercapacity|载客数|integer(int32)| | operatorBody|经营主体英文名|string| | operatorBodyCn|经营主体中文名|string| | manageBody|管理主体英文名|string| | manageBodyCn|管理主体中文名|string| | ownerBody|所有者主体英文名|string| | ownerBodyCn|所有者主体中文名|string| | vesselStatus|船舶动态信息|object| | mmsi|船舶MMSI|integer(int32)| | legStartPortCode|启运港|string| | legStartPortNameCn|启运港中文名|string| | legStartPortNameEn|启运港英文名|string| | legStartPortCtryCode|启运港国家|string| | legStartPortCtryNameCn|启运港国家中文名|string| | legStartPortCtryNameEn|启运港国家英文名|string| | legEndPortCode|目的港|string| | legEndPortNameCn|目的港中文名|string| | legEndPortNameEn|目的港英文名|string| | legEndPortCtryCode|目的港国家|string| | legEndPortCtryNameCn|目的港国家中文名|string| | legEndPortCtryNameEn|目的港国家英文名|string| | legStartTime|航段开始时间|string(date-time)| | legStartTimeLocal|航段开始时间(LT)|string(date-time)| | arrivalTime|到港时间|string(date-time)| | arrivalTimeLocal|到港时间(LT)|string(date-time)| | berthTime|靠泊时间|string(date-time)| | berthTimeLocal|靠泊时间(LT)|string(date-time)| | legEndTime|航段结束时间|string(date-time)| | legEndTimeLocal|航段结束时间(LT)|string(date-time)| | sailDuration|航行时长(小时)|number| | sailDistance|航行里程(海里)|number| | averageSpeed|平均航速(节)|number| | number||integer(int32)| | sort||object| | empty||boolean| | sorted||boolean| | unsorted||boolean| | numberOfElements||integer(int32)| | pageable||object| | offset||integer(int64)| | sort||object| | empty||boolean| | sorted||boolean| | unsorted||boolean| | pageSize||integer(int32)| | pageNumber||integer(int32)| | paged||boolean| | unpaged||boolean| | first||boolean| | last||boolean| | empty||boolean| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 4.10. 按航线始发目的地查询历史船舶列表(按贸易区) **接口描述**:按航线始发目的地查询历史船舶列表(按贸易区) **接口地址**:`/v1/mkt/routes/vessels/his/trade` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |mmsiList|MMSI列表|body|false|array[integer(int32)]| |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |flagCtry|船旗国|body|false|string| |dwt|最小载重吨|body|false|integer(int32)| |dwt2|最大载重吨|body|false|integer(int32)| |grt|最小总吨|body|false|integer(int32)| |grt2|最大总吨|body|false|integer(int32)| |teu|最小载箱数|body|false|integer(int32)| |teu2|最大载箱数|body|false|integer(int32)| |page|分页参数|body|true|object| | pageNum|页数|body|false|integer(int32)| | pageSize|每页记录数|body|false|integer(int32)| |startTime|开始时间(靠泊)|body|true|string(date-time)| |endTime|结束时间(靠泊)|body|true|string(date-time)| |startNodeCode|始发地代码(贸易区代码)|body|true|string| |endNodeCode|目的地代码(贸易区代码)|body|true|string| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | totalElements||integer(int64)| | totalPages||integer(int32)| | size||integer(int32)| | content||array[object]| | mmsi|船舶MMSI|integer(int32)| | imo|船舶IMO|string| | callsign|船舶呼号|string| | nameEn|船舶英文名|string| | nameCn|船舶中文名|string| | vesselType|一级船型|string| | vesselTypeNameCn|一级船型中文名|string| | vesselTypeNameEn|一级船型英文名|string| | vesselSubType|二级船型|string| | vesselSubTypeNameCn|二级船型中文名|string| | vesselSubTypeNameEn|二级船型英文名|string| | vesselSub2Type|三级船型|string| | vesselSub2TypeNameCn|三级船型中文名|string| | vesselSub2TypeNameEn|三级船型英文名|string| | flagCtry|船旗国|string| | flagCtryNameCn|船旗国中文名|string| | flagCtryNameEn|船旗国英文名|string| | classSociety|船级社|string| | classSocietyNameCn|船级社中文名|string| | classSocietyNameEn|船级社英文名|string| | buildYearMonth|建造年月|string| | retireYearMonth|失效时间|integer(int32)| | preMmsi|前任MMSI|integer(int32)| | nextMmsi|后任MMSI|integer(int32)| | registryPort|船籍港|string| | dwt|载重吨(吨)|integer(int32)| | grt|总吨|integer(int32)| | net|净吨|integer(int32)| | teu|载箱数|integer(int32)| | liquid|液体体积(立方米)|integer(int32)| | gas|气体体积(立方米)|integer(int32)| | length|船长(米)|number| | width|船宽(米)|number| | height|船高(米)|number| | draught|设计吃水(米)|number| | speed|设计航速(节)|number| | numberofcars|载车数|integer(int32)| | passengercapacity|载客数|integer(int32)| | operatorBody|经营主体英文名|string| | operatorBodyCn|经营主体中文名|string| | manageBody|管理主体英文名|string| | manageBodyCn|管理主体中文名|string| | ownerBody|所有者主体英文名|string| | ownerBodyCn|所有者主体中文名|string| | vesselStatus|船舶动态信息|object| | mmsi|船舶MMSI|integer(int32)| | legStartPortCode|启运港|string| | legStartPortNameCn|启运港中文名|string| | legStartPortNameEn|启运港英文名|string| | legStartPortCtryCode|启运港国家|string| | legStartPortCtryNameCn|启运港国家中文名|string| | legStartPortCtryNameEn|启运港国家英文名|string| | legEndPortCode|目的港|string| | legEndPortNameCn|目的港中文名|string| | legEndPortNameEn|目的港英文名|string| | legEndPortCtryCode|目的港国家|string| | legEndPortCtryNameCn|目的港国家中文名|string| | legEndPortCtryNameEn|目的港国家英文名|string| | legStartTime|航段开始时间|string(date-time)| | legStartTimeLocal|航段开始时间(LT)|string(date-time)| | arrivalTime|到港时间|string(date-time)| | arrivalTimeLocal|到港时间(LT)|string(date-time)| | berthTime|靠泊时间|string(date-time)| | berthTimeLocal|靠泊时间(LT)|string(date-time)| | legEndTime|航段结束时间|string(date-time)| | legEndTimeLocal|航段结束时间(LT)|string(date-time)| | sailDuration|航行时长(小时)|number| | sailDistance|航行里程(海里)|number| | averageSpeed|平均航速(节)|number| | number||integer(int32)| | sort||object| | empty||boolean| | sorted||boolean| | unsorted||boolean| | numberOfElements||integer(int32)| | pageable||object| | offset||integer(int64)| | sort||object| | empty||boolean| | sorted||boolean| | unsorted||boolean| | pageSize||integer(int32)| | pageNumber||integer(int32)| | paged||boolean| | unpaged||boolean| | first||boolean| | last||boolean| | empty||boolean| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 4.11. 按航线始发目的地查询历史船舶列表(按洲) **接口描述**:按航线始发目的地查询历史船舶列表(按洲) **接口地址**:`/v1/mkt/routes/vessels/his/continent` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |mmsiList|MMSI列表|body|false|array[integer(int32)]| |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |flagCtry|船旗国|body|false|string| |dwt|最小载重吨|body|false|integer(int32)| |dwt2|最大载重吨|body|false|integer(int32)| |grt|最小总吨|body|false|integer(int32)| |grt2|最大总吨|body|false|integer(int32)| |teu|最小载箱数|body|false|integer(int32)| |teu2|最大载箱数|body|false|integer(int32)| |page|分页参数|body|true|object| | pageNum|页数|body|false|integer(int32)| | pageSize|每页记录数|body|false|integer(int32)| |startTime|开始时间(靠泊)|body|true|string(date-time)| |endTime|结束时间(靠泊)|body|true|string(date-time)| |startNodeCode|始发地代码(洲代码)|body|true|string| |endNodeCode|目的地代码(洲代码)|body|true|string| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | totalElements||integer(int64)| | totalPages||integer(int32)| | size||integer(int32)| | content||array[object]| | mmsi|船舶MMSI|integer(int32)| | imo|船舶IMO|string| | callsign|船舶呼号|string| | nameEn|船舶英文名|string| | nameCn|船舶中文名|string| | vesselType|一级船型|string| | vesselTypeNameCn|一级船型中文名|string| | vesselTypeNameEn|一级船型英文名|string| | vesselSubType|二级船型|string| | vesselSubTypeNameCn|二级船型中文名|string| | vesselSubTypeNameEn|二级船型英文名|string| | vesselSub2Type|三级船型|string| | vesselSub2TypeNameCn|三级船型中文名|string| | vesselSub2TypeNameEn|三级船型英文名|string| | flagCtry|船旗国|string| | flagCtryNameCn|船旗国中文名|string| | flagCtryNameEn|船旗国英文名|string| | classSociety|船级社|string| | classSocietyNameCn|船级社中文名|string| | classSocietyNameEn|船级社英文名|string| | buildYearMonth|建造年月|string| | retireYearMonth|失效时间|integer(int32)| | preMmsi|前任MMSI|integer(int32)| | nextMmsi|后任MMSI|integer(int32)| | registryPort|船籍港|string| | dwt|载重吨(吨)|integer(int32)| | grt|总吨|integer(int32)| | net|净吨|integer(int32)| | teu|载箱数|integer(int32)| | liquid|液体体积(立方米)|integer(int32)| | gas|气体体积(立方米)|integer(int32)| | length|船长(米)|number| | width|船宽(米)|number| | height|船高(米)|number| | draught|设计吃水(米)|number| | speed|设计航速(节)|number| | numberofcars|载车数|integer(int32)| | passengercapacity|载客数|integer(int32)| | operatorBody|经营主体英文名|string| | operatorBodyCn|经营主体中文名|string| | manageBody|管理主体英文名|string| | manageBodyCn|管理主体中文名|string| | ownerBody|所有者主体英文名|string| | ownerBodyCn|所有者主体中文名|string| | vesselStatus|船舶动态信息|object| | mmsi|船舶MMSI|integer(int32)| | legStartPortCode|启运港|string| | legStartPortNameCn|启运港中文名|string| | legStartPortNameEn|启运港英文名|string| | legStartPortCtryCode|启运港国家|string| | legStartPortCtryNameCn|启运港国家中文名|string| | legStartPortCtryNameEn|启运港国家英文名|string| | legEndPortCode|目的港|string| | legEndPortNameCn|目的港中文名|string| | legEndPortNameEn|目的港英文名|string| | legEndPortCtryCode|目的港国家|string| | legEndPortCtryNameCn|目的港国家中文名|string| | legEndPortCtryNameEn|目的港国家英文名|string| | legStartTime|航段开始时间|string(date-time)| | legStartTimeLocal|航段开始时间(LT)|string(date-time)| | arrivalTime|到港时间|string(date-time)| | arrivalTimeLocal|到港时间(LT)|string(date-time)| | berthTime|靠泊时间|string(date-time)| | berthTimeLocal|靠泊时间(LT)|string(date-time)| | legEndTime|航段结束时间|string(date-time)| | legEndTimeLocal|航段结束时间(LT)|string(date-time)| | sailDuration|航行时长(小时)|number| | sailDistance|航行里程(海里)|number| | averageSpeed|平均航速(节)|number| | number||integer(int32)| | sort||object| | empty||boolean| | sorted||boolean| | unsorted||boolean| | numberOfElements||integer(int32)| | pageable||object| | offset||integer(int64)| | sort||object| | empty||boolean| | sorted||boolean| | unsorted||boolean| | pageSize||integer(int32)| | pageNumber||integer(int32)| | paged||boolean| | unpaged||boolean| | first||boolean| | last||boolean| | empty||boolean| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ## 5. API市场-船舶事件 ### 5.1. 按MMSI查询指定船舶STS加油记录 **接口描述**:按MMSI查询指定船舶STS加油记录 **接口地址**:`/v1/mkt/vessels/events/sts/oil` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |mmsi|船舶MMSI|body|true|integer(int32)| |startTime|开始时间|body|true|string(date-time)| |endTime|结束时间|body|true|string(date-time)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | startTime|开始时间|string(date-time)| | endTime|结束时间|string(date-time)| | mmsi|STS对手船舶MMSI|integer(int32)| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 5.2. 按MMSI查询指定船舶STS拖轮记录 **接口描述**:按MMSI查询指定船舶STS拖轮记录 **接口地址**:`/v1/mkt/vessels/events/sts/tug` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |mmsi|船舶MMSI|body|true|integer(int32)| |startTime|开始时间|body|true|string(date-time)| |endTime|结束时间|body|true|string(date-time)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | startTime|开始时间|string(date-time)| | endTime|结束时间|string(date-time)| | mmsi|STS对手船舶MMSI|integer(int32)| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 5.3. 按MMSI查询指定船舶STS装卸货记录 **接口描述**:按MMSI查询指定船舶STS装卸货记录 **接口地址**:`/v1/mkt/vessels/events/sts/load` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |mmsi|船舶MMSI|body|true|integer(int32)| |startTime|开始时间|body|true|string(date-time)| |endTime|结束时间|body|true|string(date-time)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | startTime|开始时间|string(date-time)| | endTime|结束时间|string(date-time)| | mmsi|STS对手船舶MMSI|integer(int32)| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 5.4. 按MMSI查询指定两船会遇记录 **接口描述**:按MMSI查询指定两船会遇记录 **接口地址**:`/v1/mkt/vessels/events/encounter` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |mmsi|船舶MMSI|body|true|integer(int32)| |startTime|开始时间|body|true|string(date-time)| |endTime|结束时间|body|true|string(date-time)| |mmsi2|船舶MMSI|body|true|integer(int32)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | startTime|开始时间|string(date-time)| | endTime|结束时间|string(date-time)| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 5.5. 按MMSI查询船舶特战区进出记录 **接口描述**:按MMSI查询船舶特战区进出记录 **接口地址**:`/v1/mkt/vessels/events/special-region/swz` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |mmsi|船舶MMSI|body|true|integer(int32)| |startTime|开始时间|body|true|string(date-time)| |endTime|结束时间|body|true|string(date-time)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | specialRegionType|特殊区域类型(SWZ-特战,PRZ-海盗,ICE-全球冰区)|string| | specialRegionCode|特殊区域代码|string| | specialRegionNameCn|特殊区域名称中文|string| | specialRegionNameEn|特殊区域名称英文|string| | crossList|穿越记录|array[object]| | preAis|上一AIS信息|object| | postime|位置时间(yyyy-MM-dd HH:mm:ss)|string(date-time)| | lon|经度|number| | lat|纬度|number| | currAis|当前AIS信息|object| | postime|位置时间(yyyy-MM-dd HH:mm:ss)|string(date-time)| | lon|经度|number| | lat|纬度|number| | crossPoint|穿越点信息|object| | postime|位置时间(yyyy-MM-dd HH:mm:ss)|string(date-time)| | lon|经度|number| | lat|纬度|number| | crossType|穿越方向|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 5.6. 按MMSI查询船舶海盗区进出记录 **接口描述**:按MMSI查询船舶海盗区进出记录 **接口地址**:`/v1/mkt/vessels/events/special-region/prz` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |mmsi|船舶MMSI|body|true|integer(int32)| |startTime|开始时间|body|true|string(date-time)| |endTime|结束时间|body|true|string(date-time)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | specialRegionType|特殊区域类型(SWZ-特战,PRZ-海盗,ICE-全球冰区)|string| | specialRegionCode|特殊区域代码|string| | specialRegionNameCn|特殊区域名称中文|string| | specialRegionNameEn|特殊区域名称英文|string| | crossList|穿越记录|array[object]| | preAis|上一AIS信息|object| | postime|位置时间(yyyy-MM-dd HH:mm:ss)|string(date-time)| | lon|经度|number| | lat|纬度|number| | currAis|当前AIS信息|object| | postime|位置时间(yyyy-MM-dd HH:mm:ss)|string(date-time)| | lon|经度|number| | lat|纬度|number| | crossPoint|穿越点信息|object| | postime|位置时间(yyyy-MM-dd HH:mm:ss)|string(date-time)| | lon|经度|number| | lat|纬度|number| | crossType|穿越方向|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 5.7. 按MMSI查询船舶全球冰区进出记录 **接口描述**:按MMSI查询船舶全球冰区进出记录 **接口地址**:`/v1/mkt/vessels/events/special-region/ice` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |mmsi|船舶MMSI|body|true|integer(int32)| |startTime|开始时间|body|true|string(date-time)| |endTime|结束时间|body|true|string(date-time)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | specialRegionType|特殊区域类型(SWZ-特战,PRZ-海盗,ICE-全球冰区)|string| | specialRegionCode|特殊区域代码|string| | specialRegionNameCn|特殊区域名称中文|string| | specialRegionNameEn|特殊区域名称英文|string| | crossList|穿越记录|array[object]| | preAis|上一AIS信息|object| | postime|位置时间(yyyy-MM-dd HH:mm:ss)|string(date-time)| | lon|经度|number| | lat|纬度|number| | currAis|当前AIS信息|object| | postime|位置时间(yyyy-MM-dd HH:mm:ss)|string(date-time)| | lon|经度|number| | lat|纬度|number| | crossPoint|穿越点信息|object| | postime|位置时间(yyyy-MM-dd HH:mm:ss)|string(date-time)| | lon|经度|number| | lat|纬度|number| | crossType|穿越方向|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 5.8. 按MMSI查询船舶恶劣气象(风)事件记录 **接口描述**:按MMSI查询船舶恶劣气象(风)事件记录 **接口地址**:`/v1/mkt/vessels/events/bad-weather/wind` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |mmsi|船舶MMSI|body|true|integer(int32)| |startTime|开始时间|body|true|string(date-time)| |endTime|结束时间|body|true|string(date-time)| |windLevel|大风等级(左边界)|body|false|integer(int32)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | startTime|开始时间|string(date-time)| | endTime|结束时间|string(date-time)| | weatherLevel|恶劣气象等级|number| | weatherLevelDescCn|恶劣气象等级中文描述|string| | weatherLevelDescEn|恶劣气象等级英文描述|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 5.9. 按MMSI查询船舶恶劣气象(浪)事件记录 **接口描述**:按MMSI查询船舶恶劣气象(浪)事件记录 **接口地址**:`/v1/mkt/vessels/events/bad-weather/wave` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |mmsi|船舶MMSI|body|true|integer(int32)| |startTime|开始时间|body|true|string(date-time)| |endTime|结束时间|body|true|string(date-time)| |waveLevel|大浪等级(左边界)|body|false|integer(int32)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | startTime|开始时间|string(date-time)| | endTime|结束时间|string(date-time)| | weatherLevel|恶劣气象等级|number| | weatherLevelDescCn|恶劣气象等级中文描述|string| | weatherLevelDescEn|恶劣气象等级英文描述|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 5.10. 按MMSI查询船舶恶劣气象(能见度)事件记录 **接口描述**:按MMSI查询船舶恶劣气象(能见度)事件记录 **接口地址**:`/v1/mkt/vessels/events/bad-weather/vis` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |mmsi|船舶MMSI|body|true|integer(int32)| |startTime|开始时间|body|true|string(date-time)| |endTime|结束时间|body|true|string(date-time)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | startTime|开始时间|string(date-time)| | endTime|结束时间|string(date-time)| | weatherLevel|恶劣气象等级|string| | weatherLevelDescCn|恶劣气象等级中文描述|string| | weatherLevelDescEn|恶劣气象等级英文描述|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 5.11. 按MMSI查询指定航速区间连续航行记录 **接口描述**:按MMSI查询指定航速区间连续航行记录 **接口地址**:`/v1/mkt/vessels/events/speed-range` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |mmsi|船舶MMSI|body|true|integer(int32)| |startTime|开始时间|body|true|string(date-time)| |endTime|结束时间|body|true|string(date-time)| |minSpeed|最低速度(节)|body|true|number| |maxSpeed|最高速度(节)|body|true|number| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | startTime|开始时间|string(date-time)| | endTime|结束时间|string(date-time)| | startLon|开始经度|number| | startLat|开始纬度|number| | endLon|结束经度|number| | endLat|结束纬度|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 5.12. 按照MMSI查询指定时间范围内AIS丢失 **接口描述**:按照MMSI查询指定时间范围内AIS丢失 **接口地址**:`/v1/mkt/vessels/events/ais-lose` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |mmsi|船舶MMSI|body|true|integer(int32)| |startTime|开始时间|body|true|string(date-time)| |endTime|结束时间|body|true|string(date-time)| |lostMins|丢失分钟数|body|false|integer(int32)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | startTime|开始时间|string(date-time)| | endTime|结束时间|string(date-time)| | startLon|开始经度|number| | startLat|开始纬度|number| | endLon|结束经度|number| | endLat|结束纬度|number| | lostMins|丢失分钟数,向下取整|integer(int32)| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 5.13. 指定区域查询历史进出船舶列表 **接口描述**:指定区域查询历史进出船舶列表 **接口地址**:`/v1/mkt/vessels/events/cross/region/his` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |mmsiList|MMSI列表|body|false|array[integer(int32)]| |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |flagCtry|船旗国|body|false|string| |dwt|最小载重吨|body|false|integer(int32)| |dwt2|最大载重吨|body|false|integer(int32)| |grt|最小总吨|body|false|integer(int32)| |grt2|最大总吨|body|false|integer(int32)| |teu|最小载箱数|body|false|integer(int32)| |teu2|最大载箱数|body|false|integer(int32)| |startTime|开始时间|body|true|string(date-time)| |endTime|结束时间|body|true|string(date-time)| |region|区域对象(支持圆形、矩形及任意线段组合的多边形)|body|true|object| | regionType|对象类型, 区域查询时必填|body|false|string| | leftTop|矩形左上角坐标,regionType='rectangle'时必填|body|false|object| | lon|经度|body|false|number| | lat|纬度|body|false|number| | rightBottom|矩形右下角坐标,regionType='rectangle'时必填|body|false|object| | lon|经度|body|false|number| | lat|纬度|body|false|number| | center|圆心坐标,regionType='circle'时必填|body|false|object| | lon|经度|body|false|number| | lat|纬度|body|false|number| | radius|圆形半径(海里),regionType='circle'时必填|body|false|number| | points|多边形连续点,不少于三个,regionType='polygon'时必填|body|false|array[object]| | lon|经度|body|false|number| | lat|纬度|body|false|number| | moveAngle|扇形对角线方向(度),regionType='sector'时必填|body|false|number| | scaleAngle|扇形对角线方向单侧夹角(度),regionType='sector'时必填|body|false|number| |page|分页参数|body|true|object| | pageNum|页数|body|false|integer(int32)| | pageSize|每页记录数|body|false|integer(int32)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | mmsi|船舶MMSI|integer(int32)| | imo|船舶IMO|string| | callsign|船舶呼号|string| | nameEn|船舶英文名|string| | nameCn|船舶中文名|string| | vesselType|一级船型|string| | vesselTypeNameCn|一级船型中文名|string| | vesselTypeNameEn|一级船型英文名|string| | vesselSubType|二级船型|string| | vesselSubTypeNameCn|二级船型中文名|string| | vesselSubTypeNameEn|二级船型英文名|string| | vesselSub2Type|三级船型|string| | vesselSub2TypeNameCn|三级船型中文名|string| | vesselSub2TypeNameEn|三级船型英文名|string| | flagCtry|船旗国|string| | flagCtryNameCn|船旗国中文名|string| | flagCtryNameEn|船旗国英文名|string| | dwt|载重吨(吨)|integer(int32)| | grt|总吨|integer(int32)| | teu|载箱数|integer(int32)| | crossNum|穿越次数|integer(int32)| | lastCrossTime|最后一次穿越的开始时间|string(date-time)| | crossDetails|穿越详情信息|array[object]| | startTime|穿越开始时间|string(date-time)| | endTime|穿越结束时间|string(date-time)| | crossHour|穿越小时|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 5.14. 指定区域查询历史进出船舶列表 **接口描述**:指定区域查询历史进出船舶列表 **接口地址**:`/v1/mkt/vessels/events/cross/region/his/page` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |mmsiList|MMSI列表|body|false|array[integer(int32)]| |vesselType|一级船型|body|false|array[string]| |vesselSubType|二级船型|body|false|array[string]| |vesselSub2Type|三级船型|body|false|array[string]| |flagCtry|船旗国|body|false|string| |dwt|最小载重吨|body|false|integer(int32)| |dwt2|最大载重吨|body|false|integer(int32)| |grt|最小总吨|body|false|integer(int32)| |grt2|最大总吨|body|false|integer(int32)| |teu|最小载箱数|body|false|integer(int32)| |teu2|最大载箱数|body|false|integer(int32)| |startTime|开始时间|body|true|string(date-time)| |endTime|结束时间|body|true|string(date-time)| |region|区域对象(支持圆形、矩形及任意线段组合的多边形)|body|true|object| | regionType|对象类型, 区域查询时必填|body|false|string| | leftTop|矩形左上角坐标,regionType='rectangle'时必填|body|false|object| | lon|经度|body|false|number| | lat|纬度|body|false|number| | rightBottom|矩形右下角坐标,regionType='rectangle'时必填|body|false|object| | lon|经度|body|false|number| | lat|纬度|body|false|number| | center|圆心坐标,regionType='circle'时必填|body|false|object| | lon|经度|body|false|number| | lat|纬度|body|false|number| | radius|圆形半径(海里),regionType='circle'时必填|body|false|number| | points|多边形连续点,不少于三个,regionType='polygon'时必填|body|false|array[object]| | lon|经度|body|false|number| | lat|纬度|body|false|number| | moveAngle|扇形对角线方向(度),regionType='sector'时必填|body|false|number| | scaleAngle|扇形对角线方向单侧夹角(度),regionType='sector'时必填|body|false|number| |page|分页参数|body|true|object| | pageNum|页数|body|false|integer(int32)| | pageSize|每页记录数|body|false|integer(int32)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | totalElements||integer(int64)| | totalPages||integer(int32)| | size||integer(int32)| | content||array[object]| | mmsi|船舶MMSI|integer(int32)| | imo|船舶IMO|string| | callsign|船舶呼号|string| | nameEn|船舶英文名|string| | nameCn|船舶中文名|string| | vesselType|一级船型|string| | vesselTypeNameCn|一级船型中文名|string| | vesselTypeNameEn|一级船型英文名|string| | vesselSubType|二级船型|string| | vesselSubTypeNameCn|二级船型中文名|string| | vesselSubTypeNameEn|二级船型英文名|string| | vesselSub2Type|三级船型|string| | vesselSub2TypeNameCn|三级船型中文名|string| | vesselSub2TypeNameEn|三级船型英文名|string| | flagCtry|船旗国|string| | flagCtryNameCn|船旗国中文名|string| | flagCtryNameEn|船旗国英文名|string| | dwt|载重吨(吨)|integer(int32)| | grt|总吨|integer(int32)| | teu|载箱数|integer(int32)| | crossNum|穿越次数|integer(int32)| | lastCrossTime|最后一次穿越的开始时间|string(date-time)| | crossDetails|穿越详情信息|array[object]| | startTime|穿越开始时间|string(date-time)| | endTime|穿越结束时间|string(date-time)| | crossHour|穿越小时|number| | number||integer(int32)| | sort||object| | empty||boolean| | sorted||boolean| | unsorted||boolean| | numberOfElements||integer(int32)| | pageable||object| | offset||integer(int64)| | sort||object| | empty||boolean| | sorted||boolean| | unsorted||boolean| | pageSize||integer(int32)| | pageNumber||integer(int32)| | paged||boolean| | unpaged||boolean| | first||boolean| | last||boolean| | empty||boolean| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ## 6. API市场-水文气象数据接口 ### 6.1. 按位置查询海风预报数据 **接口描述**:按位置查询海风10日预报(0.25度,3小时) **接口地址**:`/v1/mkt/weather/forecast/wind` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |lon|经度|body|true|number| |lat|纬度|body|true|number| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | windSpeed|风速(米/秒)|number| | windSpeedDescCn|风速中文描述|string| | windSpeedDescEn|风速英文描述|string| | windLevelDescCn|风速等级中文描述|string| | windLevelDescEn|风速等级英文描述|string| | windDirection|风向(度)|number| | windDirectionDescCn|风向中文描述|string| | windDirectionDescEn|风向英文描述|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 6.2. 按位置查询海浪预报数据 **接口描述**:按位置查询海浪10日预报(0.25度,3小时) **接口地址**:`/v1/mkt/weather/forecast/wave` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |lon|经度|body|true|number| |lat|纬度|body|true|number| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | seaWaveHeight|浪高(米)|number| | seaWaveHeightDescCn|浪高中文描述|string| | seaWaveHeightDescEn|浪高英文描述|string| | seaWaveDirection|浪向(度)|number| | seaWaveDirectionDescCn|浪向中文描述|string| | seaWaveDirectionDescEn|浪向英文描述|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 6.3. 按位置查询洋流预报数据 **接口描述**:按位置查询洋流10日预报(0.25度,3小时) **接口地址**:`/v1/mkt/weather/forecast/stream` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |lon|经度|body|true|number| |lat|纬度|body|true|number| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | streamSpeed|流速(米/秒)|number| | streamDirection|流向(度)|number| | streamDirectionDescCn|流向中文描述|string| | streamDirectionDescEn|流向英文描述|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 6.4. 按位置查询气压预报数据 **接口描述**:按位置查询气压10日预报(0.25度,3小时) **接口地址**:`/v1/mkt/weather/forecast/pressure` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |lon|经度|body|true|number| |lat|纬度|body|true|number| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | prmsl|海平面气压(百帕)|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 6.5. 按位置查询能见度预报数据 **接口描述**:按位置查询能见度10日预报(0.25度,3小时) **接口地址**:`/v1/mkt/weather/forecast/visibility` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |lon|经度|body|true|number| |lat|纬度|body|true|number| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | visibility|能见度(米)|number| | visibilityDescCn|能见度中文描述|string| | visibilityDescEn|能见度英文描述|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 6.6. 按位置查询基本气象要素预报数据 **接口描述**:按位置查询10日预报(0.25度,3小时) **接口地址**:`/v1/mkt/weather/forecast/base` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |lon|经度|body|true|number| |lat|纬度|body|true|number| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | wind|海风|object| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | windSpeed|风速(米/秒)|number| | windSpeedDescCn|风速中文描述|string| | windSpeedDescEn|风速英文描述|string| | windLevelDescCn|风速等级中文描述|string| | windLevelDescEn|风速等级英文描述|string| | windDirection|风向(度)|number| | windDirectionDescCn|风向中文描述|string| | windDirectionDescEn|风向英文描述|string| | wave|海浪|object| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | seaWaveHeight|浪高(米)|number| | seaWaveHeightDescCn|浪高中文描述|string| | seaWaveHeightDescEn|浪高英文描述|string| | seaWaveDirection|浪向(度)|number| | seaWaveDirectionDescCn|浪向中文描述|string| | seaWaveDirectionDescEn|浪向英文描述|string| | stream|洋流|object| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | streamSpeed|流速(米/秒)|number| | streamDirection|流向(度)|number| | streamDirectionDescCn|流向中文描述|string| | streamDirectionDescEn|流向英文描述|string| | pressure|气压|object| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | prmsl|海平面气压(百帕)|number| | vis|能见度|object| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | visibility|能见度(米)|number| | visibilityDescCn|能见度中文描述|string| | visibilityDescEn|能见度英文描述|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 6.7. 按位置查询全部气象要素预报数据 **接口描述**:按位置查询10日预报(0.25度,3小时) **接口地址**:`/v1/mkt/weather/forecast/full` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |lon|经度|body|true|number| |lat|纬度|body|true|number| |weatherElements|气象要素,AIRTEMP: 海面气温,RAIN: 降雨,WATERTEMP: 海水水温,PRESSURE: 气压,VIS: 能见度,WIND: 风,STREAM: 流,WAVE: 浪,WAVE_PERIOD: 浪周期,SWELL: 涌,SWELL_PERIOD: 涌周期,STORM: 风浪|body|true|array[string]| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | wind|海风|object| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | windSpeed|风速(米/秒)|number| | windSpeedDescCn|风速中文描述|string| | windSpeedDescEn|风速英文描述|string| | windLevelDescCn|风速等级中文描述|string| | windLevelDescEn|风速等级英文描述|string| | windDirection|风向(度)|number| | windDirectionDescCn|风向中文描述|string| | windDirectionDescEn|风向英文描述|string| | wave|海浪|object| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | seaWaveHeight|浪高(米)|number| | seaWaveHeightDescCn|浪高中文描述|string| | seaWaveHeightDescEn|浪高英文描述|string| | seaWaveDirection|浪向(度)|number| | seaWaveDirectionDescCn|浪向中文描述|string| | seaWaveDirectionDescEn|浪向英文描述|string| | seaWavePeriod|浪周期(秒)|number| | seaSwellHeight|涌高(米)|number| | seaSwellHeightDescCn|涌高中文描述|string| | seaSwellHeightDescEn|涌高英文描述|string| | seaSwellDirection|涌向(度)|number| | seaSwellDirectionDescCn|涌向中文描述|string| | seaSwellDirectionDescEn|涌向英文描述|string| | seaSwellPeriod|涌周期(秒)|number| | storm|风浪高(米)|number| | stormDescCn|风浪高中文描述|string| | stormDescEn|风浪高英文描述|string| | stream|洋流|object| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | streamSpeed|流速(米/秒)|number| | streamDirection|流向(度)|number| | streamDirectionDescCn|流向中文描述|string| | streamDirectionDescEn|流向英文描述|string| | pressure|气压|object| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | prmsl|海平面气压(百帕)|number| | vis|能见度|object| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | visibility|能见度(米)|number| | visibilityDescCn|能见度中文描述|string| | visibilityDescEn|能见度英文描述|string| | precip|降水量|object| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | hourPrecipitation|降水量(毫米/3小时)|number| | temp|温度|object| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | temp|海面温度(摄氏度)|number| | waterTemp|海水温度(摄氏度)|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 6.8. 按位置查询海风历史数据 **接口描述**:按位置查询海风历史数据 **接口地址**:`/v1/mkt/weather/history/wind` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |lon|经度|body|true|number| |lat|纬度|body|true|number| |startTime|开始时间|body|true|string(date-time)| |endTime|结束时间|body|true|string(date-time)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | windSpeed|风速(米/秒)|number| | windSpeedDescCn|风速中文描述|string| | windSpeedDescEn|风速英文描述|string| | windLevelDescCn|风速等级中文描述|string| | windLevelDescEn|风速等级英文描述|string| | windDirection|风向(度)|number| | windDirectionDescCn|风向中文描述|string| | windDirectionDescEn|风向英文描述|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 6.9. 按位置查询海浪历史数据 **接口描述**:按位置查询海浪历史数据 **接口地址**:`/v1/mkt/weather/history/wave` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |lon|经度|body|true|number| |lat|纬度|body|true|number| |startTime|开始时间|body|true|string(date-time)| |endTime|结束时间|body|true|string(date-time)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | seaWaveHeight|浪高(米)|number| | seaWaveHeightDescCn|浪高中文描述|string| | seaWaveHeightDescEn|浪高英文描述|string| | seaWaveDirection|浪向(度)|number| | seaWaveDirectionDescCn|浪向中文描述|string| | seaWaveDirectionDescEn|浪向英文描述|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 6.10. 按位置查询洋流历史数据 **接口描述**:按位置查询洋流历史数据 **接口地址**:`/v1/mkt/weather/history/stream` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |lon|经度|body|true|number| |lat|纬度|body|true|number| |startTime|开始时间|body|true|string(date-time)| |endTime|结束时间|body|true|string(date-time)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | streamSpeed|流速(米/秒)|number| | streamDirection|流向(度)|number| | streamDirectionDescCn|流向中文描述|string| | streamDirectionDescEn|流向英文描述|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 6.11. 按位置查询气压历史数据 **接口描述**:按位置查询气压历史数据 **接口地址**:`/v1/mkt/weather/history/pressure` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |lon|经度|body|true|number| |lat|纬度|body|true|number| |startTime|开始时间|body|true|string(date-time)| |endTime|结束时间|body|true|string(date-time)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | prmsl|海平面气压(百帕)|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 6.12. 按位置查询能见度历史数据 **接口描述**:按位置查询能见度历史数据 **接口地址**:`/v1/mkt/weather/history/visibility` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |lon|经度|body|true|number| |lat|纬度|body|true|number| |startTime|开始时间|body|true|string(date-time)| |endTime|结束时间|body|true|string(date-time)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | visibility|能见度(米)|number| | visibilityDescCn|能见度中文描述|string| | visibilityDescEn|能见度英文描述|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 6.13. 按位置查询基本气象要素历史数据 **接口描述**:按位置查询基本气象要素历史数据 **接口地址**:`/v1/mkt/weather/history/base` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |lon|经度|body|true|number| |lat|纬度|body|true|number| |dateTime|查询时间|body|true|string(date-time)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | wind|海风|object| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | windSpeed|风速(米/秒)|number| | windSpeedDescCn|风速中文描述|string| | windSpeedDescEn|风速英文描述|string| | windLevelDescCn|风速等级中文描述|string| | windLevelDescEn|风速等级英文描述|string| | windDirection|风向(度)|number| | windDirectionDescCn|风向中文描述|string| | windDirectionDescEn|风向英文描述|string| | wave|海浪|object| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | seaWaveHeight|浪高(米)|number| | seaWaveHeightDescCn|浪高中文描述|string| | seaWaveHeightDescEn|浪高英文描述|string| | seaWaveDirection|浪向(度)|number| | seaWaveDirectionDescCn|浪向中文描述|string| | seaWaveDirectionDescEn|浪向英文描述|string| | stream|洋流|object| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | streamSpeed|流速(米/秒)|number| | streamDirection|流向(度)|number| | streamDirectionDescCn|流向中文描述|string| | streamDirectionDescEn|流向英文描述|string| | pressure|气压|object| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | prmsl|海平面气压(百帕)|number| | vis|能见度|object| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | visibility|能见度(米)|number| | visibilityDescCn|能见度中文描述|string| | visibilityDescEn|能见度英文描述|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 6.14. 按位置查询全部气象要素历史数据 **接口描述**:按位置查询全部气象要素历史数据 **接口地址**:`/v1/mkt/weather/history/full` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |lon|经度|body|true|number| |lat|纬度|body|true|number| |dateTime|查询时间|body|true|string(date-time)| |weatherElements|气象要素,AIRTEMP: 海面气温,RAIN: 降雨,WATERTEMP: 海水水温,PRESSURE: 气压,VIS: 能见度,WIND: 风,STREAM: 流,WAVE: 浪,WAVE_PERIOD: 浪周期,SWELL: 涌,SWELL_PERIOD: 涌周期,STORM: 风浪|body|true|array[string]| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | wind|海风|object| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | windSpeed|风速(米/秒)|number| | windSpeedDescCn|风速中文描述|string| | windSpeedDescEn|风速英文描述|string| | windLevelDescCn|风速等级中文描述|string| | windLevelDescEn|风速等级英文描述|string| | windDirection|风向(度)|number| | windDirectionDescCn|风向中文描述|string| | windDirectionDescEn|风向英文描述|string| | wave|海浪|object| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | seaWaveHeight|浪高(米)|number| | seaWaveHeightDescCn|浪高中文描述|string| | seaWaveHeightDescEn|浪高英文描述|string| | seaWaveDirection|浪向(度)|number| | seaWaveDirectionDescCn|浪向中文描述|string| | seaWaveDirectionDescEn|浪向英文描述|string| | seaWavePeriod|浪周期(秒)|number| | seaSwellHeight|涌高(米)|number| | seaSwellHeightDescCn|涌高中文描述|string| | seaSwellHeightDescEn|涌高英文描述|string| | seaSwellDirection|涌向(度)|number| | seaSwellDirectionDescCn|涌向中文描述|string| | seaSwellDirectionDescEn|涌向英文描述|string| | seaSwellPeriod|涌周期(秒)|number| | storm|风浪高(米)|number| | stormDescCn|风浪高中文描述|string| | stormDescEn|风浪高英文描述|string| | stream|洋流|object| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | streamSpeed|流速(米/秒)|number| | streamDirection|流向(度)|number| | streamDirectionDescCn|流向中文描述|string| | streamDirectionDescEn|流向英文描述|string| | pressure|气压|object| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | prmsl|海平面气压(百帕)|number| | vis|能见度|object| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | visibility|能见度(米)|number| | visibilityDescCn|能见度中文描述|string| | visibilityDescEn|能见度英文描述|string| | precip|降水量|object| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | hourPrecipitation|降水量(毫米/3小时)|number| | temp|温度|object| | dateTime|气象时间(yyyy-MM-dd hh:mm:ss)|string(date-time)| | dateHourString|气象时间(yyyyMMddhh)|string| | temp|海面温度(摄氏度)|number| | waterTemp|海水温度(摄氏度)|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 6.15. 查询当前台风列表 **接口描述**:查询当前台风列表 **接口地址**:`/v1/mkt/weather/typhoon/new` **请求方式**:`GET` **请求数据类型**: **响应数据类型**:`*/*` **请求参数**:暂无 **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | typhoonCode|台风代码|string| | typhoonName|台风名称|string| | typhoonSource|台风机构|string| | typhoonNamedTime|台风生成时间|string(date-time)| | typhoonData|台风详细数据|array[]| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 6.16. 按年份分页查询历史台风列表 **接口描述**:按年份分页查询历史台风列表 **接口地址**:`/v1/mkt/weather/typhoon/history` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |typhoonYear|年份|body|true|integer(int32)| |pageNum|页数|body|false|integer(int32)| |pageSize|每页记录数|body|false|integer(int32)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | totalElements||integer(int64)| | totalPages||integer(int32)| | size||integer(int32)| | content||array[object]| | typhoonCode|台风代码|string| | typhoonName|台风名称|string| | typhoonSource|台风机构|string| | typhoonNamedTime|台风生成时间|string(date-time)| | typhoonData|台风详细数据|array[]| | number||integer(int32)| | sort||object| | empty||boolean| | sorted||boolean| | unsorted||boolean| | numberOfElements||integer(int32)| | pageable||object| | offset||integer(int64)| | sort||object| | empty||boolean| | sorted||boolean| | unsorted||boolean| | pageSize||integer(int32)| | pageNumber||integer(int32)| | paged||boolean| | unpaged||boolean| | first||boolean| | last||boolean| | empty||boolean| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 6.17. 按时间范围查询全球地震信息 **接口描述**:按时间范围查询全球地震信息 **接口地址**:`/v1/mkt/weather/earthquake` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |quakeStartTime|开始时间(yyyy-MM-dd HH:mm:ss)|body|false|string(date-time)| |quakeEndTime|结束时间(yyyy-MM-dd HH:mm:ss)|body|false|string(date-time)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | recordSubject|记录摘要|string| | recordTime|发布时间|string(date-time)| | recordDetail|记录详情|string| | centerLon|地震中心经度|number| | centerLat|地震中心纬度|number| | quakeLevel|地震等级|number| | quakeDepth|震源深度(公里)|number| | quakeTime|发生时间|string(date-time)| | regionName|区域名称|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 6.18. 查询全球潮汐测点信息 **接口描述**:查询全球潮汐测点信息 **接口地址**:`/v1/mkt/weather/tide/site` **请求方式**:`GET` **请求数据类型**: **响应数据类型**:`*/*` **请求参数**:暂无 **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | siteCode|测点编码|string| | nameCn|测点名称(中文)|string| | nameEn|测点名称(英文)|string| | lon|测点经度|number| | lat|测点纬度|number| | timezone|测点时区|string| | portCode|港口代码|string| | portNameCn|港口名称(中文)|string| | portNameEn|港口名称(英文)|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 6.19. 按日期查询指定测点潮汐数据 **接口描述**:按日期查询指定测点潮汐数据 **接口地址**:`/v1/mkt/weather/tide/data` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |siteCode|测点编码|body|true|string| |tideDate|潮汐日期|body|true|string(date-time)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | siteName|测点名称|string| | avgTideHeight|平均潮高|string| | timezone|测点时区|string| | extremum|潮汐极值|array[object]| | tideTime|潮时|string| | tideHeight|潮高|number| | detail|潮汐详情|array[object]| | tideTime|潮时|string(date-time)| | tideHeight|潮高|number| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 6.20. 查询全球潮流测点信息 **接口描述**:查询全球潮流测点信息 **接口地址**:`/v1/mkt/weather/current/site` **请求方式**:`GET` **请求数据类型**: **响应数据类型**:`*/*` **请求参数**:暂无 **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | siteCode|测点编码|string| | siteType|测点类型,2:往复流测点,3:旋转流测点|integer(int32)| | nameCn|测点名称(中文)|string| | nameEn|测点名称(英文)|string| | lon|测点经度|number| | lat|测点纬度|number| | timezone|测点时区|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 6.21. 按日期查询指定测点往复流数据 **接口描述**:按日期查询指定测点往复流数据 **接口地址**:`/v1/mkt/weather/current/data/revert` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |siteCode|测点编码|body|true|string| |currentDate|潮流日期|body|true|string(date-time)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | siteCode|测点编码|string| | siteName|测点名称|string| | timezone|时区|string| | recordTime|测点记录时间|string(date-time)| | currentDate|潮流日期|string| | speedUnit|速度单位|string| | negativeDirection|反向角度|number| | positiveDirection|正向角度|number| | hourSpeed|24小时流速|array[integer(int32)]| | hourDirection|24小时流向|array[integer(int32)]| | revertCurrentTime|转流时分|array[string]| | maxCurrentTime|最大流时分|array[string]| | maxCurrentSpeed|最大流流速|array[integer(int32)]| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 6.22. 按日期查询指定测点旋转流数据 **接口描述**:按日期查询指定测点旋转流数据 **接口地址**:`/v1/mkt/weather/current/data/rotary` **请求方式**:`POST` **请求数据类型**:`application/json` **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | |siteCode|测点编码|body|true|string| |currentDate|潮流日期|body|true|string(date-time)| **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|object| | siteCode|测点编码|string| | siteName|测点名称|string| | timezone|时区|string| | recordTime|测点记录时间|string(date-time)| | currentDate|潮流日期|string| | speedUnit|速度单位|string| | negativeDirection|反向角度|number| | positiveDirection|正向角度|number| | hourSpeed|24小时流速|array[integer(int32)]| | hourDirection|24小时流向|array[integer(int32)]| | currentTimes|流时|array[string]| | currentSpeed|流速|array[integer(int32)]| | currentDirection|流向|array[integer(int32)]| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ## 7. API市场-基础档案数据接口 ### 7.1. 查询全球洲代码列表 **接口描述**:查询全球洲代码列表 **接口地址**:`/v1/mkt/profiles/continents` **请求方式**:`GET` **请求数据类型**: **响应数据类型**:`*/*` **请求参数**:暂无 **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | continentCode|洲代码|string| | nameEn|英文名|string| | nameCn|中文名|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 7.2. 查询船旗国代码列表 **接口描述**:查询船旗国代码列表 **接口地址**:`/v1/mkt/profiles/countries` **请求方式**:`GET` **请求数据类型**: **响应数据类型**:`*/*` **请求参数**:暂无 **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | ctryCode|船期国二字码|string| | ctryNameCn|中文名|string| | ctryNameEn|英文名|string| | continentCode|洲代码|string| | continentNameCn|洲中文名|string| | continentNameEn|洲英文名|string| | lon|经度|number| | lat|维度|number| | tzOffset|UTC时差(单位:小时)|integer(int32)| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 7.3. 查询全球贸易区列表 **接口描述**:查询全球贸易区列表 **接口地址**:`/v1/mkt/profiles/trade/area` **请求方式**:`GET` **请求数据类型**: **响应数据类型**:`*/*` **请求参数**:暂无 **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | areaCode|贸易区代码|string| | nameCn|贸易区中文名|string| | nameEn|贸易区英文名|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 7.4. 查询全球关键海峡节点信息 **接口描述**:查询全球关键海峡节点信息 **接口地址**:`/v1/mkt/profiles/map-nodes` **请求方式**:`GET` **请求数据类型**: **响应数据类型**:`*/*` **请求参数**:暂无 **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | nodeCode|节点代码|string| | nameEn|节点英文名|string| | nameCn|节点中文名|string| | startLon|节点起点坐标经度|number| | startLat|节点起点坐标纬度|number| | endLon|节点终点坐标经度|number| | endLat|节点终点坐标纬度|number| | centerLon|节点中心坐标经度|number| | centerLat|节点中心坐标纬度|number| | direction|节点方向(H-水平,V-垂直)|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 7.5. 按年份查询当年日历信息 **接口描述**:按年份查询当年日历信息 **接口地址**:`/v1/mkt/profiles/date-dim` **请求方式**:`GET` **请求数据类型**: **响应数据类型**:`*/*` **请求参数**: | 参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | | :--- | :--- | :--- | :--- | :--- | | year | 查询年份 | query | true | integer(int32) | **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | dayCode|日期代码|string| | dayDescCn|日期中文描述|string| | dayDescEn|日期英文描述|string| | dayOfWeek|星期几|integer(int32)| | dayWeekDescCn|星期几中文描述|string| | dayWeekDescEn|星期几英文描述|string| | dayWeekAbbrCn|星期几中文缩写|string| | dayWeekAbbrEn|星期几英文缩写|string| | weekCode|周代码|string| | weekDescCn|周中文描述|string| | weekDescEn|周英文描述|string| | weekOfYear|年度周次|integer(int32)| | monthCode|月份代码|string| | monthDescCn|月份中文描述|string| | monthDescEn|月份英文描述|string| | monthOfYear|年度月次|integer(int32)| | quaterCode|季度代码|string| | quaterDescCn|季度中文描述|string| | quaterDescEn|季度英文描述|string| | quaterOfYear|年度季次|integer(int32)| | yearCode|年份代码|string| | lunarYearCode|农历年代码|string| | lunarYearDescCn|农历年份中文描述|string| | lunarYearDescEn|农历年份英文描述|string| | lunarMonthCode|农历月份代码|string| | lunarMonthDescCn|农历月份中文描述|string| | lunarMonthDescEn|农历月份英文描述|string| | lunarDayCode|农历日代码|string| | lunarDayDescCn|农历日中文描述|string| | lunarDayDescEn|农历日英文描述|string| | heavenlySterns|天干地支|string| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string| ### 7.6. 查询船舶三级船型基础数据 **接口描述**:查询船舶三级船型基础数据 **接口地址**:`/v1/mkt/profiles/vessel-types` **请求方式**:`GET` **请求数据类型**: **响应数据类型**:`*/*` **请求参数**:暂无 **响应参数**: | 参数名称 | 参数说明 | 数据类型 | | :--- | :--- | :--- | |code|异常错误code|string| |data|返回数据对象|array[object]| | vesselType|船舶类型代码(共三个层级)|string| | vesselTypeNameCn|船舶类型中文名|string| | vesselTypeNameEn|船舶类型英文名|string| | children|船舶子类型列表|| |status|http status:200访问正常;400业务异常;500系统内部未知异常;|integer(int32)| |success|true表示成功,false表示失败或出现异常|boolean| |message||string|
目录导航
撤销(Ctrl+Z)
重做(Ctrl+Y)
清空
H
标题(Ctrl+1~6)
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
粗体(Ctrl+B)
斜体(Ctrl+I)
删除线
插入引用(Ctrl+Q)
无序列表(Ctrl+U)
有序列表(Ctrl+O)
表格
插入分割线
插入链接(Ctrl+L)
插入图片
添加图片链接
插入代码块
保存(Ctrl+S)
关闭预览
关闭目录导航
关闭同步滚动
全屏(按ESC还原)