leaflet-measure
Coordinate, linear, and area measure control for Leaflet maps. Extends L.Control.
Demo
![Demo](https://raw.githubusercontent.com/ljagis/leaflet-measure/master/example/leaflet-measure-demo.jpg)
Install Options
-
Clone.. git clone https://github.com/ljagis/leaflet-measure.git
-
Install with Bower.. bower install leaflet-measure
-
Install with npm.. npm install leaflet-measure
Use bundled leaflet-measure.min.js
or leaflet-measure.js
Include the Leaflet Source, leaflet-measure.min.js
, and associated CSS stylesheets in your HTML page
<!doctype HTML>
<html>
<head>
<meta charset="utf-8">
<link rel="stylesheet" href="http://cdn.leafletjs.com/leaflet-0.7.3/leaflet.css">
<link rel="stylesheet" href="leaflet-measure.css">
</head>
<body>
<script src="http://cdn.leafletjs.com/leaflet-0.7.3/leaflet.js"></script>
<script src="leaflet-measure.min.js"></script>
<script>
</script>
</body>
</html>
Use with npm
var L = require('leaflet');
require('leaflet-measure');
Add control to a Leaflet map
leaflet-measure
adds L.Control.Measure
. This control may be used with the standard Leaflet control workflows described in the Leaflet docs.
The measure control can be instantiated directly and added to a map:
var myMap = L.map('mapElementId', options);
var measureControl = new L.Control.Measure(options);
measureControl.addTo(myMap);
or instantiated via the factory:
var myMap = L.map('mapElementId', options);
var measureControl = L.control.measure(options);
measureControl.addTo(myMap);
or added to a map using map options:
var myMap = L.map('mapElementId', {
measureControl: true
});
Control options
position
{ position: 'topright' }
Standard Leaflet control position options
markerSize
{ markerSize: 4 }
Size of circle marker used as symbology for vertexes of measurement graphics. All other map feature styles (marker colors, area color and opacity, line widths, etc..) can be customized using CSS. Marker size is not available for styling in this way.
popupOptions: { className: 'leaflet-measure-resultpopup', autoPanPadding: [10, 10] }
Options applied to the popup of the resulting measure feature. Properties my be any standard Leaflet popup options.
Customizing map feature styles
Map features may be styled using CSS SVG style attributes. Features generated from leaflet-measure
measurements are given the following class names:
-
layer-measurecollector: Transparent layer covering full map and catching click and drag events
-
layer-measurearea: Feature displaying area of an active measurement
-
layer-measureboundary: Feature displaying the linear path of an active measurement
-
layer-measurevertex: Feature added at each vertex (measurement click) of an active measurement
-
layer-measuredrag: Symbol following cursor while moving during an active measurement
-
layer-measure-resultarea: Feature added to the map as a permanent layer resulting from an area (3+ points) measurement
-
layer-measure-resultline: Feature added to the map as a permanent layer resulting from a linear (2 point) measurement
-
layer-measure-resultpoint: Featured added to the map as a permanent layer resulting from a point (single click) measurement