How-To Add a Choropleth Guide

Proposed copy for the Choropleth layer documentation cc/ @colleenmcginnis

Mapbox Visual for Power BI -Choropleth

1. Download and use the latest version of the Mapbox Visual PBIVIZ file (https://github.com/mapbox/mapboxgl-powerbi/raw/master/dist/mapboxGLMap.pbiviz)
2. Prepare the shapes you want to include in your visualization as a Choropleth layer. If you need Countries, US States, or US Postcodes - no need to do this work, those shapes are included in the visual!
3. Produce a Geojson or Shapefile of the boundaries you want to use. The boundaries should contain one uniquely-identifying property key that matches to your data. Common examples are a FIPS code, Postal Code, ISO code, or a unique name string.
4. If your shapes have a lot of detail (>10 mb of geojson is a good rule of thumb), simplify the boundaries before uploading to Mapbox using www.mapshaper.org. Export your simplified boundaries as geojson.
5. Upload your boundaries to Mapbox as a tileset
6. Once your tileset finishes processing, click on the tileset to get the details from it to use in your Power BI visual.
   1. Map ID (mapbox://rsbaumann.6ftg6wl3)
   2. Layername (losa_crime_joined)
   3. Property name (LSOA11CD)
      • 
7. Configure the data for your Choropleth layer a. Drag the field from your Power BI data source that matches the property values in your shapes to the Location field. Drag the metric you want to style the shapes by to the Color field. b. Turn off all layers except the Choropleth layer from the Format pannel * c. Select Custom from the Data dropdown in the Choropleth layer settings. Enter the map ID of your shapes into your Vector Tile URL (always include mapbox:// in front of your map ID), layername into the Vector Tile Layername field, and property into the Vector Property field. d. Your Tileset should show up in your Mapbox Visual container

Troubleshooting

1. When I put my vector tile URL, source layer, and vector property in, I dont see any shapes on my map.
2. Do the values in your Power BI Location data field match the data type (string vs. numeric) and exact data values in your vector tiles you uploaded to your Mapbox account?
3. Does your Vector Tile URL field begin with mapbox://? A correct tileset URL should look like mapbox://rsbaumann.my-tileset-id.
4. My layer does not show up but I’m sure all the settings are correct.
5. Try toggling the Choropleth layer on and off again in your visual.
6. Can I use a Choropleth layer with other Circle, Heatmap, or Cluster layers?
7. No. This feature is on our roadmap but not currently available.

[samgehret]

This is live. Thanks @HeyStenson!

https://www.mapbox.com/help/power-bi-choropleth-map/

[AndrewLockett]

Hi, thanks for that clarification. Reading the documentation I thought the master branch would contain all these enhancements. Any idea on the launch date of these upgrades to the App Store?

I also have some feedback on choropleth colours (both numeric and categorical) and tooltips format. Where should I record these comments / feature enhancements?

Thanks again. Andrew

On Wed, 27 Jun 2018, 21:58 Sam Gehret, [e-mail] wrote:

@AndrewLockett https://github.com/AndrewLockett Due to some restrictions on the Power BI side, you won’t be able to use the .pbviz from the master branch until it is released to the Power BI App Store. There is a unique ID built into the file which is the same as the one on the app store. When it loads into Power BI, it will function as the currently released one on the app store. Therefore, continue to use the beta version (from the drilldown branch).

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/mapbox/mapboxgl-powerbi/issues/142#issuecomment-400826924, or mute the thread https://github.com/notifications/unsubscribe-auth/AKA7-9iDBDO6p7w687epplAklWk6-hGdks5uA_IFgaJpZM4UCDdP .