Icon Map
Usage & Instructions
This section provides instructions and guidance on how to use the various features of Icon Map. The ambition is to include a video and downloadable example for each scenario.
GeoJSON
Contents
Field configuration
To relate items in your dataset to the shapes in a GeoJSON file, it is necessary to specify provide the 'Category' and 'Size' fields. The value in the 'Category' field should relate to one of the property values in your dataset. Eg:
{"type":"FeatureCollection", "features": [
{"type":"Feature","geometry":{"type":"Polygon","coordinates":[[[-0.0855554,51.519815], ... ,[-0.085555,51.5198157]]]},
"properties":{"LAD13CD":"E09000001","LAD13NM":"City of London"},"id":"E09000001"},
]}
Support is currently being added for the shape id field.
The value in the size field is used in relation with the Fill Color Start & End settings to generate a color gradient for each shape. Specific color values for each shape fill and outline can be provided by using the 'Circle / WKT / GeoJSON Fill Color' and 'Circle / WKT / GeoJSON Outline Color' field. #RRGGBB, #RRBBBBAA, rbg (r,g,b) and rgb(r,g,b,a) formats are supported.
If you have longitude and latitude fields specified due to have other types of map object, these must have null values to relate these rows to a GeoJSON shape.
GeoJSON Settings
To display a GeoJSON layer, set the switch to on to enable the GeoJSON settings.
Number of Levels
Icon Map supports up to 5 levels of drill-down to GeoJSON layers. Use this setting to set the number of GeoJSON layers to load. Each layer corresponds to a layer within the drilldown hierarchy. It is not possible to show more than one GeoJSON layer at the same time.
GeoJSON URL
This is the URL of the boundary data or shapes to display on the map. A box will appear for each of the number of levels selected above. It should be in GeoJSON format and include at least one code or description property against each shape that you can relate to the "Category" field in your data. IconMap scans each of the property fields against the data in the category field to look for matches.
Eg: https://iconmap.azurewebsites.net/mapresources/lad.json
If IconMap is unable to access the file, an error message will be displayed. Note: Some webservers will not allow the file to be accessed from another website, due to CORS. If you have control of the web server this can be resolved by adding the Access-Control-Allow-Origin: * response header.
Whilst the file is loading, an icon will be displayed in the top right hand corner of the map. Larger files will take longer to load. It is recommended to simplify your shapes to reduce the file size using a service such as MapShaper.
In order for the layer to appear in the Power BI Service, it must be served from an HTTPS address.
Include GeoJSON shapes in auto zoom
On: The map will include GeoJSON shapes when auto-zooming the map to available data items.
Off: The map will ignore GeoJSON shapes when auto-zooming the map. This is useful if you're using a GeoJSON layer as a background layer in conjunction with other map objects such as circles or images.
Zoom to selected shape
On: the map will zoom to the selected shape when you click on it.
Off: the map will not adjust the current zoom when you click on a shape.
Known issue: The map does not zoom to shapes selected using the lasso.
Show tooltips
Toggle whether to show tooltips for GeoJSON shapes.
Allow selecting GeoJSON shapes
Toggles whether GeoJSON shapes can be selected.
Known issue: Currently the lasso does not take account of this setting.
Line Color
Color of the shape outlines. If you have a field in the 'Circle / Line / WKT / GeoJSON Outline Color' fieldwell, then this setting is ignored, and will instead take the value from this field.
Line Width
With of the shape outlines
Line Opacity
Opacity of the shape outlines. 0 = completely transparent. 100 = completely opaque.
Opacity
Opacity of the shape fill. 0 = completely transparent. 100 = completely opaque.
Inactive Fill Color
Shape fill color when there is not corresponding data item in the category field. This may occur when you have more shapes than are referenced in your dataset, or if you filter the category field via a filter, slicer or selection on another visual in your report.
Fill Color - Start & Fill Color - End
The start and end colors to form the color gradient based on the value in the size field. If you have a field in the 'Circle / WKT / GeoJSON Fill Color' fieldwell, then this setting is ignored, and will instead take the value from this field.