AirMap SDK
Introduction
AirMap's JavaScript Maps SDK makes it easy to build beautiful airspace maps on the web. At its core, the SDK is a wrapper for Mapbox GL JS and the AirMap Vector Tile Server.
Requirements
To use the Maps SDK, you must register as a developer and obtain an API key from the AirMap Developer Portal. Once your application has been created, simply copy the provided config JSON to provide to the SDK. You'll also need to register for a Mapbox Access Token.
Installation
From AirMap's CDN
<!-- Latest patch release --> <!-- Latest minor release -->
bower
Frombower install airmap-map-sdk
npm
Fromnpm install airmap-map-sdk
After installing the
airmap-map-sdk
module via npm or bower, you'll need bundle it up along with its dependencies using a tool like webpack or browserify. If you don't have a build process in place for managing dependencies, it is recommended that you use the module via the CDN. See below for instructions on using with webpack and browserify. If you install with bower and intend to support ES5, you will also need to run your bundle through babel.
Usage
Here's an example of a minimal setup. See Documentation for more details.
<!-- map is loaded here -->
Or if using from NPM:
var AirmapSDK = ; var config = /* your config json generated from AirMap's Developer Portal */;var map = config container: 'airspaceMap' center: 339416 -1184085 layers: 'airports_recreational' 'national_parks' 'tfrs' 'wildfires' /* refer to the docs for a comprehensive list of options */;
webpack
WithIf you are using webpack to bundle your application, you'll need to install the transform loader and add the following to your webpack config:
test: /node_modules[\\\/]airmap-map-sdk[\\\/].*\.js$/ loader: 'transform/cacheable?brfs'
browserify
WithIf you are using browserify to bundle your application, you'll need to install and use the brfs transform:
$ browserify -t brfs example/main.js > bundle.js
Prebuilt
If you are installing the SDK with npm, a prebuilt package is also available in dist/airmap.map.min.js
. This will
allow you to use the SDK without changing your webpack/browserify configuration. However, using your bundler to package
all dependencies is the preferred approach (webpack recommends against using prebuilt files).
Documentation
Development
Clone the repo and run npm install
. Then run npm start
and navigate to
http://localhost:8080/examples/index.html in your browser. The server will
listen for changes and live reload as updates are made.
If this is your first time developing with the SDK, you'll need to store an AirMap API Key and Mapbox Access Token
in your localStorage for use on the examples/index.html
demo page:
localStorage;localStorage;
Once this is done, you won't need to do it again unless you clear your browser's localStorage.
License
See LICENSE for details.