spatialdev/mapbox-gl-js

Name: mapbox-gl-js

Owner: SpatialDev

Description: JavaScript/WebGL vector maps library

Created: 2015-03-27 05:49:43.0

Updated: 2015-03-27 05:49:43.0

Pushed: 2015-03-26 23:01:40.0

Homepage: https://www.mapbox.com/mapbox-gl/

Size: 10595

Language: JavaScript

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

A WebGL JavaScript interactive maps library that can render Mapbox Vector Tiles.

Setup

To install dependencies and build the source files:

m install

To serve the debug page:

m start &
en http://localhost:3000/debug/?access_token=$MapboxAccessToken

This assumes you have the MapboxAccessToken environment variable set to a Mapbox API token from https://www.mapbox.com/account/apps/. It will watch the source files and automatically rebuild the browserify bundle whenever a change is detected.

Tests are written in tape. Most tests run within nodejs, but a few require a browser environment.

• npm test: local tests run in nodejs - excludes browser tests
• npm run cov: generate test coverage report - excludes browser tests
• npm run test-browser: run all tests locally in a browser

API Documentation

npm run docs: generate API docs

Style Reference

Recommended Reading

Learning WebGL

• Greggman's WebGL articles
• WebGL reference card

GL performance

• Debugging and Optimizing WebGL applications
• Graphics Pipeline Performance

Misc

• drawing antialiased lines
• drawing text with signed distance fields
• label placement
• distance fields