/* Copyright (c) 2011 by MapQuery Contributors (see AUTHORS for
* full list of contributors). Published under the MIT license.
* See https://github.com/mapquery/mapquery/blob/master/LICENSE for the
* full text of the license. */
(function ($) {
/**
# jquery.mapquery.core.js
The main MapQuery file. It contains the MapQuery constructor, the MapQuery.Map
constructor and the MapQuery.Layer constructor.
### *$('selector')*.`mapQuery([options])`
_version added 0.1_
####**Description**: initialise MapQuery and associate it with
the matched element
**options** an object of key-value pairs with options for the map. Possible
pairs are:
* **layers** (array of MapQuery.Layer *or* MapQuery.Layer): Either an array
or a single layer that should be added to the map
* **center** ({position: [x,y], zoom: z(int), box: [llx,lly,urx,ury]}):
Initially go to a certain location. At least one layer (in the `layers`
option) needs to be specified.
> Returns: $('selector') (jQuery object)
We can initialise MapQuery without any options, or for instance pass in a layer
object. The mapQuery function returns a jQuery object, to access the mapQuery object retrieve
the 'mapQuery' data object.
var map = $('#map').mapQuery(); //create an empty map
var map = $('#map').mapQuery({layers:[{type:'osm'}]); //create a map with osm
var mq = map.data('mapQuery'); //get the MapQuery object
*/
$.MapQuery = $.MapQuery || {};
/**
---
#MapQuery.Map
The MapQuery.Map object. It is automatically constructed from the options
given in the `mapQuery([options])` constructor. The Map object is refered
to as _map_ in the documentation.
*/
$.MapQuery.Map = function(element, options) {
var self = this;
//If there are a maxExtent and a projection other than Spherical Mercator
//automagically set maxResolution if it is not set
//TODO smo 20110614: put maxExtent and maxResolution setting in the
//proper option building routine
if(options){
if(!options.maxResolution&&options.maxExtent&&options.projection){
options.maxResolution = (options.maxExtent[2]-options.maxExtent[0])/256;
}}
this.options = $.extend({}, new $.fn.mapQuery.defaults.map(), options);
this.element = element;
// TODO vmx 20110609: do proper options building
// TODO SMO 20110616: make sure that all projection strings are uppercase
// smo 20110620: you need the exact map options in the overviewmap widget
// as such we need to preserve them
this.olMapOptions = $.extend({}, this.options);
delete this.olMapOptions.layers;
delete this.olMapOptions.maxExtent;
delete this.olMapOptions.zoomToMaxExtent;
delete this.olMapOptions.center;
//TODO SMO20110630 the maxExtent is in mapprojection, decide whether or
//not we need to change it to displayProjection
this.maxExtent = this.options.maxExtent;
this.olMapOptions.maxExtent = new OpenLayers.Bounds(
this.maxExtent[0],this.maxExtent[1],this.maxExtent[2],this.maxExtent[3]);
this.projection = this.options.projection;
this.displayProjection = this.options.displayProjection;
OpenLayers.IMAGE_RELOAD_ATTEMPTS = 3;
OpenLayers.Util.onImageLoadErrorColor = "transparent";
// create the OpenLayers Map
this.olMap = new OpenLayers.Map(this.element[0], this.olMapOptions);
//OpenLayers doesn't want to return a maxExtent when there is no baselayer
//set (eg on an empty map, so we create a fake baselayer
this.olMap.addLayer(new OpenLayers.Layer('fake', {baseLayer: true}));
// Keep IDs of vector layer for select feature control
this.vectorLayers = [];
this.selectFeatureControl = null;
// Counts up to create unique IDs
this.idCounter = 0;
element.data('mapQuery', this);
this.layersList = {};
// To bind and trigger jQuery events
this.events = $({});
this.handlers = {
// Triggers the jQuery events, after the OpenLayers events
// happened without any further processing
simple: function(data) {
this.trigger(data.type);
}
};
// MapQuery doesn't bind all OpenLayers events automatically,
// but just the ones that make sense.
// Events that are left out intensionally are:
// - changebaselayer: MapQuery doesn't have the concept of base layers
// - mouseover, mouseout, mousemove: Handle those with jQuery on the
// DOM level
// Some events can be triggered by MapQuery without listening to the
// OpenLayers events. This only works for events that are triggered
// by functionality that MapQuery implements in some custom way, e.g.
// (pre)addlayer, (pre)removelayer, changelayer.
// TODO vmx 20120309: Proper docs for the events, here's some quickly
// written info:
// - generally spoken, the map events follow the OpeLayer events
// - preaddlayer, movestart, move, moveend, zoomend: no additional
// argument
// - addlayer, preremovelayer, removelayer: layer as additional argument
// - changelayer: layer and the property that changed as additional
// argument. Possible values for the property are: position (in
// the layer stack), opacity, visibility
// Currently this event is always fired, even if the property
// was only meant to be changed, but wasn't exctually changed.
// I.e. that the event is fired even if you call
// `layer.visible(true)` although the layer is already visible.
// I'm (vmx) not sure if we want to change that :)
this.olMap.events.on({
scope: this,
movestart: this.handlers.simple,
move: this.handlers.simple,
moveend: this.handlers.simple,
zoomend: this.handlers.simple
});
// Add layers to the map
if (this.options.layers!==undefined) {
this.layers(this.options.layers);
// You can only go to some location if there were layers added
if (this.options.center!==undefined) {
this.center(this.options.center);
}
}
// zoom to the maxExtent of the map if no precise location was specified
if (this.options.zoomToMaxExtent && this.options.center===undefined) {
this.olMap.zoomToMaxExtent();
}
};
$.MapQuery.Map.prototype = {
/**
###*map*.`layers([options])`
_version added 0.1_
####**Description**: get/set the layers of the map
**options** an object of key-value pairs with options to create one or
more layers
>Returns: [layer] (array of MapQuery.Layer) _or_ false
The `.layers()` method allows us to attach layers to a mapQuery object. It takes
an options object with layer options. To add multiple layers, create an array of
layer options objects. If an options object is given, it will return the
resulting layer(s). We can also use it to retrieve all layers currently attached
to the map.
When adding layers, those are returned. If the creation is cancled by returning
`false` in the `preaddlayer` event, this function returns `false` to
intentionally break the chain instead of hiding errors subtly).
var osm = map.layers({type:'osm'}); //add an osm layer to the map
var layers = map.layers(); //get all layers of the map
*/
layers: function(options) {
//var o = $.extend({}, options);
var self = this;
switch(arguments.length) {
case 0:
return this._allLayers();
case 1:
if (!$.isArray(options)) {
return this._addLayer(options);
}
else {
return $.map(options, function(layer) {
return self._addLayer(layer);
}).reverse();
}
break;
default:
throw('wrong argument number');
}
},
// Returns all layers as an array, sorted by there order in the map. First
// element in the array is the topmost layer
_allLayers: function() {
var layers = [];
$.each(this.layersList, function(id, layer) {
var item = [layer.position(), layer];
layers.push(item);
});
var sorted = layers.sort( function compare(a, b) {
return a[0] - b[0];
});
var result = $.map(sorted, function(item) {
return item[1];
});
return result.reverse();
},
_addLayer: function(options) {
var id = this._createId();
var layer = new $.MapQuery.Layer(this, id, options);
// NOTE vmx 20120305: Not sure if this is a good idea, or if it would
// be better to include `options` with the preaddlayer event
if (this._triggerReturn('preaddlayer', [layer])===false) {
return false;
}
this.olMap.addLayer(layer.olLayer);
this.layersList[id] = layer;
if (layer.isVector) {
this.vectorLayers.push(id);
}
this._updateSelectFeatureControl(this.vectorLayers);
layer.trigger('addlayer');
return layer;
},
// Creates a new unique ID for a layer
_createId: function() {
return 'mapquery_' + this.idCounter++;
},
_removeLayer: function(id) {
var layer = this.layersList[id];
if (this._triggerReturn('preremovelayer', [layer])===false) {
return false;
}
// remove id from vectorlayer if it is there list
this.vectorLayers = $.grep(this.vectorLayers, function(elem) {
return elem != id;
});
this._updateSelectFeatureControl(this.vectorLayers);
this.olMap.removeLayer(layer.olLayer);
// XXX vmx: shouldn't the layer be destroyed() properly?
delete this.layersList[id];
layer.trigger('removelayer');
return this;
},
/**
###*map*.`center([options])`
_version added 0.1_
####**Description**: get/set the extent, zoom and position of the map
* **position** the position as [x,y] in displayProjection (default EPSG:4326)
to center the map at
* **zoom** the zoomlevel as integer to zoom the map to
* **box** an array with the lower left x, lower left y, upper right x,
upper right y to zoom the map to,
this will take precedent when conflicting with any of the above values
* **projection** the projection the coordinates are in, default is
the displayProjection
>Returns: {position: [x,y], zoom: z(int), box: [llx,lly,urx,ury]}
The `.center()` method allows us to move to map to a specific zoom level,
specific position or a specific extent. We can specify the projection of the
coordinates to override the displayProjection. For instance you want to show
the coordinates in 4326, but you have a dataset in EPSG:28992
(dutch projection). We can also retrieve the current zoomlevel, position and
extent from the map. The coordinates are returned in displayProjection.
var center = map.center(); //get the current zoom, position and extent
map.center({zoom:4}); //zoom to zoomlevel 4
map.center({position:[5,52]}); //pan to point 5,52
map.center(box:[-180,-90,180,90]); //zoom to the box -180,-900,180,90
//pan to point 125000,485000 in dutch projection
map.center({position:[125000,485000],projection:'EPSG:28992'});
*/
center: function (options) {
var position;
var mapProjection = new OpenLayers.Projection(this.projection);
// Determine source projection
var sourceProjection = null;
var zoom;
var box;
if(options && options.projection) {
sourceProjection = options.projection.CLASS_NAME ===
'OpenLayers.Projection' ? options.projection :
new OpenLayers.Projection(options.projection);
} else {
var displayProjection = this.displayProjection;
if(!displayProjection) {
// source == target
sourceProjection = new OpenLayers.Projection('EPSG:4326');
} else {
sourceProjection = displayProjection.CLASS_NAME ===
'OpenLayers.Projection' ? displayProjection :
new OpenLayers.Projection(displayProjection);
}
}
// Get the current position
if (arguments.length===0) {
position = this.olMap.getCenter();
zoom = this.olMap.getZoom();
box = this.olMap.getExtent();
if (!mapProjection.equals(sourceProjection)) {
position.transform(mapProjection, sourceProjection);
}
box.transform(mapProjection,sourceProjection);
box = box!==null ? box.toArray() : [];
return {
position: [position.lon, position.lat],
zoom: this.olMap.getZoom(),
box: box
};
}
// Zoom to the extent of the box
if (options.box!==undefined) {
box = new OpenLayers.Bounds(
options.box[0], options.box[1],options.box[2], options.box[3]);
if (!mapProjection.equals(sourceProjection)) {
box.transform(sourceProjection,mapProjection);
}
this.olMap.zoomToExtent(box);
}
// Only zoom is given
else if (options.position===undefined) {
this.olMap.zoomTo(options.zoom);
}
// Position is given, zoom maybe as well
else {
position = new OpenLayers.LonLat(options.position[0],
options.position[1]);
if (!mapProjection.equals(sourceProjection)) {
position.transform(sourceProjection, mapProjection);
}
// options.zoom might be undefined, so we are good to
// pass it on
this.olMap.setCenter(position, options.zoom);
}
},
_updateSelectFeatureControl: function(layerIds) {
var vectorLayers = [];
var layersList = this.layersList;
if (this.selectFeatureControl!==null) {
this.selectFeatureControl.deactivate();
this.selectFeatureControl.destroy();
}
$.each(layerIds, function() {
vectorLayers.push(layersList[this].olLayer);
});
this.selectFeatureControl = new OpenLayers.Control.SelectFeature(
vectorLayers);
this.olMap.addControl(this.selectFeatureControl);
this.selectFeatureControl.activate();
},
// This function got a bit too clever. The reason is, that jQuery's
// bind() is overloaded with so many possible combinations of arguments.
// And, of course, MapQuery wants to support them all
// The essence of the function is to wrap the original callback into
// the correct scope
bind: function(types, data, fn) {
var self = this;
// A map of event/handle pairs, wrap each of them
if(arguments.length===1) {
var wrapped = {};
$.each(types, function(type, fn) {
wrapped[type] = function() {
return fn.apply(self, arguments);
};
});
this.events.bind.apply(this.events, [wrapped]);
}
else {
var args = [types];
// Only callback given, but no data (types, fn), hence
// `data` is the function
if(arguments.length===2) {
fn = data;
}
else {
if (!$.isFunction(fn)) {
throw('bind: you might have a typo in the function name');
}
// Callback and data given (types, data, fn), hence include
// the data in the argument list
args.push(data);
}
args.push(function() {
return fn.apply(self, arguments);
});
this.events.bind.apply(this.events, args);
}
//this.events.bind.call(this.events, types, function() {
// data.apply(self, arguments);
//});
//this.events.bind.call(this.events, types, function() {
// data.apply(self, arguments);
//});
//this.events.bind.apply(this.events, arguments);
//this.events.bind.call(this.events, types, $.proxy(data, self));
//this.events.bind.apply(this.events, arguments);//.bind(this);
//this.events.bind.apply(this.events, $.proxy(arguments));//.bind(this);
//this.events.bind.apply(this.events, $.proxy(arguments));//.bind(this);
//this.events.bind(types, data, fn);//.bind(this);
//this.events.bind.call(this.events, types, data, fn);//.bind(this);
return this;
},
/**
###*map*.`trigger(name [, parameters])`
_version added 0.2_
####**Description**: triggers an event on the map
* **name** the name of the event
* **parameters** additional parameters that will be passed on with the event
>Returns: map (MapQuery.Map)
To subscribe to the triggered events, you need to bind to the mapuuu.
map.bind('myEvent', function(evt) {
console.log('the values are: ' + evt.data[0] + ' and ' + evt.data[1])
});
map.trigger('myEvent', 'some', 'values');
*/
trigger: function() {
// There is no point in using trigger() insted of triggerHandler(), as
// we don't fire native events
this.events.triggerHandler.apply(this.events, arguments);
return this;
},
// Basically a trigger that returns the return value of the last listener
_triggerReturn: function() {
return this.events.triggerHandler.apply(this.events, arguments);
},
destroy: function() {
this.olMap.destroy();
this.element.removeData('mapQuery');
}
};
/**
---
#MapQuery.Layer
The MapQuery.Layer object. It is constructed with layer options object in the
map.`layers([options])` function or by passing a `layer:{options}` object in
the `mapQuery()` constructor. The Layer object is refered to as _layer_ in the
documentation.
*/
$.MapQuery.Layer = function(map, id, options) {
var self = this;
// apply default options that are not specific to a layer
this.id = id;
this.label = options.label || this.id;
// a reference to the map object is needed as it stores e.g. the list
// of all layers (and we need to keep track of it, if we delete a
// layer)
this.map = map;
// true if this layer is a vector layer
this.isVector = false;
// to bind and trigger jQuery events
this.events = $({});
this.handlers = {
// Triggers the jQuery events, after the OpenLayers events
// happened without any further processing
simple: function(data) {
this.trigger(data.type);
},
// All OpenLayers events that are triggered by user interaction,
// like clicking somewhere or selecting a feature, need to be
// handled in a special way. Those OpenLayers events will then be
// triggered by MapQuery as well
// In case of the "featureselected" event, this means that the
// logic of handling the event is completely within the event
// handler. When ".select()" on a feature is called, it will just
// trigger the OpenLayers "featureselected" event, whose handler
// will then trigger the corresponding jQuery event.
includeFeature: function(data) {
var feature = new $.MapQuery.Feature(this, {olFeature:
data.feature});
this.trigger(data.type, [feature]);
},
prependLayer: function(data) {
this.trigger('layer' + data.type);
}
};
// create the actual layer based on the options
// Returns layer and final options for the layer (for later re-use,
// e.g. zoomToMaxExtent).
var res = $.MapQuery.Layer.types[options.type.toLowerCase()].call(
this, options);
this.olLayer = res.layer;
this.options = res.options;
// Some good documentation for the events is needed. Here is a short
// description on how the current events compare to the OpenLayer
// events on the layer:
// - added, remove: not needed, there's addlayer and removelayer
// - visibilitychanged: not needed, there's the changelayer event
// - move, moveend: not needed as you get them from the map, not the layer
// - loadstart, loadend: renamed to layerloadstart, layerloadend
this.olLayer.events.on({
scope: this,
loadstart: this.handlers.prependLayer,
loadend: this.handlers.prependLayer,
featureselected: this.handlers.includeFeature,
featureunselected: this.handlers.includeFeature,
featureremoved: this.handlers.includeFeature
});
// To be able to retreive the MapQuery layer, when we only have the
// OpenLayers layer available. For example on the layeradded event.
// NOTE vmx 2012-02-26: Any nicer solution is welcome
this.olLayer.mapQueryId = this.id;
};
$.MapQuery.Layer.prototype = {
/**
###*layer*.`down([delta])`
_version added 0.1_
####**Description**: move the layer down in the layer stack of the map
* **delta** the amount of layers the layer has to move down in the layer
stack (default 1)
>Returns layer (MapQuery.Layer)
The `.down()` method is a shortcut method for `.position(pos)` which makes
it easier to move a layer down in the layerstack relative to its current
position. It takes an integer and will try to move the layer down the number of
places given. If delta is bigger than the current position in the stack, it
will put the layer at the bottom.
layer.down(); //move layer 1 place down
layer.down(3); //move layer 3 places down
*/
down: function(delta) {
delta = delta || 1;
var pos = this.position();
pos = pos - delta;
if (pos<0) {pos = 0;}
this.position(pos);
return this;
},
// NOTE vmx: this would be pretty cool, but it's not easily possible
// you could use $.each($.geojq.layer())) instead, this is for pure
// convenience.
each: function () {},
/**
###*layer*.`remove()`
_version added 0.2_
####**Description**: remove the layer from the map
>Returns: map (MapQuery.Map) or false
The `.remove()` method allows us to remove a layer from the map.
It returns the `map` object if the layer was removed, or `false` if the
removal was prevented in the preremovelayer event.
var id = layer.remove(); //remove this layer
*/
remove: function() {
// remove references to this layer that are stored in the
// map object
return this.map._removeLayer(this.id);
},
/**
###*layer*.`position([position])`
_version added 0.1_
####**Description**: get/set the `position` of the layer in the layer
stack of the map
* **position** an integer setting the new position of the layer in the layer stack
>Returns: position (integer) _or_ layer (MapQuery.Layer)
The `.position()` method allows us to change the position of the layer in the
layer stack. It will take into account the hidden baselayer that is used by
OpenLayers. The lowest layer is position 0. If no position is given, it will
return the current postion.
var pos = layer.position(); //get position of layer in the layer stack
layer.position(2); //put layer on position 2 in the layer stack
*/
position: function(pos) {
if (pos===undefined) {
return this.map.olMap.getLayerIndex(this.olLayer)-1;
}
else {
this.map.olMap.setLayerIndex(this.olLayer, pos+1);
this.trigger('changelayer', ['position']);
return this;
}
},
/**
###*layer*.`up([delta])`
_version added 0.1_
####**Description**: move the layer up in the layer stack of the map
* **delta** the amount of layers the layer has to move up in the layer
stack (default 1)
>Returns: layer (MapQuery.Layer)
The `.up()` method is a shortcut method for `.position(pos)` which makes
it easier to move a layer up in the layerstack relative to its current
position. It takes an integer and will move the layer up the number of places
given.
layer.up(); //move layer 1 place up
layer.up(3); //move layer 3 places up
*/
up: function(delta) {
delta = delta || 1;
var pos = this.position();
pos = pos + delta;
this.position(pos);
return this;
},
/**
###*layer*.`visible([visible])`
_version added 0.1_
####**Description**: get/set the `visible` state of the layer
* **visible** a boolean setting the visibility of the layer
>Returns: visible (boolean)
The `.visible()` method allows us to change the visibility of the layer.
If no visible is given, it will return the current visibility.
var vis = layer.visible(); //get the visibility of layer
layer.visible(true); //set visibility of layer to true
*/
visible: function(vis) {
if (vis===undefined) {
return this.olLayer.getVisibility();
}
else {
this.olLayer.setVisibility(vis);
this.trigger('changelayer', ['visibility']);
return this;
}
},
/**
###*layer*.`opacity([opacity])`
_version added 0.1_
####**Description**: get/set the `opacity` of the layer
* **position** a float [0-1] setting the opacity of the layer
>Returns: opacity (float) _or_ layer (MapQuery.Layer)
The `.opacity()` method allows us to change the opacity of the layer.
If no opacity is given, it will return the current opacity.
var opac = layer.opacity(); //get opacity of layer
layer.opacity(0.7); //set opacity of layer to 0.7
*/
opacity: function(opac) {
if (opac===undefined) {
// this.olLayer.opacity can be null if never
// set so return the visibility
var value = this.olLayer.opacity ?
this.olLayer.opacity : this.olLayer.getVisibility();
return value;
}
else {
this.olLayer.setOpacity(opac);
this.trigger('changelayer', ['opacity']);
return this;
}
},
// every event gets the layer passed in
bind: function() {
// Use the same bind function as for the map
this.map.bind.apply(this, arguments);
return this;
},
/**
###*layer*.`trigger(name [, parameters])`
_version added 0.2_
####**Description**: triggers an event on the layer and map
* **name** the name of the event
* **parameters** additional parameters that will be passed on with the event
>Returns: layer (MapQuery.Layer)
The events get triggered on the layer as well as on the map. To subscribe to
the triggered events, you can either bind to the layer or the map. If bound
to the map, the second argument in the bind will be the layer the event
came from
layer.bind('myEvent', function(evt) {
console.log('the values are: ' + evt.data[0] + ' and ' + evt.data[1])
});
map.bind('myEvent', function(evt, layer) {
console.log('the values are: ' + evt.data[0] + ' and ' + evt.data[1])
});
layer.trigger('myEvent', 'some', 'values');
*/
trigger: function() {
var args = Array.prototype.slice.call(arguments);
this.events.triggerHandler.apply(this.events, args);
this._addLayerToArgs(args);
this.map.events.triggerHandler.apply(this.map.events, args);
return this;
},
// Basically a trigger that returns the return value of the last listener
_triggerReturn: function() {
var args = Array.prototype.slice.call(arguments);
var ret = this.events.triggerHandler.apply(this.events, args);
if (ret !== undefined) {
return ret;
}
this._addLayerToArgs(args);
return this.events.triggerHandler.apply(this.map.events, args);
},
// Adds the current layer to the event arguments, so that it is included
// in the event on the map
_addLayerToArgs: function(args) {
// Add layer for the map event
if (args.length===1) {
args.push([this]);
}
else {
args[1].unshift(this);
}
},
/**
###*layer*.`features([options])`
_version added 0.2.0_
####**Description**: get/set the features of a (vector) layer
**options** an object of key-value pairs with options to create one or
more features
>Returns: [features] (array of MapQuery.Feature)
The `.features()` method allows us to attach features to a mapQuery layer
object. It takes an options object with feature options. To add multiple
features, create an array of feature options objects. If an options object
is given, it will return the resulting feature(s). We can also use it to
retrieve all features currently attached to the layer.
// add an (vector) json layer to the map
var jsonlayer = map.layers({type:'json'});
// add a feature to the layer
jsonlayer.features({geometry: {type: "Point", coordinates: [5.3, 7.4]}});
// get all features of a layer (sorted with first added feature at the beginning
var features = jsonlayer.features();
*/
features: function(options) {
var self = this;
switch(arguments.length) {
// return all features
case 0:
return this._allFeatures();
// add new feature(s)
case 1:
if (!$.isArray(options)) {
return this._addFeature(options);
}
else {
return $.map(options, function(feature) {
return self._addFeature(feature);
});
}
break;
default:
throw('wrong argument number');
}
},
_allFeatures: function() {
var layer = this;
return $.map(layer.olLayer.features, function(feature) {
return new $.MapQuery.Feature(layer, {olFeature: feature});
});
},
_addFeature: function(options) {
var feature = new $.MapQuery.Feature(this, options);
// NOTE vmx 2012-04-19: Not sure if this is a good idea, or if it would
// be better to include `options` with the preaddfeature event
if (this._triggerReturn('preaddfeature', [feature])===false) {
return false;
}
this.olLayer.addFeatures(feature.olFeature);
this.trigger('addfeature', [feature]);
return feature;
}
};
/**
#MapQuery.Feature
The MapQuery.Feature object. It is constructed with a feature options object
in the layer.`features([options])` function. The Feautre object is refered to
as _feature_ in the documentation.
TODO vmx 20110905: Support other geometry types than GeoJSON
options:
* geometry: A GeoJSON geometry
* properties: Properties for the feature
*/
// Not in the pulic API docs: You can pass in as options:
// * olFeature: This will wrap the olFeature in a MapQuery feature
$.MapQuery.Feature = function(layer, options) {
// The ID is the
this._id = layer.map._createId();
this.layer = layer;
// Feature already exists on the layer, it just needs to be wrapped
// to an MapQuery feature
if (options.olFeature) {
this.olFeature = options.olFeature;
}
else {
// XXX vmx 20110905: Different feature types might make sense:
// (Geo)JSON, KML, WKT
// vmx 2012-04-14: I changed my mind quite some time ago. We should onlu
// support GeoJSON and let the user easily transfrom their format
// (e.g. KML) to GeoJSON, before they add a feature to the layer
var GeoJSON = new OpenLayers.Format.GeoJSON();
var geometry = GeoJSON.parseGeometry(options.geometry);
geometry.transform(
new OpenLayers.Projection(this.layer.map.displaProjection),
new OpenLayers.Projection(this.layer.map.projection));
this.olFeature = new OpenLayers.Feature.Vector(geometry,
options.properties);
}
// Modify the features to be more practical
// e.g. copy properties that should be easily accessed from the
// outside, out of the olLayer and to the feature level
this.properties = $.extend(true, {}, this.olFeature.attributes);
this.geometry = $.parseJSON(
new OpenLayers.Format.GeoJSON().write(this.olFeature.geometry));
return this;
};
$.MapQuery.Feature.prototype = {
/**
###*feature*.`remove()`
_version added 0.2.0_
####**Description**: remove the feature from the layer
>Returns: layer (layer) or false
The `.remove()` method allows us to remove a feature from the layer.
It returns the `layer` object if the feature was removed, or `false` if the
removal was prevented in the preremovefeature event.
// add a feature to a layer
var feature = layer.features({geometry: {type: "Point", coordinates: [5.3, 7.4]}});
// remove the feature again
feature.remove();
*/
remove: function() {
if (this.layer._triggerReturn('preremovefeature', [this])===false) {
return false;
}
this.layer.olLayer.removeFeatures(this.olFeature);
// The `removefeature` event is triggered by an OpenLayes event handler
return this.layer;
},
/**
###*feature*.`select(exclusive)`
_version added 0.2.0_
####**Description**: select a feature
**exclusive** (boolean, default: true) True means that all other features get
deselectd
>Returns: layer (layer)
The `.select()` method allows us to select a feature from the layer.
A `featureselected` will be fired.
// add a feature to a layer
var feature = layer.features({geometry: {type: "Point", coordinates: [5.3, 7.4]}});
// select the feature again
feature.select();
*/
select: function(exclusive) {
if (exclusive===undefined || exclusive===true) {
this.layer.map.selectFeatureControl.unselectAll();
}
this.layer.map.selectFeatureControl.select(this.olFeature);
},
/**
###*feature*.`unselect()`
_version added 0.2.0_
####**Description**: unselect a feature
>Returns: layer (layer)
The `.unselect()` method allows us to unselect a feature from the layer.
A `featureunselected` will be fired.
// add a feature to a layer
var feature = layer.features({geometry: {type: "Point", coordinates: [5.3, 7.4]}});
// select the feature
feature.select();
// unselect the feature again
feature.unselect();
*/
unselect: function() {
this.layer.map.selectFeatureControl.unselect(this.olFeature);
}
};
$.fn.mapQuery = function(options) {
return this.each(function() {
var instance = $.data(this, 'mapQuery');
if (!instance) {
$.data(this, 'mapQuery', new $.MapQuery.Map($(this), options));
}
});
};
$.extend($.MapQuery.Layer, {
types: {
/**
###*layer* `{type:bing}`
_version added 0.1_
####**Description**: create a Bing maps layer
* **view** a string ['road','hybrid','satellite'] to define which Bing maps
layer to use (default road)
* **key** Bing Maps API key for your application. Get you own at
http://bingmapsportal.com/
* **label** string with the name of the layer
layers:[{
type:'bing', //create a bing maps layer
view:'satellite', //use the bing satellite layer
key:'ArAGGPJ16xm0RX' //the Bing maps API key
}]
*/
bing: function(options) {
var o = $.extend(true, {}, $.fn.mapQuery.defaults.layer.all,
$.fn.mapQuery.defaults.layer.bing,
options);
var view = o.view;
switch(view){
case 'road':
view = 'Road'; break;
case 'hybrid':
view = 'AerialWithLabels'; break;
case 'satellite':
view = 'Aerial'; break;
}
return {
layer: new OpenLayers.Layer.Bing({type:view,key:o.key}),
options: o
};
},
//Not sure this one is worth pursuing works with ecwp:// & jpip:// urls
//See ../lib/NCSOpenLayersECWP.js
ecwp: function(options) {
var o = $.extend(true, {}, $.fn.mapQuery.defaults.layer.all,
$.fn.mapQuery.defaults.layer.raster,
options);
return {
layer: new OpenLayers.Layer.ECWP(o.label, o.url, o),
options: o
};
},
/**
###*layer* `{type:google}`
_version added 0.1_
####**Description**: create a Google maps layer
* **view** a string ['road','hybrid','satellite'] to define which Google maps
layer to use (default road)
* **label** string with the name of the layer
*Note* you need to include the google maps v3 API in your application by adding
`<script src="http://maps.google.com/maps/api/js?v=3.5&sensor=false"type="text/javascript"></script>`
layers:[{
type:'google', //create a google maps layer
view:'hybrid' //use the google hybridlayer
}]
*/
google: function(options) {
var o = $.extend(true, {}, $.fn.mapQuery.defaults.layer.all,
$.fn.mapQuery.defaults.layer.google,
options);
var view = o.view;
switch(view){
case 'road':
view = google.maps.MapTypeId.ROADMAP; break;
case 'terrain':
view = google.maps.MapTypeId.TERRAIN; break;
case 'hybrid':
view = google.maps.MapTypeId.HYBRID; break;
case 'satellite':
view = google.maps.MapTypeId.SATELLITE; break;
}
return {
layer: new OpenLayers.Layer.Google({type:view}),
options: o
};
},
/**
###*layer* `{type:vector}`
_version added 0.1_
####**Description**: create a vector layer
* **label** string with the name of the layer
layers:[{
type:'vector' //create a vector layer
}]
*/
vector: function(options) {
var o = $.extend(true, {}, $.fn.mapQuery.defaults.layer.all,
$.fn.mapQuery.defaults.layer.vector,
options);
this.isVector = true;
return {
layer: new OpenLayers.Layer.Vector(o.label),
options: o
};
},
/**
###*layer* `{type:json}`
_version added 0.1_
####**Description**: create a JSON layer
* **url** a string pointing to the location of the JSON data
* **strategies** a string ['bbox','cluster','filter','fixed','paging','refresh','save']
stating which update strategy should be used (default fixed)
(see also http://dev.openlayers.org/apidocs/files/OpenLayers/Strategy-js.html)
* **projection** a string with the projection of the JSON data (default EPSG:4326)
* **styleMap** {object} the style to be used to render the JSON data
* **label** string with the name of the layer
layers:[{
type: 'JSON',
url: 'data/reservate.json',
label: 'reservate'
}]
*/
json: function(options) {
var o = $.extend(true, {}, $.fn.mapQuery.defaults.layer.all,
$.fn.mapQuery.defaults.layer.vector,
options);
this.isVector = true;
var strategies = [];
for (var i in o.strategies) {
if(o.strategies.hasOwnProperty(i)) {
switch(o.strategies[i].toLowerCase()) {
case 'bbox':
strategies.push(new OpenLayers.Strategy.BBOX());
break;
case 'cluster':
strategies.push(new OpenLayers.Strategy.Cluster());
break;
case 'filter':
strategies.push(new OpenLayers.Strategy.Filter());
break;
case 'fixed':
strategies.push(new OpenLayers.Strategy.Fixed());
break;
case 'paging':
strategies.push(new OpenLayers.Strategy.Paging());
break;
case 'refresh':
strategies.push(new OpenLayers.Strategy.Refresh());
break;
case 'save':
strategies.push(new OpenLayers.Strategy.Save());
break;
}
}
}
var protocol;
var params = {
strategies: strategies,
projection: o.projection || 'EPSG:4326',
styleMap: o.styleMap
};
if (o.url) {
// only use JSONP if we use http(s)
if (o.url.match(/^https?:\/\//)!==null &&
!$.MapQuery.util.sameOrigin(o.url)) {
protocol = 'Script';
}
else {
protocol = 'HTTP';
}
params.protocol = new OpenLayers.Protocol[protocol]({
url: o.url,
format: new OpenLayers.Format.GeoJSON()
});
};
var layer = new OpenLayers.Layer.Vector(o.label, params);
return {
layer: layer,
options: o
};
},
/**
###*layer* `{type:osm}`
_version added 0.1_
####**Description**: create an OpenStreetMap layer
* **label** string with the name of the layer
* **url** A single URL (string) or an array of URLs to OSM-like server like
Cloudmade
* **attribution** A string to put some attribution on the map
layers:[{
type: 'osm',
url: [
'http://a.tile.cloudmade.com/<yourapikey>/999/256/${z}/${x}/${y}.png',
'http://b.tile.cloudmade.com/<yourapikey>/999/256/${z}/${x}/${y}.png',
'http://c.tile.cloudmade.com/<yourapikey>/999/256/${z}/${x}/${y}.png'
],
attribution: "Data © 2009 <a href='http://openstreetmap.org/'>
OpenStreetMap</a>. Rendering © 2009
<a href='http://cloudmade.com'>CloudMade</a>."
}]
*/
osm: function(options) {
var o = $.extend(true, {}, $.fn.mapQuery.defaults.layer.all,
$.fn.mapQuery.defaults.layer.osm,
options);
var label = options.label || undefined;
var url = options.url || undefined;
return {
layer: new OpenLayers.Layer.OSM(label, url, o),
options: o
};
},
/**
###*layer* `{type:tms}`
_version added 0.1_
####**Description**: create an OpenStreetMap layer
* **label** string with the name of the layer
* **url** A single URL (string) or an array of URLs to the TMS end point
* **layer** The identifier for the <TileMap> as advertised by the service.
For example, if the service advertises a <TileMap> with ‘href=”http://tms.osgeo.org/1.0.0/vmap0”’,
the layer property would be set to “vmap0”.
* **format** The image format (default png)
layers:[{
type: 'tms',
url: 'http://tilecache.osgeo.org/wms-c/Basic.py/',
layer: 'basic'
}]
*/
tms: function(options) {
var o = $.extend(true, {}, $.fn.mapQuery.defaults.layer.all,
$.fn.mapQuery.defaults.layer.tms,
options);
var label = options.label || undefined;
var url = options.url || undefined;
var params = {
layername: o.layer,
type: o.format
};
return {
layer: new OpenLayers.Layer.TMS(label, url, params),
options: o
};
},
/**
###*layer* `{type:wms}`
_version added 0.1_
####**Description**: create a WMS layer
* **url** a string pointing to the location of the WMS service
* **layers** a string with the name of the WMS layer(s)
* **format** a string with format of the WMS image (default image/jpeg)
* **transparent** a boolean for requesting images with transparency
* **label** string with the name of the layer
* **wms_parameters** an hashtable of extra GetMap query string parameters and parameter values
layers:[{
type:'wms',
url:'http://vmap0.tiles.osgeo.org/wms/vmap0',
layers:'basic'
}]
*/
wms: function(options) {
var o = $.extend(true, {}, $.fn.mapQuery.defaults.layer.all,
$.fn.mapQuery.defaults.layer.raster,
options);
var params = {
layers: o.layers,
transparent: o.transparent,
format: o.format
};
if(typeof o.wms_parameters != "undefined"){
params = $.extend(params, o.wms_parameters);
}
return {
layer: new OpenLayers.Layer.WMS(o.label, o.url, params, o),
options: o
};
},
//TODO complete this documentation
/**
###*layer* `{type:wmts}`
_version added 0.1_
####**Description**: create a WMTS (tiling) layer
* **url** a string pointing to the location of the WMTS service
* **layer** a string with the name of the WMTS layer
* **matrixSet** a string with one of the advertised matrix set identifiers
* **style** a string with one of the advertised layer styles
* **label** string with the name of the layer
layers:[{
type:'wmts'
}]
*/
wmts: function(options) {
var o = $.extend(true, {}, $.fn.mapQuery.defaults.layer.all,
$.fn.mapQuery.defaults.layer.wmts);
//smo 20110614 the maxExtent is set here with OpenLayers.Bounds
if (options.sphericalMercator===true) {
$.extend(true, o, {
maxExtent: new OpenLayers.Bounds(
-128 * 156543.0339, -128 * 156543.0339,
128 * 156543.0339, 128 * 156543.0339),
maxResolution: 156543.0339,
numZoomLevels: 19,
projection: 'EPSG:900913',
units: 'm'
});
}
$.extend(true, o, options);
// use by default all options that were passed in for the final
// openlayers layer consrtuctor
var params = $.extend(true, {}, o);
// remove trailing slash
if (params.url.charAt(params.url.length-1)==='/') {
params.url = params.url.slice(0, params.url.length-1);
}
// if no options that influence the URL where set, extract them
// from the given URL
if (o.layer===undefined && o.matrixSet===undefined &&
o.style===undefined) {
var url = $.MapQuery.util.parseUri(params.url);
var urlParts = url.path.split('/');
var wmtsPath = urlParts.slice(urlParts.length-3);
params.url = url.protocol ? url.protocol + '//' : '';
params.url += url.authority +
// remove WMTS version (1.0.0) as well
urlParts.slice(0, urlParts.length-4).join('/');
params.layer = wmtsPath[0];
params.style = wmtsPath[1];
params.matrixSet = wmtsPath[2];
}
return {
layer: new OpenLayers.Layer.WMTS(params),
options: o
};
}
}
});
// default options for the map and layers
$.fn.mapQuery.defaults = {
// The controls for the map are per instance, therefore it need to
// be an function that can be initiated per instance
map: function() {
return {
// Remove quirky moveTo behavior, probably not a good idea in the
// long run
allOverlays: true,
controls: [
// Since OL2.11 the Navigation control includes touch navigation as well
new OpenLayers.Control.Navigation({
documentDrag: true,
dragPanOptions: {
interval: 1,
enableKinetic: true
}
}),
new OpenLayers.Control.ArgParser(),
new OpenLayers.Control.Attribution(),
new OpenLayers.Control.KeyboardDefaults()
],
format: 'image/png',
maxExtent: [-128*156543.0339,
-128*156543.0339,
128*156543.0339,
128*156543.0339],
maxResolution: 156543.0339,
numZoomLevels: 19,
projection: 'EPSG:900913',
displayProjection: 'EPSG:4326',
zoomToMaxExtent: true,
units: 'm'
};
},
layer: {
all: {
isBaseLayer: false,
//in general it is kinda pointless to load tiles outside a maxextent
displayOutsideMaxExtent: false
},
bing: {
transitionEffect: 'resize',
view: 'road',
sphericalMercator: true
},
google: {
transitionEffect: 'resize',
view: 'road',
sphericalMercator: true
},
osm: {
transitionEffect: 'resize',
sphericalMercator: true
},
tms: {
transitionEffect: 'resize',
format: 'png'
},
raster: {
// options for raster layers
transparent: true
},
vector: {
// options for vector layers
strategies: ['bbox']
},
wmts: {
format: 'image/jpeg',
requestEncoding: 'REST',
sphericalMercator: false
}
}
};
// Some utility functions
$.MapQuery.util = {};
// http://blog.stevenlevithan.com/archives/parseuri (2010-12-18)
// parseUri 1.2.2
// (c) Steven Levithan <stevenlevithan.com>
// MIT License
// Edited to include the colon in the protocol, just like it is
// with window.location.protocol
$.MapQuery.util.parseUri = function (str) {
var o = $.MapQuery.util.parseUri.options,
m = o.parser[o.strictMode ? "strict" : "loose"].exec(str),
uri = {},
i = 14;
while (i--) {uri[o.key[i]] = m[i] || "";}
uri[o.q.name] = {};
uri[o.key[12]].replace(o.q.parser, function ($0, $1, $2) {
if ($1) {uri[o.q.name][$1] = $2;}
});
return uri;
};
$.MapQuery.util.parseUri.options = {
strictMode: false,
key: ["source", "protocol", "authority", "userInfo", "user",
"password", "host", "port", "relative", "path", "directory",
"file", "query", "anchor"],
q: {
name: "queryKey",
parser: /(?:^|&)([^&=]*)=?([^&]*)/g
},
parser: {
strict: /^(?:([^:\/?#]+:))?(?:\/\/((?:(([^:@]*)(?::([^:@]*))?)?@)?([^:\/?#]*)(?::(\d*))?))?((((?:[^?#\/]*\/)*)([^?#]*))(?:\?([^#]*))?(?:#(.*))?)/,
loose: /^(?:(?![^:@]+:[^:@\/]*@)([^:\/?#.]+:))?(?:\/\/)?((?:(([^:@]*)(?::([^:@]*))?)?@)?([^:\/?#]*)(?::(\d*))?)(((\/(?:[^?#](?![^?#\/]*\.[^?#\/.]+(?:[?#]|$)))*\/?)?([^?#\/]*))(?:\?([^#]*))?(?:#(.*))?)/
}
};
// Checks whether a URL conforms to the same origin policy or not
$.MapQuery.util.sameOrigin = function(url) {
var parsed = $.MapQuery.util.parseUri(url);
parsed.protocol = parsed.protocol || 'file:';
parsed.port = parsed.port || "80";
var current = {
domain: document.domain,
port: window.location.port,
protocol: window.location.protocol
};
current.port = current.port || "80";
return parsed.protocol===current.protocol &&
parsed.port===current.port &&
// the current domain is a suffix of the parsed domain
parsed.host.match(current.domain + '$')!==null;
};
})(jQuery);