/ember-cli-mapbox

Template driven Mapbox.js maps in Ember CLI.

Primary LanguageJavaScriptMIT LicenseMIT

Ember CLI mapbox Circle CI

Template driven Mapbox.js maps in Ember CLI.

Installation

ember install ember-cli-mapbox

Add your access token to config/environment.js:

mapbox: {
  accessToken: 'yourAccessToken',
},

Components

mapbox-map

The addon includes a component for constructing a mapbox map:

{{mapbox-map mapId='ember-cli-mapbox.7c3914f2' divId='mega-map'}}

Which will generate a <div id="mega-map">, and initialise the map with the corresponding mapId form mapbox.

If divId is not specified it defaults to 'map'.

You can specify the zoom level, center of the map, and trigger an onclick event as attributes. The onclick event will return an instance of the event containing the lat,lng, among other properties.

{{mapbox-map
  mapId=model.sfMapId
  center=(mapbox-coords 37.768 -122.381)
  onclick="actionName"
  zoom=13}}

mapbox-marker

When used as a block mapbox-map will yield an instance of the map. You can use this to add markers to the map through the mapbox-marker component in your templates:

{{#mapbox-map mapId='ember-cli-mapbox.7c3914f2' as |map|}}
  {{#each positions as |position|}}
    {{mapbox-marker map=map coordinates=position.coordinates}}
  {{/each}}
{{/mapbox-map}}

You can also specify the size, color and symbol of the marker with those attributes and trigger an onclick, an onpopupopen and an onpopupclose event.

Popup titles can be set with popup-title and can be opened by setting the is-open property to true.

To make the marker recenter the map when it is added, you can sepecify recenter as a property oft he marker:

{{mapbox-marker map=map coordinates=position.coordinates recenter=true}}

mapbox-markercluster

You can cluster markers into a markercluster group by yielding a mapbox-markercluster and nesting mapbox-markers inside:

{{#mapbox-map mapId='ember-cli-mapbox.7c3914f2' as |map|}}
  {{#mapbox-markercluster map=map as |cluster|}}
    {{#each positions as |position|}}
      {{mapbox-marker map=map cluster=cluster coordinates=position.coordinates}}
    {{/each}}
  {{/mapbox-markercluster}}
{{/mapbox-map}}

Nested mapbox-markers carry all of the same properties/attributes as regular markers.

mapbox-geojson

Similar to mapbox-marker, you can use mapbox-geojson to add arbitrary polygons and points to your map:

{{#mapbox-map mapId='ember-cli-mapbox.7c3914f2' as |map|}}
  {{#each areas as |area|}}
    {{mapbox-geojson map=map json=area.geometry}}
  {{/each}}
{{/mapbox-map}}

You can specify and trigger an onclick event.

Popup titles can be set with popup-title and can be manually opened by setting the is-open property to true.

Helpers

mapbox-coords

A helper for setting up a coordinate pair from a latitude and a longitude e.g.

{{mapbox-map
  mapId=model.sfMapId
  center=(mapbox-coords 37.768 -122.381)
  zoom=13
  as |map|}}

or

{{mapbox-marker map=map coordinates=(mapbox-coords 23.333, 45.422)}}

Collaborating

If you want to collaborate on this Ember addon:

Installation

  • git clone this repository
  • npm install
  • bower install

Running

The dummy app has some basic mapbox usage.

Running Tests

  • npm test (Runs ember try:testall to test your addon against multiple Ember versions)
  • ember test
  • ember test --server

Building

  • ember build

For more information on using ember-cli, visit http://www.ember-cli.com/.