Jian Project GET 服务

HTTPS GET UTF-8 JSON 每 IP ≥1 次/秒

获取服务器时间、IP 归属查询、国内雷达、云图、降水预报、台风、气象站、AQI、台湾省雷达、日本雷达、全球热带气旋、风场。适合学习与对接调试。

主服务器:https://api.sismotide.top/get

备用服务器:https://api.jianproject.cloud/get

请求方式:GET https://主机/get/[路径].json,例如 https://api.sismotide.top/get/radar.json(.php 与 .json 同义)

鉴权:不需要访问令牌。防滥用见 频率限制。

编码:UTF-8 JSON

说明:本页为 GET API 字段说明;响应为 HTTPS GET JSON。暂无数据时返回 HTTP 503。

请求地址

类型 地址
主站 https://api.sismotide.top/get/[路径].json
备服 https://api.jianproject.cloud/get/[路径].json

可用路径

侧栏「GET 路径」为字段说明(本页 #hash);JSON 接口路径与下表一致。

路径 source 说明 文档
/get/ntp.json ntp 获取服务器时间 查看
/get/ip.json ip IP 归属查询 查看
/get/radar.json radar 全国最新雷达矢量图 查看
/get/cloud.json cloud 全国最新云图 查看
/get/precip-forecast.json precip-forecast 全国最新降水预报 查看
/get/typhoon.json typhoon 实时台风 查看
/get/station.json station 全国气象站 查看
/get/aqi.json aqi 全国最新城市 AQI 指数 查看
/get/radar-taiwan.json radar-taiwan 台湾省雷达矢量图 查看
/get/radar-japan.json radar-japan 日本雷达矢量图 查看
/get/typhoon-global.json typhoon-global 全球热带气旋 查看
/get/wind.json wind 全球实时风场 查看

基础瓦片地图

底图 XYZ 瓦片由独立域名提供(标准 {z}/{x}/{y}),不走本页 JSON /get/*。

主站:https://tilemap.sismotide.top/{source}/{z}/{x}/{y}

备站:https://tilemap.jianproject.cloud/{source}/{z}/{x}/{y}

完整说明(左右分栏文档):tilemap.sismotide.top

通用约定

  • 全国最新雷达 / 云图 / 日本雷达:带图片与地图范围;全国最新降水预报:可叠地图的降雨区域;全国最新城市 AQI 指数:城市列表。
  • size 为图像像素尺寸;time 为时次(北京时间)。
  • 缺字段省略,不补 0 或空串。
  • 响应格式见 消息协议;各路径字段见侧栏对应章节。
  • 仅供学习研究,不保证稳定性。

频率限制

本服务不需要访问令牌。为防滥用,按客户端真实 IP 做请求频率限制(经 CDN 时取 CDN / X-Forwarded-For 规则与站内一致)。

默认限额

项目 规则
最小间隔 同一客户端 IP 对业务路径至少间隔 1 秒 1 次
计入路径 /get/ntp.json、/get/ip.json、/get/radar.json、/get/cloud.json、/get/precip-forecast.json、/get/typhoon.json、/get/typhoon-global.json、/get/wind.json、/get/station.json、/get/aqi.json、/get/radar-japan.json、/get/radar-taiwan.json 等业务 GET
不计频 /health 健康检查不计入上述间隔

超限响应

超过频率限制时返回 HTTP 429,正文为 JSON:

请求过于频繁
{
  "error": "请求过于频繁,请至少间隔 1 秒"
}

对接建议

  • 客户端应对图片 / 列表结果做本地缓存,避免无意义轮询。
  • 收到 429 后应退避重试,勿瞬时连打。
  • 更多说明见 服务条款 与 隐私政策。

消息协议

全部为 HTTPS GET,响应 Content-Type: application/json; charset=utf-8,UTF-8 JSON。

图片类

雷达 / 云图 / 日本雷达:status + time + size + image

降水

全国最新降水预报(24/48/72 小时)

数组类

台风:顶级 JSON 数组

风场类

全球风场:status + time + source + data[u,v]

列表类

气象站:time + count + data[]

数组类 · AQI

城市 AQI:顶级 JSON 数组(城市汇总)

获取服务器时间

UTC / 北京时间 + 国家授时中心对时状态

IP 归属

国家/省市区/运营商/经纬度(缺字段省略)

图片类成功示例

适用于 /get/radar.json、/get/cloud.json、/get/radar-japan.json、/get/radar-taiwan.json。降水见 全国最新降水预报。

图片快照
{
  "status": "success",
  "time": "2026-09-22 10:36:00",
  "size": {
    "width": 1349,
    "height": 1208
  },
  "image": "data:image/png;base64,..."
}

错误响应

参数错误多为 HTTP 400;暂无数据多为 503;频率超限为 429。正文统一为:

错误
{
  "error": "错误说明"
}

查询参数

路径 参数 说明
/get/precip-forecast.json period 24 / 48 / 72,缺省 24
/get/station.json type 必填;temperature 等要素或 all
/get/ntp.json — 无查询参数
/get/ip.json ip 可选;缺省为客户端真实 IP

各路径完整字段见侧栏对应章节。

获取服务器时间 GET API 字段说明文档

主服务器:https://api.sismotide.top/get/ntp.json

备用服务器:https://api.jianproject.cloud/get/ntp.json

说明:获取经国家授时中心校时后的服务器时间

示例

{
  "ms": 1759575513453,
  "sec": 1759575513,
  "UTC": {
    "datetime": "2025-10-04 10:58:33",
    "datetime_ms": "2025-10-04 10:58:33.453",
    "iso": "2025-10-04T10:58:33Z",
    "tz": "UTC"
  },
  "Beijing": {
    "datetime": "2025-10-04 18:58:33",
    "datetime_ms": "2025-10-04 18:58:33.453",
    "iso": "2025-10-04T18:58:33+08:00",
    "tz": "Asia/Shanghai"
  }
}

字段说明

字段名类型必填说明
ms integer 是 Unix 毫秒时间戳(13 位)
sec integer 是 Unix 秒时间戳(10 位)
UTC object 是 协调世界时
UTC.datetime string 是 YYYY-MM-DD HH:mm:ss
UTC.datetime_ms string 是 带毫秒的日期时间
UTC.iso string 是 ISO 8601(UTC,Z 后缀)
UTC.tz string 是 时区标识 UTC
Beijing object 是 北京时间(东八区)
Beijing.datetime string 是 YYYY-MM-DD HH:mm:ss
Beijing.datetime_ms string 是 带毫秒的日期时间
Beijing.iso string 是 ISO 8601(+08:00)
Beijing.tz string 是 Asia/Shanghai

注意事项

  • GET;无需令牌。
  • 同一 IP 至少间隔 1 秒。
  • 后台约每 5 分钟向国家授时中心对时,出站时间为校正后的墙钟。
  • 接口通常返回 200;仅服务不可达时出现网络层错误。

IP 归属查询 GET API 字段说明文档

主服务器:https://api.sismotide.top/get/ip.json

备用服务器:https://api.jianproject.cloud/get/ip.json

说明:查询 IP 归属地

示例数据

{
  "ip": "222.137.1.1",
  "country": "中国",
  "country_code": "CN",
  "province": "河南",
  "city": "郑州",
  "district": "金水",
  "isp": "电信",
  "lat": 34.757,
  "lon": 113.649,
  "location": "中国·河南·郑州·金水·电信",
  "division_code": 410105
}

字段说明

字段名类型必填说明
ip string 是 查询的 IP
skipped bool 否 私网/回环等不可查时为 true
country string 否 国家中文名
country_code string 否 ISO 3166-1 alpha-2
province string 否 省/州
city string 否 城市
district string 否 区县
isp string 否 运营商
lat number 否 纬度
lon number 否 经度
location string 否 地名拼接摘要
division_code number 否 大陆行政区划代码
error string 否 参数错误说明

注意事项

  • GET;无需令牌。
  • 同一 IP 至少间隔 1 秒。
  • 大陆命中时省市区与 lat/lon 同源(区划中心点),不与全球库经纬度混拼。
  • 仅供参考,不对准确性做保证。

全国雷达矢量图 GET API 字段说明文档

主服务器:https://api.sismotide.top/get/radar.json

备用服务器:https://api.jianproject.cloud/get/radar.json

说明:获取全国最新雷达矢量图

示例数据

{
  "status": "success",
  "time": "2026-09-24 09:42:00",
  "bounds": {
    "sw": [11.1784, 67.5],
    "ne": [55.7766, 140.625]
  },
  "size": {
    "width": 1008,
    "height": 662
  },
  "image": "data:image/png;base64,..."
}

字段说明

字段名类型必填说明
status string 是 成功时为 success
time string 是 时次(北京时间)
bounds object 是 地图范围;sw/ne 为 [纬度, 经度]
size object 是 图片宽高(像素)
image string 是 图片内容(Base64)

注意事项

  • GET;无需令牌。
  • 同一 IP 至少间隔 1 秒。

实况云图 GET API 字段说明文档

主服务器:https://api.sismotide.top/get/cloud.json

备用服务器:https://api.jianproject.cloud/get/cloud.json

说明:获取全国最新云图

示例数据

{
  "status": "success",
  "time": "2026-09-24 09:50:00",
  "bounds": {
    "sw": [-2, 95],
    "ne": [43, 160]
  },
  "size": {
    "width": 1024,
    "height": 768
  },
  "image": "data:image/png;base64,..."
}

字段说明

字段名类型必填说明
status string 是 成功时为 success
time string 是 时次(北京时间)
bounds object 是 地图范围;sw/ne 为 [纬度, 经度]
size object 是 图片宽高(像素)
image string 是 图片内容(Base64)

注意事项

  • GET;无需令牌。
  • 同一 IP 至少间隔 1 秒。

全国最新降水预报 GET API 字段说明文档

主服务器:https://api.sismotide.top/get/precip-forecast.json?period=24

备用服务器:https://api.jianproject.cloud/get/precip-forecast.json?period=24

说明:获取全国最新降水预报(24 / 48 / 72 小时)

示例数据

{
  "type": "FeatureCollection",
  "properties": {
    "time": "2026-09-24 14:00:00"
  },
  "features": [
    {
      "type": "Feature",
      "properties": {
        "symbol": 0,
        "level": "小雨",
        "fillColor": "rgba(164, 245, 140, 1)",
        "color": "rgba(164, 245, 140, 1)"
      },
      "geometry": {
        "type": "Polygon",
        "coordinates": [[[115.758, 37.316]]]
      }
    }
  ]
}

字段说明

字段名类型必填说明
type string 是 固定 FeatureCollection
properties.time string 是 预报时间
features array 是 降雨区域列表
features[].properties.symbol integer 是 雨量等级数字
features[].properties.level string 是 雨量等级文字(小雨/中雨等)
features[].properties.fillColor string 是 填充颜色
features[].properties.color string 是 边线颜色
features[].geometry object 是 区域坐标(经度在前)

注意事项

  • GET;period 为 24 / 48 / 72,缺省 24。
  • 无需令牌;同一 IP 至少间隔 1 秒。

实时台风 GET API 字段说明文档

主服务器:https://api.sismotide.top/get/typhoon.json

备用服务器:https://api.jianproject.cloud/get/typhoon.json

说明:获取当前西太平洋及南海活跃台风

示例数据

[
  {
    "id": "202625",
    "name": "杜鹃",
    "name_en": "DUJUAN",
    "latitude": 38.2,
    "longitude": 147.4,
    "moveDirection": "东北东",
    "moveSpeed": 50,
    "power": 10,
    "pressure": 985,
    "windSpeed": 25,
    "type": "强热带风暴",
    "radius7": "400|300|300|300",
    "updateTime": "2026-09-22 08:00:00",
    "points": []
  }
]

字段说明

字段名类型必填说明
id string 是 台风编号(如 202625)
name string 否 中文名
name_en string 否 英文名
latitude number 否 中心纬度
longitude number 否 中心经度
moveDirection string 否 移向
moveSpeed number 否 移速 km/h
power integer 否 中心附近最大风力等级
pressure integer 否 中心气压 hPa
windSpeed number 否 中心附近最大风速 m/s
type string 否 强度等级文案
radius7 number|string 否 七级风圈;四象限时为原样字符串如 400|300|300|300
radius10 number|string 否 十级风圈;规则同 radius7
updateTime string 否 最新实况点时间(北京时间)
points array 否 完整实况路径点(有则保留)

注意事项

  • 响应为 JSON 数组;无活跃台风时为 []。
  • 缺字段则省略,不填 0 或空串。
  • 四象限风圈不压成单个假半径。
  • GET;无需令牌;同一 IP 至少间隔 1 秒。

全国气象站 GET API 字段说明文档

主服务器:https://api.sismotide.top/get/station.json?type=temperature

备用服务器:https://api.jianproject.cloud/get/station.json?type=temperature

说明:获取全国气象站指定要素(含台湾省);type 必填,type=all 返回该站全部可用要素

示例数据

{
  "time": "2026-09-22 11:00",
  "count": 3200,
  "data": [
    {
      "sta_name": "北京",
      "stationid": "54511",
      "lat": "39.8",
      "lon": "116.47",
      "val": "25.8"
    },
    {
      "sta_name": "臺北",
      "stationid": "466920",
      "lat": "25.039439",
      "lon": "121.506628",
      "val": "29.5"
    }
  ]
}

字段说明

字段名类型必填说明
time string 是 时次(北京时间)
count integer 是 本响应 data 条数
data array 是 站点数组
sta_name string 是 站名
stationid string 是 站号
lat string 是 纬度
lon string 是 经度
val string 条件 单要素查询时的数值;type=all 时不使用此字段
fx string 否 风向角度(风速类可能出现)
temperature string 否 type=all 时的气温
pressure string 否 type=all 时的气压
humidity string 否 type=all 时的相对湿度
windspeed string 否 type=all 时的风速
rain string 否 type=all 时的降水
visibility string 否 type=all 时的能见度

注意事项

  • type 必填:temperature / pressure / windspeed / maxwindspeed24h / humidity / visibility / rain / all。
  • type=all 时展开各要素;缺测字段省略。
  • 含台湾省站点;同站号去重保留一条。
  • 缺测值(如 -99)不出现在响应中。
  • maxwindspeed24h 暂不可用时 data 可能为空数组。
  • GET;无需令牌;同一 IP 至少间隔 1 秒。

全国最新城市 AQI 指数

主服务器:https://api.sismotide.top/get/aqi.json

备用服务器:https://api.jianproject.cloud/get/aqi.json

说明:全国最新城市空气质量指数(AQI)

示例数据

[
  {
    "TimePoint": "2026-09-24T09:00:00",
    "AQI": "43",
    "COLevel": 1,
    "NO2Level": 1,
    "O3Level": 1,
    "PM10Level": 1,
    "PM2_5Level": 1,
    "SO2Level": 1,
    "Area": "惠州市",
    "CityCode": 441300,
    "AqiLevel": 1,
    "Quality": "优",
    "Measure": "各类人群可正常活动",
    "Unheathful": "空气质量令人满意,基本无空气污染",
    "Latitude": "22.909185714285714",
    "Longitude": "114.47344285714286",
    "ProvinceId": 19,
    "PM2_5": "12",
    "PM10": "28",
    "SO2": "5",
    "NO2": "14",
    "CO": "0.5",
    "O3": "76",
    "O3_8h": "82"
  }
]

字段说明

字段名类型必填说明
TimePoint string 是 监测时次(北京时间,YYYY-MM-DDTHH:mm:ss)
AQI string 是 城市空气质量指数;取该市各站中 AQI 最大者
COLevel integer 是 一氧化碳分指数等级
NO2Level integer 是 二氧化氮分指数等级
O3Level integer 是 臭氧分指数等级
PM10Level integer 是 PM10 分指数等级
PM2_5Level integer 是 PM2.5 分指数等级
SO2Level integer 是 二氧化硫分指数等级
Area string 是 城市名称
CityCode integer 是 城市行政区划代码
AqiLevel integer 是 AQI 等级 1–6(优至严重污染);由 AQI 换算
PrimaryPollutant string 否 首要污染物;无则省略
Quality string 否 空气质量类别文案
Measure string 否 建议采取的措施
Unheathful string 否 对健康影响情况
Latitude string 是 城市纬度
Longitude string 是 城市经度
ProvinceId integer 是 省份标识
PM2_5 string 否 PM2.5 小时浓度 μg/m³
PM2_5_24h string 否 PM2.5 24 小时滑动平均
PM10 string 否 PM10 小时浓度 μg/m³
PM10_24h string 否 PM10 24 小时滑动平均
SO2 string 否 二氧化硫小时浓度 μg/m³
SO2_24h string 否 二氧化硫 24 小时滑动平均
NO2 string 否 二氧化氮小时浓度 μg/m³
NO2_24h string 否 二氧化氮 24 小时滑动平均
CO string 否 一氧化碳小时浓度 mg/m³
CO_24h string 否 一氧化碳 24 小时滑动平均
O3 string 否 臭氧 1 小时浓度 μg/m³
O3_24h string 否 臭氧相关 24 小时统计
O3_8h string 否 臭氧 8 小时滑动平均 μg/m³
O3_8h_24h string 否 臭氧 8 小时滑动平均的日统计

注意事项

  • GET;无需令牌。
  • 同一 IP 至少间隔 1 秒。
  • 缺测或 NA 的浓度字段省略,不补 0 或空串。

台湾省雷达矢量图

主服务器:https://api.sismotide.top/get/radar-taiwan.json

备用服务器:https://api.jianproject.cloud/get/radar-taiwan.json

说明:获取台湾省最新雷达矢量图

示例数据

{
  "status": "success",
  "time": "2026-09-25 14:30:00",
  "bounds": {
    "sw": [17.75, 115],
    "ne": [29.25, 126.5]
  },
  "size": {
    "width": 3600,
    "height": 3600
  },
  "image": "data:image/png;base64,..."
}

字段说明

字段名类型必填说明
status string 是 成功时为 success
time string 是 观测时刻
bounds object 是 图像覆盖范围的地理边界
bounds.sw array 是 西南角 [纬度, 经度]
bounds.ne array 是 东北角 [纬度, 经度]
size object 是 图像像素尺寸
size.width integer 是 宽度(像素)
size.height integer 是 高度(像素)
image string 是 data URI(透明背景 PNG Base64)

注意事项

  • GET;无需令牌。
  • 同一 IP 至少间隔 1 秒;超限返回 429。

日本雷达矢量图

主服务器:https://api.sismotide.top/get/radar-japan.json

备用服务器:https://api.jianproject.cloud/get/radar-japan.json

说明:获取日本附近最新雷达矢量图

示例数据

{
  "status": "success",
  "time": "2026-09-23 21:10:00",
  "bounds": {
    "sw": [16.64, 118.125],
    "ne": [48.92, 151.875]
  },
  "size": {
    "width": 1536,
    "height": 1792
  },
  "image": "data:image/png;base64,..."
}

字段说明

字段名类型必填说明
status string 是 成功时为 success
time string 是 有效时刻转北京时间(YYYY-MM-DD HH:mm:ss)
bounds object 是 图像覆盖范围的地理边界
bounds.sw array 是 西南角 [纬度, 经度]
bounds.ne array 是 东北角 [纬度, 经度]
size object 是 图像像素尺寸
size.width integer 是 宽度(像素)
size.height integer 是 高度(像素)
image string 是 data URI(透明背景 PNG Base64)

注意事项

  • GET;无需令牌。
  • 同一 IP 至少间隔 1 秒;超限返回 429。

全球热带气旋 GET API 字段说明文档

主服务器:https://api.sismotide.top/get/typhoon-global.json

备用服务器:https://api.jianproject.cloud/get/typhoon-global.json

说明:获取当前全球活跃热带气旋(不含西北太平洋 / 国内台风;国内请用 /get/typhoon.json)

示例数据

[
  {
    "id": "nhc-al062026",
    "name": "Fay",
    "name_en": "AL062026",
    "basin": "AL",
    "source": "NHC/CPHC",
    "latitude": 29.8,
    "longitude": -40.5,
    "moveDirection": "西",
    "moveSpeed": 13,
    "power": 8,
    "pressure": 1010,
    "windSpeed": 18,
    "type": "热带风暴",
    "updateTime": "2026-09-24 17:00:00",
    "points": []
  }
]

字段说明

字段名类型必填说明
id string 是 风暴编号(如 nhc-al062026 / al062026 / jtwc-io012026)
name string 否 名称
name_en string 否 英文名或 ATCF 码
basin string 否 洋区:AL / EP / CP / IO / SI / SP / SH 等(不含 WP)
source string 否 机构来源,如 NHC/CPHC、JTWC
latitude number 否 中心纬度
longitude number 否 中心经度
moveDirection string 否 移向
moveSpeed number 否 移速 km/h
power integer 否 中心附近最大风力等级(有则给出)
pressure integer 否 中心气压 hPa
windSpeed number 否 中心附近最大风速 m/s
type string 否 强度等级文案
radius7 number|string 否 七级风圈;四象限时为原样字符串
radius10 number|string 否 十级风圈;规则同 radius7
updateTime string 否 最新实况点时间(北京时间)
points array 否 完整实况路径点(有则保留;NHC 直拉补源可能无此字段)

注意事项

  • 响应为 JSON 数组;无活跃风暴时为 []。
  • 不含西北太平洋与国内台风;国内/西太请用 /get/typhoon.json。
  • GET;无需令牌;同一 IP 至少间隔 1 秒。

全球实时风场 GET API 字段说明文档

主服务器:https://api.sismotide.top/get/wind.json

备用服务器:https://api.jianproject.cloud/get/wind.json

说明:获取全球近地面风场

示例数据

{
  "status": "success",
  "time": "2026-09-22 15:00:00",
  "source": "gfs",
  "resolution_deg": 1,
  "level": "10m",
  "nx": 360,
  "ny": 181,
  "data": [
    {
      "header": {
        "parameterNumber": 2,
        "parameterNumberName": "U-component_of_wind",
        "nx": 360,
        "ny": 181,
        "lo1": 0,
        "la1": 90,
        "dx": 1,
        "dy": 1
      },
      "data": [-2.15, 0.3, "…"]
    },
    {
      "header": {
        "parameterNumber": 3,
        "parameterNumberName": "V-component_of_wind"
      },
      "data": [1.2, -0.5, "…"]
    }
  ]
}

字段说明

字段名类型必填说明
status string 是 成功时为 success
time string 是 风场有效时刻(北京时间)
source string 是 固定为 gfs
resolution_deg number 是 水平分辨率(度),当前为 1
level string 是 高度层,如 10m
nx integer 是 经向格点数
ny integer 是 纬向格点数
data array 是 长度 2:依次为 U、V 分量,形态兼容 leaflet-velocity / grib2json
data[].header object 是 格点头:nx/ny/lo1/la1/lo2/la2/dx/dy 等
data[].data array 是 按行主序展平的风速分量 m/s;缺测为 null

注意事项

  • GET;无需令牌。
  • 同一 IP 至少间隔 1 秒;超限返回 429。
  • 格点自北向南、自西向东(la1=90 → la2=-90,lo1=0 → lo2=359)。
  • 体积较大,请本地缓存,勿高频轮询。
  • data 数组可直接交给 leaflet-velocity 等粒子风场组件。