A custom Lovelace card that displays Australian emergency incidents on an interactive map with polygon boundaries, animations, and the Australian Warning System color scheme.
Getting Started | Configuration | Features | Troubleshooting
Card showing various configurations: All Incidents, Watch & Act filtering, Bushfires only, Incidents Affecting Home, Emergency Warnings, and Zones overlay
Home Assistant's native map card only supports point markers. Emergency incidents often have polygon boundaries (fire perimeters, flood zones, storm cells) that are critical for situational awareness.
This card uses Leaflet.js to render those polygons while maintaining full compatibility with standard Home Assistant map card features.
| Feature | Native HA Map | ABC Emergency Map Card |
|---|---|---|
| Point markers | Yes | Yes |
| Entity tracking | Yes | Yes |
| Zone display | Yes | Yes |
| History trails | Yes | Yes |
| Polygon boundaries | No | Yes |
| Alert level colors | No | Yes |
| Incident animations | No | Yes |
| Severity-based layering | No | Yes |
- Polygon Rendering - Incident boundaries displayed as actual polygons, not just points
- Australian Warning System Colors - Severity-based coloring (Emergency Warning, Watch and Act, Advice, Information)
- Severity Layering - Higher severity incidents render on top for visibility
- Smooth Transitions - Morphing polygon boundaries when incidents update
- Pulse Effects - New incidents glow/pulse to draw attention
- Update Animations - Visual feedback when incident data changes
- Badge Notifications - Incident count with severity indicator
- Entity Markers - Display person, device_tracker, and geo_location entities
- Zone Rendering - Show Home Assistant zones as circles
- History Trails - Display entity movement history
- Theme Support - Auto-detects HA theme (light/dark)
- WCAG 2.1 AA Compliant - Keyboard navigation, screen reader support
- Responsive Design - Works on mobile, tablet, and desktop
- Visual Editor - Full configuration UI in Lovelace
- Reduced Motion - Respects user preferences
-
Home Assistant 2024.1+
-
ABC Emergency Integration - Required for incident data
Click the button below to add this card to HACS:
Or manually:
- Open HACS in Home Assistant
- Go to Frontend > Custom repositories
- Add
https://github.com/troykelly/lovelace-abc-emergency-mapas type Lovelace - Install ABC Emergency Map Card
- Refresh your browser (Ctrl+F5)
type: custom:abc-emergency-map-card
title: Emergency Map
geo_location_sources:
- sensor.abc_emergency_YOUR_INSTANCE_incidents_totalReplace YOUR_INSTANCE with your ABC Emergency integration instance name (e.g., auremer, treehouse).
Important: You must configure
geo_location_sourcesto specify which ABC Emergency sensor provides the incident data. Without this, no incidents will be displayed.
Click to expand manual installation steps
- Download
abc-emergency-map-card.jsfrom the latest release - Copy to
config/www/community/abc-emergency-map-card/ - Add the resource to your Lovelace configuration:
resources:
- url: /local/community/abc-emergency-map-card/abc-emergency-map-card.js
type: module| Option | Type | Default | Description |
|---|---|---|---|
title |
string | - | Card title |
entities |
string[] | - | Entities to display (person, device_tracker) |
default_zoom |
number | 10 | Initial zoom level (1-20) |
hours_to_show |
number | 24 | Hours of history to display |
dark_mode |
string | auto | Theme mode: auto, light, dark |
| Option | Type | Default | Description |
|---|---|---|---|
show_zones |
boolean | true | Show Home Assistant zones |
show_warning_levels |
boolean | true | Show ABC Emergency polygons |
show_history |
boolean | false | Show entity movement trails |
show_badge |
boolean | true | Show incident count badge |
auto_fit |
boolean | true | Auto-zoom to show all entities |
Use geo_location_sources to dynamically discover incidents from ABC Emergency sensors:
type: custom:abc-emergency-map-card
title: Watch & Act Incidents
geo_location_sources:
- sensor.abc_emergency_auremer_watch_and_actsSee the full configuration reference for all 40+ options.
This card uses the official Australian Warning System color scheme:
| Level | Color | Meaning |
|---|---|---|
| Emergency Warning | Red (#cc0000) | You are in immediate danger and need to take action now |
| Watch and Act | Orange (#ff6600) | Conditions are changing - prepare to take action |
| Advice | Yellow (#ffcc00) | An incident is occurring - stay informed |
| Information | Blue (#3366cc) | General information about an event |
For more details, see Australian Warning System reference.
When the map is focused:
| Key | Action |
|---|---|
| Arrow keys | Pan the map |
+ / - |
Zoom in/out |
Home |
Reset view to fit all content |
This card includes experimental support for Google Cast devices (Chromecast, Nest Hub). If you experience issues when casting:
- The card will automatically try fallback CDNs if the primary fails
- Cast-specific error messages will help diagnose issues
- For maximum compatibility, consider using the built-in Home Assistant
mapcard for Cast dashboards
See Troubleshooting for Cast-specific solutions.
- Getting Started Guide - First-time setup
- Configuration Reference - All configuration options
- Features Documentation - Detailed feature explanations
- Troubleshooting - Common issues and solutions
- Generic GeoJSON Guide - Using with non-ABC sources
- Example Configurations - Copy-paste examples
pnpm install # Install dependencies
pnpm run dev # Build with watch
pnpm run build # Production build
pnpm run lint # ESLint
pnpm run typecheck # TypeScript checkSee CONTRIBUTING.md for contribution guidelines.
This card is for informational purposes only.
Always follow official emergency services advice. Do not rely solely on this card for emergency decisions. If you are in danger, call 000 (Australia) immediately.
For official emergency information, visit ABC Emergency or your state emergency services.
- ABC Emergency Integration - The backend integration that provides incident data
Apache License 2.0 - see LICENSE for details.
Made with care for the Australian Home Assistant community
This project is not affiliated with or endorsed by the Australian Broadcasting Corporation (ABC) or any emergency services agency.