bmkg-monitor

BMKG Monitor

Monitor and analyze seismic activity, weather, and natural hazard warnings in Indonesia using real-time data from BMKG (Badan Meteorologi, Klimatologi, dan Geofisika).

Quick Start

# Earthquake
python3 scripts/get_data.py latest              # Latest significant earthquake
python3 scripts/get_data.py felt                 # Earthquakes felt by people
python3 scripts/get_data.py recent               # Recent M5.0+ earthquakes
python3 scripts/get_data.py detail <EVENT_ID>    # Moment tensor & phase data
python3 scripts/get_data.py shakemap             # Shakemap image URL
python3 scripts/get_data.py tsunami              # Filter for tsunami potential

# Weather
python3 scripts/get_data.py weather <ADM4_CODE>  # 3-day forecast for location
python3 scripts/get_data.py warnings             # Active severe weather warnings

# Options
python3 scripts/get_data.py felt --json          # Raw JSON output (any command)
python3 scripts/get_data.py help                 # List all commands

ADM4 Codes (Weather)

Weather forecasts use kelurahan/desa administrative codes (format: XX.XX.XX.XXXX). Examples:

• 31.71.03.1001 — Kemayoran, Jakarta Pusat
• 35.07.01.1001 — Surabaya area
• Find codes via Kepmendagri No. 100.1.1-6117/2022.

Workflows

1. "Was there a quake?"

Run felt first — includes smaller, shallow quakes that people actually feel. If they want the big one, run latest.

2. Significant Earthquake Analysis

When a major quake occurs:

1. Run latest to get details.
2. Run shakemap to get the MMI shakemap image URL.
3. Use references/seismology.md to explain magnitude, depth classification, MMI intensity, and fault type.
4. Run tsunami to check if any events have tsunami potential.

3. Weather Check

For weather questions, use weather <adm4_code>. Shows next 3 forecast periods with temperature, humidity, condition, wind, and visibility.

4. Active Weather Warnings

Run warnings to see current nowcast alerts — severe rain, thunderstorms, strong winds across Indonesian provinces. Refer to the "Weather Warning Severity" section in references/seismology.md for urgency/severity/certainty meanings.

5. Moment Tensor / Beach Ball Analysis

If a detailed BMKG report includes a moment tensor diagram, refer to the "Moment Tensor" section in references/seismology.md to identify Strike-Slip, Normal, or Thrust faulting.

Data Sources

Data	Source	Format
Earthquake (latest, recent, felt)	data.bmkg.go.id/DataMKG/TEWS/	JSON
Shakemap images	data.bmkg.go.id/DataMKG/TEWS/<id>.mmi.jpg	JPG
Weather forecast	api.bmkg.go.id/publik/prakiraan-cuaca	JSON
Weather warnings	bmkg.go.id/alerts/nowcast/id	RSS/XML
Moment tensor & phase	static.bmkg.go.id/	TXT

References

• seismology.md — Magnitude, MMI scale, depth, tsunami warnings, fault types, Indonesia tectonics, weather severity levels.