Google Maps Chart
Introduction
The Google Maps chart allows to display information containing latitude/longitude data into a world map in different ways.
🚨 Important: This chart requires an API Key that must be provided by the user.
Read How to get a Google Maps API Key for Instadeq for more details.
⚠️ Make sure to restrict the API Key to the right domain and to share dashboards containing maps with the right permissions to avoid your API Key from being used by others without your permission.
Read more about it here: Google Maps Platform best practices: Restricting API keys
Required Fields
To enable the Google Maps option in the Chart card the chart query must contain at least two numeric values. The values will be used to auto configure the map chart in the following order: latitude first, longitude second.
A query configuration like the following is enough:
Chart latitude longitude value By key
Configuration
Per Row
Latitude lat
Field or formula to use as the latitude
Longitude lng
Field or formula to use as the longitude
Label text
Field or formula to use as text to be displayed on hover
Value Not Set
Field or formula to use as value, only used when Heatmap option is selected to specify the weight to add to the location. Default if Not Set is 1
Type Not Set
Field or formula to use as item type. Will be used in the future to select different marker icons when the Marker type is selected.
Global
General
- API Key
-
The Google Maps API Key. Read How to get a Google Maps API Key for Instadeq for more details.
- Config Ready
-
Check when the API Key is set, if the map fails to load uncheck, reload the page and try again.
- Map Type
-
Map images to use:
Roadmap: displays the default road map view.
Satellite: displays Google Earth satellite images.
Hybrid: displays a mixture of normal and satellite views.
Terrain: displays a physical map based on terrain information.
- Mark Type
Markers: Show a marker for each item.
Marker Clusters: Cluster markers in areas of high concentration.
Heatmap: Show sum of Value per area as a heatmap visualization.
Location
- Center on User's Location
-
If enabled as the user for permissions to use their current location to center the map there. If location not available or the user declines permissions the default Latitude/Longitude center will be used
- Sync Center
-
Enable to use the map to set Latitude/Longitude values, when finished disable again.
- Latitude
-
Latitude value for the initial center location, can be set manually or by enabling Sync Center and navigating in the map.
- Longitude
-
Longitude value for the initial center location, can be set manually or by enabling Sync Center and navigating in the map.
- Sync Zoom
-
Enable to use the map to set the Zoom level , when finished disable again.
- Zoom
-
Zoom level for the initial map location, can be set manually or by enabling Sync Zoom and zooming in the map.
Layers
- Show Traffic
-
Show traffic information in the map
- Show Transit
-
Show transit information in the map