模型云开放接口
  1. 最佳实践
模型云开放接口
  • 文档说明
    • 应用集成
    • 阅读对象
    • 版本说明
    • 业务流程
  • 接口规则
    • 协议规则
    • 安全规范
  • 服务器API
    • 获取模型对象数据-新版
      • 通用
        • 获取指定类型对象列表
        • 获取面雨量(雨量站和权重)
        • 获取水工调度方案列表
        • 获取图层列表
        • 下载图层
        • 导出断面形状
      • 水文
        • 获取水文站的属性参数
        • 获取水库的属性参数
        • 获取子流域的模型参数
      • 率定
        • 获取率定场次列表
      • 一维
        • 获取一维水闸的闸孔列表
      • 管网
        • 获取排水泵参数
    • 应用计算-新版
      • 提交应用计算
      • 提交应用率定-自动率定
      • 停止计算
      • 获取计算状态详情
      • 获取计算日志-字符串
      • 提交自定义方案计算
      • 提交智能模型计算
    • 获取计算结果-新版
      • 通用
        • 获取解析后的文件路径
        • 获取计算结果目录
        • 获取计算结果文件
      • 水文
        • 获取水文模拟结果
      • 率定
        • 获取率定评定结果
        • 获取率定结果参数
        • 获取率定评定结果 V2
      • 一维
        • 获取一维结果的总体信息
        • 获取一维指定帧范围内所有断面的信息
        • 获取一维水闸信息
        • 获取一维水泵信息
        • 获取一维结果的总体信息 V2
        • 获取一维指定帧范围内所有断面的信息 V2
        • 获取一维蓄水池
      • 二维
        • 获取二维结果的总体信息
        • 获取二维指定帧范围内所有节点的信息
        • 获取二维指定帧范围内所有网格数据
        • 获取二维结果的总体信息 V2
        • 获取二维指定帧范围内所有节点的信息 V2
      • 管网
        • 获取管网模拟结果
        • 根据对象ID获取管网数据
        • 根据对象属性获取管网数据
    • 数据回调
      • 计算状态推送
  • 最佳实践
    • 管网项目实践
    • 城市内涝项目实践
    • 对接demo示例
    • 一维示例
      • 一维demo示例
    • 二维示例
      • 二维demo示例
    • 管网示例
      • 管网demo示例
    • 水文示例
      • 水文demo示例
  • 常见问题
    • 网格文件格式
  1. 最佳实践

城市内涝项目实践

[TOC]

接入简介#

XX项目接入的是水动力模型,由模型云系统为XX项目提供管网以及二维水动力算法与计算能力。边界数据为雨量站的降雨量和排水口的水位信息。模型云会根据传入的数据与设定的参数进行计算,然后根据选用的PngD2GisPng与floodRisk解析器,计算解析得到每一帧的gis信息的png图片与具有水信息的洪水风险统计的geojson数据。

流程图#

接入流程图
整体流程如流程图所示,其中主要分三个阶段,绿色代表的初期准备阶段,橙色代表计算阶段,红色代表计算结束获取结果阶段。

接口流程#

一、获取雨量站#

[获取雨量站]

二、获取排水口#

[获取排水口]

三、提交计算流程#

[提交应用计算]

四、回调结算结果状态#

[结果数据推送]

五、获取计算结果文件链接#

[获取解析后的文件路径]

六、png图片与洪水风险统计解析器#

如下是解析器的简要介绍,如需使用可以在提交应用计算的接口中查看使用方式。

PngD2GisPng解析器#

根据步长生成具有水深信息的解析器。水动力模型算法会根据建模信息以及边界条件生成出gis信息的数据。解析器会根据解析器参数生成多张图片,每一张为一帧。通过设置最小水深以及水深与颜色绑定的参数,生成对应的数据。示例图片如下,其中蓝色区域为达到最浅水深的地区,颜色越深代表水位越深。注意,返回链接为一个图片链接的数组,当数组数据为空时,代表当前位置的帧没有数据,代表的图片为空白图。
PngD2GisPng解析图示意图

floodRisk解析器#

