Friends Data API独立数据服务

DECISION MODEL DATA · 气象、环境与灾害

JMA

日本天气警报、台风最佳路径及地震火山公告。

API 调用说明

能回答的问题

  • 日本已收录地区有哪些天气警报?
  • 历史台风路径及已收录地震火山公告是什么?

状态与已知缺口

部分可用

已收录多类资料,但产品、字段及历史覆盖仍不完整;请按各产品的范围和已知缺口使用。

  • 当前警报与历史最佳路径并非完整警报版本历史。
  • 指定城市日观测暂不作为通用逐行数据提供。

提供方

PRODUCT

台风历史最佳路径

jma_best_tracks

每个台风轨迹观测点一行,保留原始定长记录、字段数组与台风头记录;按官方最佳路径格式解释时间、位置和强度。

粒度
每个台风与轨迹观测时刻一行
时间范围
1951-02-19 ~ 2026-06-28 · record_tokens 中原始年月日时
采集时间
2026-10-06T04:34:53.260710Z ~ 2026-10-06T04:34:53.260710Z
记录数
71,421

API 调用示例

使用现有 Friends API Key;分页时将响应的 next_cursor 作为 cursor 继续读取。

HTTP · GET
/api/v1/data/datasets/decision_model/records/rows?product=jma_best_tracks&limit=100

字段表 · 5 个字段

字段名中文说明
record_line原始定长轨迹记录行
record_tokens原始轨迹字段数组
storm_header原始台风头记录
storm_header_tokens台风头记录字段数组
storm_id气旋标识

PRODUCT

地区天气警报快照

jma_warnings

每个地区气象台的一份警报对象一行,包含发布部门、发布时间、区域警报及预报时序;区域警报位于嵌套数组。

粒度
每个地区气象台警报对象一行
时间范围
2026-05-21T17:57:00+09:00 ~ 2026-05-28T11:31:00+09:00 · reportDatetime(警报发布时间)
采集时间
2026-10-06T04:38:10.472117Z ~ 2026-10-06T04:39:13.176930Z
记录数
58

API 调用示例

使用现有 Friends API Key;分页时将响应的 next_cursor 作为 cursor 继续读取。

HTTP · GET
/api/v1/data/datasets/decision_model/records/rows?product=jma_warnings&limit=100

字段表 · 6 个字段

字段名中文说明
areaTypes按区域层级组织的警报数组
headlineText公告标题或重点文字
notice提供方原生字段;含义暂未补充。
publishingOffice发布气象台
reportDatetime公告发布时间
timeSeries按时刻组织的预报或警报时序

PRODUCT

地震火山原始公告

jma_xml_bulletins

每份已收录地震或火山 XML 公告一行,以节点树保留标题、发布部门、时间及正文结构。

粒度
每份公告一行
时间范围
2026-10-01T21:32:00+09:00 ~ 2026-10-06T20:00:00+09:00 · XML 公告中 DateTime/ReportDateTime 等原始时间
采集时间
2026-10-06T12:03:21.166606Z ~ 2026-10-06T12:09:58.141719Z
记录数
3,612

API 调用示例

使用现有 Friends API Key;分页时将响应的 next_cursor 作为 cursor 继续读取。

HTTP · GET
/api/v1/data/datasets/decision_model/records/rows?product=jma_xml_bulletins&limit=100

字段表 · 7 个字段

字段名中文说明
attributesXML 节点的原始属性
childrenXML 子节点数组;标题、标识、日期和正文等位于其中
tagXML 节点名(可含命名空间)
tailXML 节点后的原始文本
text节点文字或可提取的文档正文
xml_node提供方原生字段;含义暂未补充。
xml_pointer提供方原生字段;含义暂未补充。

PRODUCT

地震火山公告索引

jma_xml_feed

每个公告索引条目一行,保留 Atom XML 节点树,含标题、公告链接及更新时间;索引条目不等于公告正文。

粒度
每个公告索引条目一行
时间范围
2026-09-29T13:51:33Z ~ 2026-10-06T11:00:00Z · XML 子节点中的 updated
采集时间
2026-10-06T12:03:18.557122Z ~ 2026-10-06T12:03:18.557122Z
记录数
494

API 调用示例

使用现有 Friends API Key;分页时将响应的 next_cursor 作为 cursor 继续读取。

HTTP · GET
/api/v1/data/datasets/decision_model/records/rows?product=jma_xml_feed&limit=100

字段表 · 5 个字段

字段名中文说明
attributesXML 节点的原始属性
childrenXML 子节点数组;标题、标识、日期和正文等位于其中
tagXML 节点名(可含命名空间)
tailXML 节点后的原始文本
text节点文字或可提取的文档正文

数据观测时间 2026-10-06T17:38:47.854586Z