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:

Run latest to get details.
Run shakemap to get the MMI shakemap image URL.
Use references/seismology.md to explain magnitude, depth classification, MMI intensity, and fault type.
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.