floodRisk解析器为洪水预报分析解析器,该解析器会将整个计算时间区间内的达到风险预报水位的区域以geojson的形式呈现出来,geojson中的数据为三角网格。每个geojson三角网格内的信息包括,当前网格洪水到达时间、最高水深、持续时间、到达时间、结束时间、网格面积等信息。示例数据如下:
{
	"features": [{
		"geometry": {
			"coordinates": [
				[
					[120.17082045495809, 30.199801221653473],
					[120.17073234318656, 30.199753595217032],
					[120.17082633968474, 30.199725168528992],
					[120.17082045495809, 30.199801221653473]
				]
			]
		},
		"properties": {
			"FloodStartTime": "2022/06/2909:45:00",
			"MaxVelocity": 0.0304,
			"MaxDepth": 1.05,
			"TotalDuringTime": 75.0,
			"cellId": 348358,
			"FloodDuringTime": 75.0,
			"FloodEndTime": "2022/06/2911:00:00",
			"ArrivalTime": "2022/06/2911:00:00"
		}
	}, {
		"geometry": {
			"coordinates": [
				[
					[120.17075260420857, 30.19967168517509],
					[120.17087636788368, 30.19965331385718],
					[120.17082633968474, 30.199725168528992],
					[120.17075260420857, 30.19967168517509]
				]
			]
		},
		"properties": {
			"FloodStartTime": "2022/06/2909:45:00",
			"MaxVelocity": 0.0545,
			"MaxDepth": 1.05,
			"TotalDuringTime": 75.0,
			"cellId": 348373,
			"FloodDuringTime": 75.0,
			"FloodEndTime": "2022/06/2911:00:00",
			"ArrivalTime": "2022/06/2911:00:00"
		}
	}, {
		"geometry": {
			"coordinates": [
				[
					[120.17091467533675, 30.19975990672717],
					[120.17082633968474, 30.199725168528992],
					[120.17087636788368, 30.19965331385718],
					[120.17091467533675, 30.19975990672717]
				]
			]
		},
		"properties": {
			"FloodStartTime": "2022/06/2909:45:00",
			"MaxVelocity": 0.0373,
			"MaxDepth": 1.05,
			"TotalDuringTime": 75.0,
			"cellId": 348374,
			"FloodDuringTime": 75.0,
			"FloodEndTime": "2022/06/2911:00:00",
			"ArrivalTime": "2022/06/2911:00:00"
		}
	}, {
		"geometry": {
			"coordinates": [
				[
					[120.17091467533675, 30.19975990672717],
					[120.17082045495809, 30.199801221653473],
					[120.17082633968474, 30.199725168528992],
					[120.17091467533675, 30.19975990672717]
				]
			]
		},
		"properties": {
			"FloodStartTime": "2022/06/2909:45:00",
			"MaxVelocity": 0.0375,
			"MaxDepth": 1.05,
			"TotalDuringTime": 75.0,
			"cellId": 348381,
			"FloodDuringTime": 75.0,
			"FloodEndTime": "2022/06/2911:00:00",
			"ArrivalTime": "2022/06/2911:00:00"
		}
	}, {
		"geometry": {
			"coordinates": [
				[
					[120.17073234318656, 30.199753595217032],
					[120.17075260420857, 30.19967168517509],
					[120.17082633968474, 30.199725168528992],
					[120.17073234318656, 30.199753595217032]
				]
			]
		},
		"properties": {
			"FloodStartTime": "2022/06/2909:45:00",
			"MaxVelocity": 0.0423,
			"MaxDepth": 1.05,
			"TotalDuringTime": 75.0,
			"cellId": 348384,
			"FloodDuringTime": 75.0,
			"FloodEndTime": "2022/06/2911:00:00",
			"ArrivalTime": "2022/06/2911:00:00"
		}
	}],
	"type": "FeatureCollection"
}

floodRisk结果文件获取流程#

floodRisk获取流程不同于D2GisPng解析器,从流程图的第12步开始所有不同,floodRisk的解析结果文件可以直接在回调计算解析结束以后调通接口获取floodRisk积水风险统计geoJson获取到数据。
修改于 2024-01-17 06:37:02
上一页
管网项目实践
下一页
对接demo示例
Built with