MICAPS 第 4 类地面分析场。经纬格网，format: 'micaps4'。工厂 createFieldLayer。下表是库内带默认色标的产品。同一规范的其它要素见 自行绘制。每个产品都能绘制、裁剪，写在该产品的「能力」里。
参数
本页绘制用这些字段。范围写在记录的经纬界上。
| 参数 | 必选 | 用途 | 默认 |
|---|---|---|---|
data | 必选 | 解析出口的 values，一条经纬格网记录 | — |
product | 必选 | 画哪一列，与 parse 的 product 相同 | — |
pieces | 可选 | 分档色标。内置 tem / pre / hail / rh / ws / prs / td / tmax / tmin / p3 / p24 / t24 可省 | 产品默认档 |
range | 可选 | 过滤可见数值 [min, max] | 全开 |
fill | 可选 | cells / isobands / gradient | cells |
convert | 可选 | 绘制换算 (value) => number。自定义时必须同时传 pieces | 不换算 |
| 显示与交互 | 可选 | 见 图层 | — |
| 产品 | key | 单位 | 能力 |
|---|---|---|---|
| 平均温度 | tem | °C | 绘制 · 数据裁剪 |
| 降水 | pre | mm | 绘制 · 数据裁剪 |
| 冰雹概率 | hail | % | 绘制 · 数据裁剪 |
| 相对湿度 | rh | % | 绘制 · 数据裁剪 |
| 风速 | ws | m/s | 绘制 · 数据裁剪 |
| 海平面气压 | prs | hPa | 绘制 · 数据裁剪 |
| 露点 | td | °C | 绘制 · 数据裁剪 |
| 最高气温 | tmax | °C | 绘制 · 数据裁剪 |
| 最低气温 | tmin | °C | 绘制 · 数据裁剪 |
| 3小时变压 | p3 | hPa | 绘制 · 数据裁剪 |
| 24小时变压 | p24 | hPa | 绘制 · 数据裁剪 |
| 24小时变温 | t24 | °C | 绘制 · 数据裁剪 |
数据
十二个产品同一套 MICAPS 第 4 类 原件。纯文本，空白分隔，可一行写完。
diamond 4 说明
年 月 日 时 时效 层次
经度格距 纬度格距 起始经度 终止经度 起始纬度 终止纬度 纬向格点数 经向格点数 等值线间隔 等值线起始值 等值线终止值 平滑系数 加粗线值
格点值 …| 参数 | 含义 |
|---|---|
diamond 4 | 魔术字。认文件靠它 |
| 说明 | 文件标题，常见「时次_要素名」，如 2025年10月27日08时_平均温度。画哪一列仍写 parse 的 product |
| 年 / 月 / 日 / 时 | 时次，北京时。两位年按 2000 纪年。写出 UTC 的 dateTime |
| 时效 | 预报时效（小时），不进时间 |
| 层次 | 层次。地面分析常为 0 |
| 经度格距 / 纬度格距 | 经纬步长，必须大于 0 |
| 起始经度 / 终止经度 | 东西界。西界取较小值 |
| 起始纬度 / 终止纬度 | 南北界。北界取较大值 |
| 纬向格点数 | 一纬向上的格数，即列数 |
| 经向格点数 | 一经向上的格数，即行数 |
| 等值线间隔 / 起始值 / 终止值 / 平滑系数 / 加粗线值 | MICAPS 等值线参数。解析跳过 |
| 格点值 | 行 × 列 个数字，紧跟在头后面 |
数据区必须写满 行 × 列 个数，少了会报数据区短于行列。排列是先走完一条纬向（通常西→东），再换下一条纬向。文件里第一条纬向对着「起始纬度」：起始纬小于终止纬时，文件先南后北，解析后第 0 行落在北边；起始经度大于终止经度时，列也会对调，第 0 列落在西边。数字之间用空白隔开，一行几个都可以。绝对值 ≥ 9999 写成缺测；0 是有效零值，不是缺测。也可传 .gz / .bz2 / .zip / .tgz，按文件头解开再认 diamond 4。
平均温度
通过绘制经纬分析场，用来看平均温度。产品 key 为 tem，单位 °C。本产品能绘制、裁剪。
文件
MICAPS 第 4 类地面分析场（头 diamond 4）「平均温度」。format: 'micaps4'，product: 'tem'。也可传打包。
数据
文件规则见页头。本产品格点值是平均温度，单位 °C。缺测写 9999。
调用
const parsed = await parse(buffer, {
format: 'micaps4',
// 一次只出这一列
product: 'tem'
})
const layer = createFieldLayer({
// 解析出口
data: parsed.values,
// 画哪一列，与 parse 相同
product: 'tem',
// 等值面填色
fill: 'isobands'
})
layer.addTo(globe)当前场四至：layer.getBounds()。库不飞入，套合由地球宿主相机做。有 setClipPath 时是贴边区域与场的相交框。见 图层。
色标
中央气象台温度带。低于 −36 °C 或缺测透明。
| 档 (°C) | −36 | −28 | −24 | −20 | −16 | −12 | −8 | −4 | 0 | 4 | 8 | 12 | 16 | 20 | 24 | 28 | 32 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 色 | rgb(7, 30, 120) | rgb(27, 68, 159) | rgb(48, 106, 199) | rgb(78, 138, 221) | rgb(116, 163, 226) | rgb(155, 188, 232) | rgb(153, 205, 208) | rgb(151, 232, 173) | rgb(234, 219, 112) | rgb(250, 204, 79) | rgb(242, 155, 0) | rgb(240, 132, 10) | rgb(238, 102, 24) | rgb(231, 75, 26) | rgb(217, 51, 18) | rgb(194, 0, 3) | rgb(169, 2, 16) |
能力
绘制 cells / isobands / gradient 互斥。示例页默认等值面。
const layer = createFieldLayer({
// 解析出口
data: parsed.values,
// 画哪一列，与 parse 相同
product: 'tem',
// 等值面填色
fill: 'isobands'
})
// 切回逐格 / 渐变
layer.setFill('cells')
layer.setFill('gradient')数据裁剪 setClipPath 按省界贴边。clipField 只给导出 / 统计。
const clipped = clipField(parsed.values, {
// 要裁的列，与 parse 相同
product: 'tem',
boundary
})
layer.setClipPath(boundary)降水
通过绘制经纬分析场，用来看降水。产品 key 为 pre，单位 mm。低于 0.1 mm（含 0）或缺测透明。本产品能绘制、裁剪。
文件
MICAPS 第 4 类「降水」。format: 'micaps4'，product: 'pre'。
数据
文件规则见页头。本产品格点值是降水，单位 mm。0 是有效零降水。缺测写 9999。低于 0.1 mm（含 0）铺色透明。
调用
const layer = createFieldLayer({
// 解析出口
data: parsed.values,
// 画哪一列，与 parse 相同
product: 'pre'
})色标
GB/T 28592 档位。
| 档 (mm) | 0.1 | 10 | 25 | 50 | 100 | 250 |
|---|---|---|---|---|---|---|
| 色 | rgb(166, 242, 143) | rgb(61, 186, 61) | rgb(97, 184, 255) | rgb(0, 115, 255) | rgb(250, 38, 255) | rgb(133, 0, 133) |
能力
绘制 cells / isobands / gradient 互斥。低于 0.1 mm（含 0）不铺色。
数据裁剪 列名写 pre。
const clipped = clipField(parsed.values, {
// 要裁的列，与 parse 相同
product: 'pre',
boundary
})
layer.setClipPath(boundary)冰雹概率
通过绘制经纬分析场，用来看冰雹概率。产品 key 为 hail，单位 %。低于 5%（含 0）或缺测透明。本产品能绘制、裁剪。
文件
MICAPS 第 4 类「冰雹概率」。format: 'micaps4'，product: 'hail'。
数据
文件规则见页头。本产品格点值是冰雹概率，单位 %。缺测写 9999。低于 5%（含 0）铺色透明。
调用
const layer = createFieldLayer({
// 解析出口
data: parsed.values,
// 画哪一列，与 parse 相同
product: 'hail'
})色标
| 档 (%) | 5 | 10 | 20 | 30 | 40 | 50 | 60 | 70 | 80 | 90 | 100 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| 色 | rgb(199, 214, 245) | rgb(238, 244, 251) | rgb(245, 248, 250) | rgb(250, 248, 224) | rgb(246, 244, 168) | rgb(244, 244, 0) | rgb(242, 194, 0) | rgb(242, 138, 0) | rgb(240, 69, 0) | rgb(255, 0, 0) | rgb(200, 0, 0) |
能力
绘制 cells / isobands / gradient 互斥。低于 5%（含 0）不铺色。
数据裁剪 列名写 hail。细写见 数据裁剪。对照 裁剪示例。
相对湿度
通过绘制经纬分析场，用来看相对湿度。产品 key 为 rh，单位 %。本产品能绘制、裁剪。
文件
MICAPS 第 4 类「相对湿度」。format: 'micaps4'，product: 'rh'。也可传打包。
数据
文件规则见页头。本产品格点值是相对湿度，单位 %。缺测写 9999。
调用
const layer = createFieldLayer({
// 解析出口
data: parsed.values,
// 画哪一列，与 parse 相同
product: 'rh',
// 等值面填色
fill: 'isobands'
})色标
常见业务湿度带。官方色表未到。低于 0% 或缺测透明。
| 档 (%) | 0 | 10 | 20 | 30 | 40 | 50 | 60 | 70 | 80 | 90 | 100 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| 色 | rgb(180, 90, 40) | rgb(220, 160, 60) | rgb(240, 210, 80) | rgb(200, 220, 100) | rgb(140, 200, 90) | rgb(80, 180, 110) | rgb(40, 160, 140) | rgb(30, 130, 180) | rgb(40, 90, 190) | rgb(50, 50, 170) | rgb(80, 30, 140) |
能力
绘制 cells / isobands / gradient 互斥。示例页默认等值面。
风速
通过绘制经纬分析场，用来看水平风速。产品 key 为 ws，单位 m/s。本产品能绘制、裁剪。
文件
MICAPS 第 4 类「风速」。format: 'micaps4'，product: 'ws'。也可传打包。
数据
文件规则见页头。本产品格点值是水平风速，单位 m/s。缺测写 9999。0 是有效静风。
调用
const layer = createFieldLayer({
// 解析出口
data: parsed.values,
// 画哪一列，与 parse 相同
product: 'ws',
// 等值面填色
fill: 'isobands'
})色标
常见业务风速带。官方色表未到。低于 0 m/s 或缺测透明。
| 档 (m/s) | 0 | 2 | 4 | 6 | 8 | 10 | 12 | 14 | 16 | 18 | 20 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| 色 | rgb(200, 230, 255) | rgb(150, 210, 180) | rgb(80, 190, 80) | rgb(180, 210, 60) | rgb(240, 220, 50) | rgb(250, 180, 40) | rgb(240, 120, 30) | rgb(220, 60, 30) | rgb(180, 20, 40) | rgb(140, 10, 80) | rgb(100, 20, 120) |
能力
绘制 cells / isobands / gradient 互斥。示例页默认等值面。
海平面气压
通过绘制经纬分析场，用来看海平面气压。产品 key 为 prs，单位 hPa。不要写成模式 slp，不要用目录名 p0。本产品能绘制、裁剪。
文件
MICAPS 第 4 类「海平面气压」。format: 'micaps4'，product: 'prs'。也可传打包。
数据
文件规则见页头。本产品格点值是海平面气压，单位 hPa。缺测写 9999。示例按同一份 08 时气温场格点对格点推冷高暖低，不是官方气压原件。
调用
const layer = createFieldLayer({
// 解析出口
data: parsed.values,
// 画哪一列，与 parse 相同
product: 'prs',
// 等值面填色
fill: 'isobands'
})色标
常见业务气压带。官方色表未到。低于 980 hPa 或缺测透明。
| 档 (hPa) | 980 | 990 | 1000 | 1005 | 1010 | 1015 | 1020 | 1025 | 1030 | 1040 |
|---|---|---|---|---|---|---|---|---|---|---|
| 色 | rgb(20, 40, 140) | rgb(40, 90, 190) | rgb(70, 150, 210) | rgb(120, 200, 170) | rgb(190, 220, 110) | rgb(240, 210, 70) | rgb(250, 160, 40) | rgb(230, 90, 30) | rgb(190, 30, 40) | rgb(120, 10, 70) |
能力
绘制 cells / isobands / gradient 互斥。示例页默认等值面。
数据裁剪 列名写 prs。细写见 数据裁剪。对照 裁剪示例。
露点
通过绘制经纬分析场，用来看露点。产品 key 为 td，单位 °C。本产品能绘制、裁剪。
文件
MICAPS 第 4 类「露点」。format: 'micaps4'，product: 'td'。也可传打包。
数据
文件规则见页头。本产品格点值是露点，单位 °C。缺测写 9999。示例按同一份气温场推，暖区露点差略大，且处处不超过气温。
调用
const layer = createFieldLayer({
// 解析出口
data: parsed.values,
// 画哪一列，与 parse 相同
product: 'td',
// 等值面填色
fill: 'isobands'
})色标
与平均温度同一套中央气象台温度带。低于 −36 °C 或缺测透明。
能力
绘制 cells / isobands / gradient 互斥。示例页默认等值面。
最高气温
通过绘制经纬分析场，用来看最高气温。产品 key 为 tmax，单位 °C。本产品能绘制、裁剪。
文件
MICAPS 第 4 类「最高气温」。format: 'micaps4'，product: 'tmax'。也可传打包。
数据
文件规则见页头。本产品格点值是最高气温，单位 °C。缺测写 9999。示例按 08 时气温场加日较差，不是第二时次差分。
调用
const layer = createFieldLayer({
// 解析出口
data: parsed.values,
// 画哪一列，与 parse 相同
product: 'tmax',
// 等值面填色
fill: 'isobands'
})色标
与平均温度同一套中央气象台温度带。低于 −36 °C 或缺测透明。
能力
绘制 cells / isobands / gradient 互斥。示例页默认等值面。
数据裁剪 列名写 tmax。细写见 数据裁剪。对照 裁剪示例。
最低气温
通过绘制经纬分析场，用来看最低气温。产品 key 为 tmin，单位 °C。本产品能绘制、裁剪。
文件
MICAPS 第 4 类「最低气温」。format: 'micaps4'，product: 'tmin'。也可传打包。
数据
文件规则见页头。本产品格点值是最低气温，单位 °C。缺测写 9999。示例按 08 时气温场略下压，接近日最低。
调用
const layer = createFieldLayer({
// 解析出口
data: parsed.values,
// 画哪一列，与 parse 相同
product: 'tmin',
// 等值面填色
fill: 'isobands'
})色标
与平均温度同一套中央气象台温度带。低于 −36 °C 或缺测透明。
能力
绘制 cells / isobands / gradient 互斥。示例页默认等值面。
数据裁剪 列名写 tmin。细写见 数据裁剪。对照 裁剪示例。
3小时变压
通过绘制经纬分析场，用来看 3 小时变压。产品 key 为 p3，单位 hPa。正值升压，负值降压。本产品能绘制、裁剪。
文件
MICAPS 第 4 类「3小时变压」。format: 'micaps4'，product: 'p3'。也可传打包。
数据
文件规则见页头。本产品格点值是 3 小时变压，单位 hPa。缺测写 9999。0 是有效零变压。示例按秋季西北冷空气，与 24 小时变压同一空间型、幅度约两三成，不是官方差分。
调用
const layer = createFieldLayer({
// 解析出口
data: parsed.values,
// 画哪一列，与 parse 相同
product: 'p3',
// 等值面填色
fill: 'isobands'
})色标
分正填色。降压暖色、升压冷色，零附近浅黄。官方色表未到。档向参照业务变压场与 EW4ALL 监测。低于 −2 hPa 或缺测透明。
| 档 (hPa) | −2 | −1 | 0 | 1 | 2 | 4 |
|---|---|---|---|---|---|---|
| 色 | rgb(220, 50, 30) | rgb(240, 160, 50) | rgb(250, 245, 200) | rgb(140, 200, 160) | rgb(50, 140, 200) | rgb(40, 50, 160) |
能力
绘制 cells / isobands / gradient 互斥。示例页默认等值面。
24小时变压
通过绘制经纬分析场，用来看 24 小时变压。产品 key 为 p24，单位 hPa。正值升压，负值降压。本产品能绘制、裁剪。
文件
MICAPS 第 4 类「24小时变压」。format: 'micaps4'，product: 'p24'。也可传打包。
数据
文件规则见页头。本产品格点值是 24 小时变压，单位 hPa。缺测写 9999。0 是有效零变压。示例与 24 小时变温反号：降温升压、升温减压，不是官方差分。
调用
const layer = createFieldLayer({
// 解析出口
data: parsed.values,
// 画哪一列，与 parse 相同
product: 'p24',
fill: 'isobands'
})色标
分正填色。降压暖色、升压冷色，零附近浅黄。官方色表未到。档向参照业务变压场与 EW4ALL 监测。低于 −6 hPa 或缺测透明。
| 档 (hPa) | −6 | −4 | −2 | 0 | 2 | 4 | 6 | 8 | 10 |
|---|---|---|---|---|---|---|---|---|---|
| 色 | rgb(160, 10, 40) | rgb(220, 50, 30) | rgb(240, 140, 40) | rgb(250, 245, 200) | rgb(160, 210, 160) | rgb(70, 170, 200) | rgb(40, 100, 190) | rgb(40, 50, 160) | rgb(80, 20, 120) |
能力
绘制 与 3 小时变压同一套。对照 24小时变压示例。
数据裁剪 列名写 p24。细写见 数据裁剪。对照 裁剪示例。
24小时变温
通过绘制经纬分析场，用来看 24 小时变温。产品 key 为 t24，单位 °C。正值升温，负值降温。本产品能绘制、裁剪。
文件
MICAPS 第 4 类「24小时变温」。format: 'micaps4'，product: 't24'。也可传打包。
数据
文件规则见页头。本产品格点值是 24 小时变温，单位 °C。缺测写 9999。0 是有效零变温。示例按秋季西北冷空气：北边、西边、已偏冷处继续降温，东南暖区小变或略升，不是官方差分。
调用
const layer = createFieldLayer({
// 解析出口
data: parsed.values,
// 画哪一列，与 parse 相同
product: 't24',
fill: 'isobands'
})色标
分正填色。降温冷色、升温暖色，零附近浅黄。官方色表未到。档向参照业务变温场与 EW4ALL 监测。低于 −10 °C 或缺测透明。
| 档 (°C) | −10 | −8 | −6 | −4 | −2 | 0 | 2 | 4 | 6 | 8 |
|---|---|---|---|---|---|---|---|---|---|---|
| 色 | rgb(70, 20, 130) | rgb(40, 50, 180) | rgb(40, 110, 210) | rgb(80, 180, 220) | rgb(170, 220, 210) | rgb(250, 245, 200) | rgb(250, 200, 80) | rgb(240, 130, 40) | rgb(210, 50, 30) | rgb(140, 10, 50) |
能力
绘制 与平均温度同一套接口。对照 24小时变温示例。