Friends Data API独立数据服务

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

USGS (earthquake/ComCat/VHP)

地震事件目录、火山状态和火山通告。

API 调用说明

能回答的问题

  • 某地区发生过哪些地震、震级和深度是多少?
  • 已监测火山的警戒等级及通告内容是什么?

状态与已知缺口

部分可用

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

  • 地震目录包含后续更新,不等于事件首次公布时的版本。
  • 火山名录和指定通告不代表全部历史火山公告。

提供方

PRODUCT

地震事件目录

usgs_earthquakes

每个地震事件的一条 GeoJSON 记录,properties 含发生时间、震级等,geometry 含经纬度与深度;不同快照可包含同一事件的后续更新。

粒度
每个地震事件在快照中一行
时间范围
1900-01-05 ~ 2026-10-05 · properties.time(事件发生时间);updated 为修订时间
采集时间
2026-10-04T07:55:15.386669Z ~ 2026-10-05T10:19:25.463911Z
记录数
8,856

API 调用示例

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

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

字段表 · 数量未提供

字段信息暂不可用;待确认后补充。

字段名中文说明
暂无字段说明。

PRODUCT

火山通告章节

usgs_volcano_notice

每个已收录火山通告的章节一行,保留章节标识、顺序及正文,用于读取原文的活动描述和警戒信息。

粒度
每个通告章节一行
时间范围
2026-10-03 ~ 2026-10-03 · 指定通告的发布时间;章节正文内时间另看
采集时间
2026-10-04T07:56:02.714938Z ~ 2026-10-04T07:56:02.714938Z
记录数
1

API 调用示例

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

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

字段表 · 31 个字段

字段名中文说明
alert_level火山警戒等级
color_code警报颜色代码
hazards通告中的灾害风险说明
last_update提供方通告最近更新时间
next_notice下次通告信息,可能为空
notice_identifier通告标识
notice_number提供方通告编号
observations通告中的观测内容
remarks通告补充说明,可能包含 HTML
section_identifier通告章节标识
section_order通告章节顺序
send_vona_only_ind提供方原生字段;含义暂未补充。
summary提供方原生字段;含义暂未补充。
synopsis通告活动概要,可能包含 HTML
synopsis_complete提供方概要完整状态
volcano_cd火山代码
vona_activity_status提供方原生字段;含义暂未补充。
vona_cloudheight_ft提供方原生字段;含义暂未补充。
vona_cloudheight_option提供方原生字段;含义暂未补充。
vona_contacts提供方原生字段;含义暂未补充。
vona_duration_option提供方原生字段;含义暂未补充。
vona_duration_value提供方原生字段;含义暂未补充。
vona_event_number提供方原生字段;含义暂未补充。
vona_height_source_option提供方原生字段;含义暂未补充。
vona_last_emission_time提供方原生字段;含义暂未补充。
vona_movement提供方原生字段;含义暂未补充。
vona_next_notice_option提供方原生字段;含义暂未补充。
vona_next_notice_time提供方原生字段;含义暂未补充。
vona_onset_option提供方原生字段;含义暂未补充。
vona_onset_time提供方原生字段;含义暂未补充。
vona_remarks提供方原生字段;含义暂未补充。

PRODUCT

监测火山与警戒状态

usgs_volcano_status

每个监测火山一行,包含火山名称、观测站、警戒等级、航空颜色代码和最近通告信息。

粒度
每个监测火山一行
时间范围
2009-11-18 ~ 2026-10-06 · sent_utc(最近通告时间);快照时间另列
采集时间
2026-10-04T07:55:16.820337Z ~ 2026-10-06T09:03:04.204334Z
记录数
276

API 调用示例

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

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

字段表 · 13 个字段

字段名中文说明
alert_level火山警戒等级
color_code警报颜色代码
notice_data提供方原生字段;含义暂未补充。
notice_identifier通告标识
notice_type_cd提供方原生字段;含义暂未补充。
notice_url公开通告链接
obs_abbr观测站简称
obs_fullname观测站名称
sent_unixtime提供方原生字段;含义暂未补充。
sent_utc最近通告的 UTC 时间
vnum火山编号
volcano_cd火山代码
volcano_name火山名称

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