FOREWORD: this repo was copied from https://github.com/mapbox/mapboxgl-powerbi

---

How To

Setup dev environment

• warning: YMMV, a bit of a trial and error atm, we have some version dependancies nightmare going on
• quirks:
  • looking at package.json, we need to compile some codes in nodejs v1.5.0, e.g.
    
    • src/build/turf.js, see package.json -> turf-build (run this with npm run turf-build)
    • browserify also needs to be installed via node v1.5.0 somehow
  • but from information gathered, we need pbiviz 2.6.0 that runs on nodejs v6.0.0, weird
    so we need to run the pbiviz package in pbiviz 2.6.0
• to start, best to install nvm (node version manager, so we can switch between node versions):
  brew update && brew install nvm
• install node and packages:
  
  • node v1.5.0 (iojs-v1.5.0)
    • installs node v1.5.0 - nvm install iojs-v1.5.0
      
    • switch to v1.5.0 - nvm use v1.5.0
      
    • installs browserify (doesnt work with node v6.0.0) - npm install -g browserify
      
  • node v6.0.0
    • installs node v6.0.0 - nvm install v6.0.0
      
    • switch to v6.0.0 - nvm use v6.0.0,
      
    • to complete the local package installs - npm install
    • install pbiviz 2.6.0 - npm i -g powerbi-visuals-tools@2.6.0
• now we should be set, for dev and package follow the steps:
  • from my understanding, any js code change that needs recompile, will need to be compiled with nodejs v1.5.0
  • also some hacky steps, please see Hacky stuff to make things work
  • then anything to with powerbi e.g. packaging will need to be run on nodejs v6.0.0
• you can explore the various commands available in package.json -> scripts
  to run them would be npm run xxx, e.g npm run turf-build
  
  

Original README.md from source repo

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