2.0 KiB
layout, title, sidebar_label, description, date, sidebar, comments, sharing, footer
| layout | title | sidebar_label | description | date | sidebar | comments | sharing | footer |
|---|---|---|---|---|---|---|---|---|
| page | Map Card | Map | A card that allows you to display entities on a map | 2018-07-08 10:28 +00:00 | true | false | true | true |
A card that allows you to display entities on a map.
Screenshot of the map card.
{% configuration %}
type:
required: true
description: map
type: string
entities:
required: true
description: List of entity IDs. Either this or the geo_location_sources configuration option is required.
type: list
geo_location_sources:
required: true
description: 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.
type: list
title:
required: false
description: The card title.
type: string
aspect_ratio:
required: false
description: "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."
type: string
default_zoom:
required: false
description: The default zoom level of the map.
type: integer
default: 14 (or whatever zoom level is required to fit all visible markers)
{% endconfiguration %}
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.
{% linkable_title 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