Map Card


A card that allows you to display entities on a map.

Screenshot of the map card Screenshot of the map card.

Configuration Variables

type

(string)(Required)

map

entities

(list)(Required)

List of entity IDs. Either this or the geo_location_sources configuration option is required.

geo_location_sources

(list)(Required)

List of geolocation sources. All current entities with that source will be displayed on the map. See Geolocation platform for valid sources. Set to all to use all available sources. Either this or the entities configuration option is required.

title

(string)(Optional)

The card title.

aspect_ratio

(string)(Optional)

Forces the height of the image to be a ratio of the width. You may enter a value such as: 16x9, 16:9, 1.78.

default_zoom

(integer)(Optional)

The default zoom level of the map.

Default value:

14 (or whatever zoom level is required to fit all visible markers)

dark_mode

(boolean)(Optional)

Enable a dark theme for the map.

Default value:

false

Only entities that have latitude and longitude attributes will be displayed on the map.

The default_zoom value will be ignored if it is set higher than the current zoom level after fitting all visible entity markers in the map window. In other words, this can only be used to zoom the map out by default.

Examples

type: map
aspect_ratio: 16:9
default_zoom: 8
entities:
  - device_tracker.demo_paulus
  - zone.home
type: map
geo_location_sources:
  - nsw_rural_fire_service_feed
entities:
  - zone.home