isabella232 / mapboxgl-powerbi

Mapbox Visual for Power BI - High performance, custom map visuals for Power BI dashboards

Mapbox Visual for Microsoft Power BI

Make sense of your big & dynamic location data with the Mapbox Visual for Power BI. Quickly design high-performance map visuals using graduated circles, clusters, and interactive heatmaps. Even customize your Mapbox visual with custom shapes, imagery, and design using Mapbox Studio. Check out the Mapbox Gallery to get a sense of what's possible with Studio.

Drop in the Mapbox Visual to your Power BI dashboard from the Microsoft Office Store.

Examples

• Example Dashboard - NYC Cycling Incidents
• Example Dashboard - 2017 USGS Earthquakes
• Example Dashboard - 2017 FCC Broadband Speeds in New Jersey

Documentation

• Check out the official Mapbox Visual for Power BI docs at:
  • Getting Started
  • Creating a Choropleth
• Check out 3rd party documentation below:
  • Sam Gehret's July 2017 Mapbox Visual for Power BI webinar
  • Devin Knight's Pragmatic Works March 2018 Mapbox Visual for Power BI video tutorial
  • David Eldersveld's BlueGranite Exploring Maps in Power BI webinar, March 2018

FAQ

Supported Power BI Environments and Tools

The Mapbox Visual for Power BI supports:

Mapbox Visual Version	PBI Report Server	PBI Mobile (iOS/Android)	PBI Embedded	PBI Publish to Web	PBI Desktop	Chrome	Firefox	Safari	Edge	IE11
v 1.2.4	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	No

Firewall rules - Domain names and ports to use with Power BI in a secure environment

The Mapbox Visual by default operates using API resources hosted on api.mapbox.com securely requested using HTTPS and your Mapbox access token. If you need all requests to be made inside of your corporate or air-gapped network, you can host Mapbox Atlas on your own server and run the Mapbox Visual for Power BI completely on-premise.

No data in the Power BI data model is ever sent to Mapbox APIs. Only the requested reference resources including map style sheets, vector tiles, icons, and fonts are retrieved from Mapbox APIs.

Domain	Port	Resource
api.mapbox.com	443	icons, map styles, fonts
*.tiles.mapbox.com	443	vector tiles

How many data points does the Mapbox Visual support?

Mapbox supports up to the maximum allowed by Power BI, 30,000 rows, for all visualization types including Choropleth (fill), cluster, heatmap, and circle. If your data is >30k rows, the Mapbox Visual will sample your data down to 30k rows and visualize the resultant sample. If you need to visualize more than 30k rows for your use case, reach out to our sales team to connect you with a Mapbox Partner to setup a custom solution for your use case.

Roadmap

• Current roadmap is managed by @samgehret.
• Check out the project board on this github for an up to date roadmap.
• v1.2 just released to the marketplace. It will be follwed by v1.3 later in Q3 2018.
• To request feature enhancements or to report bugs, please log an issue.
• Our release timeline will be discretionary based on new feature availability, but most likely every 2-3 months.

Beta Version

• We will keep an up to date beta version in this section.
• v1.3 beta is the lastest beta.

Developing and Contributing.

• This is an open source repo and we welcome contributions from the public.
• Please see contributing.md for more information.

Adding MapboxGL Viz to a Power BI Dashboard

On Power BI Online or Desktop, click add visual from marketplace and search Mapbox. Check out the visual on the Microsoft Office Store at https://appsource.microsoft.com/en-us/product/power-bi-visuals/WA104381472?tab=Overview.

What is Mapbox?

Mapbox is the location data platform for mobile and web applications. We provide building blocks to add location features like maps, search, and navigation into any experience you create. Use our simple and powerful APIs & SDKs and our open source libraries for interactivity and control.

Not a Mapbox user yet? Sign up for an account here. Once you’re signed in, all you need to start building with Power BI is a Mapbox access token.

Screenshots and GIFs