Leaflet/reference.html

1738 lines
58 KiB
HTML
Raw Normal View History

2011-03-24 00:35:29 +08:00
<!DOCTYPE html>
<html>
<head>
2011-04-27 19:54:39 +08:00
<title>Leaflet - a modern, lightweight JavaScript library for interactive maps by CloudMade - Documentation</title>
2011-03-24 00:35:29 +08:00
<meta charset="utf-8" />
2011-04-09 22:32:46 +08:00
<link rel="icon" type="image/png" href="docs/images/favicon.png" />
2011-04-09 22:31:13 +08:00
2011-03-24 00:35:29 +08:00
<!-- Blueprint -->
2011-03-24 20:02:42 +08:00
<link rel="stylesheet" href="docs/css/blueprint/screen.css" media="screen, projection">
<link rel="stylesheet" href="docs/css/blueprint/print.css" media="print">
<!--[if lt IE 8]><link rel="stylesheet" href="docs/css/blueprint/ie.css" media="screen, projection"><![endif]-->
2011-03-24 00:35:29 +08:00
2011-03-24 20:02:42 +08:00
<link rel="stylesheet" href="docs/css/screen.css" media="screen, projection" />
2011-03-24 00:35:29 +08:00
2011-03-24 20:02:42 +08:00
<script src="docs/highlight/highlight.pack.js"></script>
<link rel="stylesheet" href="docs/highlight/styles/github.css" />
2011-03-24 00:35:29 +08:00
<!-- Leaflet -->
2011-03-24 20:02:42 +08:00
<link rel="stylesheet" href="dist/leaflet.css" />
<!--[if lte IE 8]><link rel="stylesheet" href="dist/leaflet.ie.css" /><![endif]-->
<script src="dist/leaflet.js"></script>
2011-03-24 00:35:29 +08:00
</head>
<body>
<div class="container">
<h1>Leaflet</h1>
2011-03-24 20:02:42 +08:00
<h3 class="alt">A Modern, Lightweight Open-Source JavaScript Library for Interactive Maps by <a href="http://cloudmade.com">CloudMade</a></h3>
2011-03-24 00:35:29 +08:00
2011-04-06 22:47:11 +08:00
<ul class="nav clearfix">
2011-04-06 23:35:45 +08:00
<li><a href="index.html">Overview</a></li>
2011-04-06 22:47:11 +08:00
<li><a href="features.html">Features</a></li>
2011-04-16 01:30:42 +08:00
<li><a href="examples.html">Examples</a></li>
2011-04-06 22:47:11 +08:00
<li><span>Documentation</span></li>
<li><a href="download.html">Download</a></li>
2011-04-06 22:47:11 +08:00
<li><a class="twitter-link" href="http://twitter.com/LeafletJS">@LeafletJS</a></li>
<li><a class="github-link" href="http://github.com/CloudMade/Leaflet">GitHub Repo</a></li>
</ul>
2011-03-24 00:35:29 +08:00
2011-03-28 20:36:32 +08:00
<div id="toc" class="clearfix">
2011-04-01 21:09:19 +08:00
<div class="span-5 colborder">
<h4>Map</h4>
2011-03-28 20:36:32 +08:00
<ul>
2011-04-01 21:09:19 +08:00
<li><a href="#map-usage">Usage example</a></li>
<li><a href="#map-constructor">Constructor</a></li>
<li><a href="#map-options">Options</a></li>
2011-04-15 19:46:55 +08:00
<li><a href="#map-properties">Properties</a></li>
2011-05-12 22:21:47 +08:00
<li><a href="#map-events">Events</a></li>
2011-03-28 20:36:32 +08:00
</ul>
2011-03-28 23:27:20 +08:00
<h4>Map methods</h4>
2011-03-28 20:36:32 +08:00
<ul>
2011-04-01 21:09:19 +08:00
<li><a href="#map-set-methods">Methods that modify map state</a></li>
<li><a href="#map-get-methods">Methods that get map state</a></li>
2011-04-13 19:50:33 +08:00
<li><a href="#map-stuff-methods">Methods for layers and controls</a></li>
2011-04-01 21:09:19 +08:00
<li><a href="#map-conversion-methods">Conversion methods</a></li>
2011-04-13 20:55:15 +08:00
<li><a href="#map-misc-methods">Other methods</a></li>
2011-03-28 20:36:32 +08:00
</ul>
</div>
2011-03-28 23:27:20 +08:00
<div class="span-3">
<h4>UI layers</h4>
2011-03-28 20:36:32 +08:00
<ul>
2011-04-01 21:09:19 +08:00
<li><a href="#marker">Marker</a></li>
2011-04-02 18:58:36 +08:00
<li><a href="#popup">Popup</a></li>
2011-03-28 20:36:32 +08:00
</ul>
2011-03-28 23:27:20 +08:00
<h4>Raster layers</h4>
2011-03-28 20:36:32 +08:00
<ul>
2011-04-04 19:57:47 +08:00
<li><a href="#tilelayer">TileLayer</a></li>
2011-04-06 17:43:50 +08:00
<li><a href="#imageoverlay">ImageOverlay</a></li>
2011-03-28 20:36:32 +08:00
</ul>
2011-03-28 23:27:20 +08:00
<h4>Vector layers</h4>
2011-03-28 20:36:32 +08:00
<ul>
<li><a href="#path">Path</a></li>
<li><a href="#polyline">Polyline</a></li>
<li><a href="#polygon">Polygon</a></li>
<li><a href="#circle">Circle</a></li>
</ul>
</div>
2011-03-28 23:27:20 +08:00
<div class="span-3">
<h4>Basic types</h4>
2011-03-28 20:36:32 +08:00
<ul>
<li><a href="#latlng">LatLng</a></li>
2011-04-06 17:43:50 +08:00
<li><a href="#latlngbounds">LatLngBounds</a></li>
2011-03-29 00:00:09 +08:00
<li><a href="#point">Point</a></li>
2011-04-15 06:23:44 +08:00
<li><a href="#bounds">Bounds</a></li>
2011-03-29 00:00:09 +08:00
<li><a class="nodocs" href="#">Icon</a></li>
2011-03-28 20:36:32 +08:00
</ul>
2011-04-11 21:22:07 +08:00
<h4>Controls</h4>
2011-03-28 20:36:32 +08:00
<ul>
2011-04-13 20:55:15 +08:00
<li><a href="#control-zoom">Zoom</a></li>
2011-04-15 19:46:55 +08:00
<li><a href="#control-attribution">Attribution</a></li>
2011-03-28 20:36:32 +08:00
</ul>
</div>
2011-04-11 21:22:07 +08:00
<div class="span-3">
2011-05-12 23:14:35 +08:00
<h4>Events</h4>
<ul>
<li><a href="#events">Events methods</a></li>
<li><a href="#event-objects">Event objects</a></li>
</ul>
<h4>Interfaces</h4>
<ul>
<li><a href="#ihandler">IHandler</a></li>
<li><a class="nodocs" href="#">ILayer</a></li>
<li><a class="nodocs" href="#">IControl</a></li>
<li><a class="nodocs" href="#">IProjection</a></li>
</ul>
</div>
<div class="span-3 last">
2011-03-28 23:27:20 +08:00
<h4>Utility</h4>
2011-03-28 20:36:32 +08:00
<ul>
<li><a class="nodocs" href="#">Class</a></li>
<li><a class="nodocs" href="#">Browser</a></li>
<li><a class="nodocs" href="#">Util</a></li>
<!-- <li><a class="nodocs" href="#">LineUtil</a></li>
<li><a class="nodocs" href="#">PolyUtil</a></li> -->
</ul>
2011-03-28 23:27:20 +08:00
<h4>DOM utility</h4>
2011-03-28 20:36:32 +08:00
<ul>
<li><a class="nodocs" href="#">DomEvent</a></li>
<li><a class="nodocs" href="#">DomUtil</a></li>
2011-05-12 23:14:35 +08:00
<li><a class="nodocs" href="#">Transition</a></li>
<li><a class="nodocs" href="#">Draggable</a></li>
2011-03-28 20:36:32 +08:00
</ul>
<!-- <ul>
<li><a class="nodocs" href="#">Transformation</a></li>
<li><a class="nodocs" href="#">Projection.Mercator</a></li>
</ul> -->
</div>
</div>
2011-04-08 17:36:02 +08:00
<hr />
<p>
2011-04-11 17:14:31 +08:00
<a href="http://twitter.com/share" class="twitter-share-button" data-url="http://leaflet.cloudmade.com" data-text="Leaflet — a modern, lightweight open-source JavaScript library for interactive maps by @cloudmade" data-count="horizontal" data-via="LeafletJS" data-related="CloudMade">Tweet</a><script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script>
<iframe src="http://www.facebook.com/plugins/like.php?href=http%3A%2F%2Fleaflet.cloudmade.com&amp;layout=standard&amp;show_faces=false&amp;width=660&amp;action=like&amp;font=arial&amp;colorscheme=light&amp;height=35" scrolling="no" frameborder="0" style="border:none; overflow:hidden; width:660px; height:24px;" allowTransparency="true"></iframe>
2011-04-08 17:36:02 +08:00
</p>
2011-03-28 20:36:32 +08:00
<h2 id="map-class">L.Map</h2>
2011-03-24 00:35:29 +08:00
2011-03-29 19:56:23 +08:00
<p>The central class of the API &mdash; it is used to create a map on a page and manipulate it.</p>
2011-03-24 22:18:53 +08:00
2011-04-01 21:09:19 +08:00
<h3 id="map-usage">Usage example</h3>
2011-03-24 22:18:53 +08:00
<pre><code class="javascript">// initialize the map on the "map" div with a given center and zoom
var map = new L.Map('map', {
center: new L.LatLng(51.505, -0.09),
zoom: 13
});
// create a CloudMade tile layer
var cloudmadeUrl = 'http://{s}.tile.cloudmade.com/YOUR-API-KEY/997/256/{z}/{x}/{y}.png',
cloudmade = new L.TileLayer(cloudmadeUrl, {maxZoom: 18});
// add the CloudMade layer to the map
map.addLayer(cloudmade);</code></pre>
2011-04-01 21:09:19 +08:00
<h3 id="map-constructor">Constructor</h3>
2011-03-24 00:35:29 +08:00
<table>
<tr>
<th>Constructor</th>
<th>Description</th>
</tr>
<tr>
<td><code>L.Map( &lt;HTMLElement|String&gt;&nbsp;<i>id</i>, &lt;<a href="#map-options">Map&nbsp;options</a>&gt;&nbsp;<i>options?</i> )</code></td>
<td>Instantiates a map object given a div element (or its id) and optionally an object literal with map options described below.</td>
</tr>
</table>
<h3 id="map-options">Options</h3>
<table>
<tr>
<th>Option</th>
<th>Type</th>
<th>Default value</th>
<th>Description</th>
</tr>
<tr>
<td><code>center</code></td>
2011-03-24 22:18:53 +08:00
<td><code><a href="#latlng">LatLng</a></code></td>
2011-03-28 22:30:18 +08:00
<td><code>null</code></td>
2011-03-24 00:35:29 +08:00
<td>Initial geographical center of the map.</td>
</tr>
<tr>
<td><code>zoom</code></td>
<td><code>Number</code></td>
2011-03-28 22:30:18 +08:00
<td><code>null</code></td>
2011-03-24 00:35:29 +08:00
<td>Initial map zoom.</td>
</tr>
<tr>
<td><code>layers</code></td>
<td><code>ILayer[]</code></td>
<td><code>[]</code></td>
<td>Layers that will be added to the map initially.</td>
</tr>
<tr>
<td><code>dragging</code></td>
<td><code>Boolean</code></td>
<td><code>true</code></td>
<td>Whether the map be draggable with mouse/touch or not.</td>
</tr>
<tr>
<td><code>touchZoom</code></td>
<td><code>Boolean</code></td>
<td><code>true</code></td>
<td>Whether the map can be zoomed by touch-dragging with two fingers.</td>
</tr>
<tr>
<td><code>scrollWheelZoom</code></td>
<td><code>Boolean</code></td>
<td><code>true</code></td>
<td>Whether the map can be zoomed by using the mouse wheel.</td>
</tr>
<tr>
<td><code>doubleClickZoom</code></td>
<td><code>Boolean</code></td>
<td><code>true</code></td>
<td>Whether the map can be zoomed in by double clicking on it.</td>
</tr>
2011-04-13 19:50:33 +08:00
<tr>
<td><code>zoomControl</code></td>
<td><code>Boolean</code></td>
<td><code>true</code></td>
2011-04-13 20:55:15 +08:00
<td>Whether the <a href="#control-zoom">zoom control</a> is added to the map by default.</td>
2011-04-13 19:50:33 +08:00
</tr>
2011-05-15 00:46:05 +08:00
<tr>
<td><code>attributionControl</code></td>
<td><code>Boolean</code></td>
<td><code>true</code></td>
<td>Whether the <a href="#control-attribution">attribution control</a> is added to the map by default.</td>
</tr>
2011-03-24 00:35:29 +08:00
<tr>
<td><code>trackResize</code></td>
<td><code>Boolean</code></td>
<td><code>true</code></td>
<td>Whether the map automatically handles browser window resize to update itself.</td>
</tr>
2011-05-15 00:46:05 +08:00
<tr>
<td><code>fadeAnimation</code></td>
<td><code>Boolean</code></td>
<td>depends</td>
<td>Whether the tile fade animation is enabled. By default it's enabled in all browsers that support CSS3 Transitions except Android.</td>
</tr>
<tr>
<td><code>zoomAnimation</code></td>
<td><code>Boolean</code></td>
<td>depends</td>
<td>Whether the tile fade animation is enabled. By default it's enabled in all browsers that support CSS3 Transitions except Android.</td>
</tr>
2011-03-24 00:35:29 +08:00
</table>
2011-04-15 19:46:55 +08:00
<h3 id="map-properties">Properties</h3>
2011-04-01 21:09:19 +08:00
2011-04-15 19:46:55 +08:00
<p>Map properties include interaction handlers that allow you to control interaction behavior in runtime, enabling or disabling certain features such as dragging or touch zoom (see <a href="#ihandler">IHandler</a> methods). Example:</p>
2011-04-01 21:09:19 +08:00
<pre><code class="javascript">map.doubleClickZoom.disable();</code></pre>
2011-04-15 19:46:55 +08:00
<p>You can also access default map controls like attribution control through map properties:</p>
<pre><code class="javascript">map.attributionControl.addAttribution("Earthquake data &amp;copy; GeoNames");</code></pre>
2011-04-01 21:09:19 +08:00
<table>
<tr>
<th>Property</th>
<th>Type</th>
<th>Description</th>
</tr>
<tr>
<td>dragging</td>
<td><a href="#ihandler">IHandler</a></td>
<td>Map dragging handler (by both mouse and touch).</td>
</tr>
<tr>
<td>touchZoom</td>
<td><a href="#ihandler">IHandler</a></td>
<td>Touch zoom handler.</td>
</tr>
<tr>
<td>doubleClickZoom</td>
<td><a href="#ihandler">IHandler</a></td>
<td>Double click zoom handler.</td>
</tr>
<tr>
<td>scrollWheelZoom</td>
<td><a href="#ihandler">IHandler</a></td>
<td>Scroll wheel zoom handler.</td>
</tr>
<tr>
<td>shiftDragZoom</td>
<td><a href="#ihandler">IHandler</a></td>
<td>Shift-drag zoom handler.</td>
</tr>
2011-04-15 19:46:55 +08:00
<tr>
<td>attributionControl</td>
<td><a href="#control-attribution">Control.Attribution</a></td>
<td>Attribution control.</td>
</tr>
2011-04-01 21:09:19 +08:00
</table>
2011-05-12 22:21:47 +08:00
<h3 id="map-events">Events</h3>
<p>You can subscribe to the following events using <a href="#events">these methods</a>.</p>
<table>
<tr>
<th>Event</th>
<th>Data</th>
<th>Description</th>
</tr>
<tr>
<td><code>click</code></td>
<td><code><a href="#mouse-event">MouseEvent</a></code>
<td>Fired when the user clicks (or taps) the map.</td>
</tr>
<tr>
<td><code>dblclick</code></td>
<td><code><a href="#mouse-event">MouseEvent</a></code>
<td>Fired when the user double-clicks (or double-taps) the map.</td>
</tr>
<tr>
<td><code>mousedown</code></td>
<td><code><a href="#mouse-event">MouseEvent</a></code>
<td>Fired when the user pushes the mouse button on the map.</td>
</tr>
<tr>
<td><code>load</code></td>
<td><code><a href="#event">Event</a></code>
<td>Fired when the map is initialized (when its center and zoom are set for the first time).</td>
</tr>
<tr>
<td><code>viewreset</code></td>
<td><code><a href="#event">Event</a></code>
<td>Fired when the map needs to redraw its content (this usually happens on map zoom or load). Very useful for creating custom overlays.</td>
</tr>
<tr>
<td><code>movestart</code></td>
<td><code><a href="#event">Event</a></code>
<td>Fired when the view of the map starts changing (e.g. user starts dragging the map).</td>
</tr>
<tr>
<td><code>move</code></td>
<td><code><a href="#event">Event</a></code>
<td>Fired on any movement of the map view.</td>
</tr>
<tr>
<td><code>moveend</code></td>
<td><code><a href="#event">Event</a></code>
<td>Fired when the view of the map ends changed (e.g. user stopped dragging the map).</td>
</tr>
<tr>
<td><code>zoomend</code></td>
<td><code><a href="#event">Event</a></code>
<td>Fired when the map zoom changes.</td>
</tr>
<tr>
<td><code>layeradd</code></td>
<td><code><a href="#layer-event">LayerEvent</a></code>
<td>Fired when a new layer is added to the map.</td>
</tr>
<tr>
<td><code>layerremove</code></td>
<td><code><a href="#layer-event">LayerEvent</a></code>
<td>Fired when some layer is removed from the map.</td>
</tr>
<tr>
<td><code>locationfound</code></td>
<td><code><a href="#location-event">LocationEvent</a></code>
<td>Fired when geolocation (using <code>locate</code> or <code>locateAndSetView</code> method) went successfully.</td>
</tr>
</table>
2011-04-01 21:09:19 +08:00
<h3 id="map-set-methods">Methods that modify map state</h3>
2011-03-24 00:35:29 +08:00
<table>
<tr>
<th>Method</th>
<th>Returns</th>
<th>Description</th>
</tr>
<tr>
2011-03-24 22:18:53 +08:00
<td><code>setView( &lt;<a href="#latlng">LatLng</a>&gt; <i>center</i>, &lt;Number&gt;&nbsp;<i>zoom</i>, &lt;Boolean&gt;&nbsp;<i>forceReset?</i> )</code></td>
2011-03-24 00:35:29 +08:00
<td><code>this</code></td>
2011-03-29 19:56:23 +08:00
<td>Sets the view of the map (geographical center and zoom). If <code>forceReset</code> is set to <code>true</code>, the map is reloaded even if it's eligible for pan or zoom animation (<code>false</code> by default).</td>
2011-03-24 00:35:29 +08:00
</tr>
<tr>
<td><code>setZoom( &lt;Number&gt;&nbsp;<i>zoom</i> )</code></td>
<td><code>this</code></td>
<td>Sets the zoom of the map.</td>
</tr>
<tr>
<td><code>zoomIn()</code></td>
<td><code>this</code></td>
<td>Increases the zoom of the map by 1.</td>
</tr>
<tr>
<td><code>zoomOut()</code></td>
<td><code>this</code></td>
<td>Decreases the zoom of the map by 1.</td>
</tr>
2011-04-06 17:43:50 +08:00
<tr id="map-fitbounds">
2011-03-24 00:35:29 +08:00
<td><code>fitBounds( &lt;LatLngBounds&gt; <i>bounds</i> )</code></td>
<td><code>this</code></td>
<td>Sets a map view that contains the given geographical bounds with the maximum zoom level possible.</td>
</tr>
<tr>
2011-03-24 22:18:53 +08:00
<td><code>panTo( &lt;<a href="#latlng">LatLng</a>&gt; <i>latlng</i> )</code></td>
2011-03-24 00:35:29 +08:00
<td><code>this</code></td>
<td>Pans the map to a given center. Makes an animated pan if new center is not more than one screen away from the current one.</td>
</tr>
<tr>
2011-03-28 22:30:18 +08:00
<td><code>panBy( &lt;<a href="#point">Point</a>&gt; <i>point</i> )</code></td>
2011-03-24 00:35:29 +08:00
<td><code>this</code></td>
<td>Pans the map by a given number of pixels (animated).</td>
</tr>
<tr>
2011-04-13 19:50:33 +08:00
<td><code>invalidateSize()</code></td>
2011-04-02 19:54:16 +08:00
<td><code>this</code></td>
2011-04-13 19:50:33 +08:00
<td>Checks if the map container size changed and updates the map if so &mdash; call it after you've changed the map size dynamically.</td>
2011-04-02 19:54:16 +08:00
</tr>
2011-03-24 00:35:29 +08:00
<tr>
2011-04-13 19:50:33 +08:00
<td><code>locate( &lt;Boolean&gt;&nbsp;<i>noAutoFitBounds?</i>&nbsp;)</code></td>
2011-03-24 00:35:29 +08:00
<td><code>this</code></td>
2011-04-13 19:50:33 +08:00
<td>Tries to locate the user using Geolocation API and zooms the map if successful, firing <code>locationfound</code> (with location data) or <code>locationerror</code> event. Set <code>noAutoFitBounds</code> to <code>true</code> if you don't want the map view to be set automatically (<code>false</code> by default).</td>
2011-03-24 00:35:29 +08:00
</tr>
</table>
2011-04-01 21:09:19 +08:00
<h3 id="map-get-methods">Methods that get map state</h3>
2011-03-24 00:35:29 +08:00
<table>
<tr>
<th>Method</th>
<th>Returns</th>
<th>Description</th>
</tr>
<tr>
<td><code>getCenter()</code></td>
2011-03-24 22:18:53 +08:00
<td><code><a href="#latlng">LatLng</a></code></td>
2011-03-24 00:35:29 +08:00
<td>Returns the geographical center of the map view.</td>
</tr>
<tr>
<td><code>getZoom()</code></td>
<td><code>Number</code></td>
<td>Returns the current zoom of the map view.</td>
</tr>
<tr>
<td><code>getMinZoom()</code></td>
<td><code>Number</code></td>
<td>Returns the minimum zoom level of the map.</td>
</tr>
<tr>
<td><code>getMaxZoom()</code></td>
<td><code>Number</code></td>
<td>Returns the maximum zoom level of the map.</td>
</tr>
<tr>
<td><code>getBoundsZoom( &lt;LatLngBounds&gt; <i>bounds</i> )</code></td>
<td><code>Number</code></td>
<td>Returns the maximum zoom level on which the given bounds fit to the map view in its entirety.</td>
</tr>
<tr>
<td><code>getSize()</code></td>
2011-03-28 22:30:18 +08:00
<td><code><a href="#point">Point</a></code></td>
2011-03-24 00:35:29 +08:00
<td>Returns the current size of the map container.</td>
</tr>
<tr>
<td><code>getPixelBounds()</code></td>
<td><code>Bounds</code></td>
<td>Returns the bounds of the current map view in projected pixel coordinates (sometimes useful in layer and overlay implementations).</td>
</tr>
<tr>
<td><code>getPixelOrigin()</code></td>
2011-03-28 22:30:18 +08:00
<td><code><a href="#point">Point</a></code></td>
2011-03-24 00:35:29 +08:00
<td>Returns the projected pixel coordinates of the top left point of the map layer (useful in custom layer and overlay implementations).</td>
</tr>
<tr>
<td><code>getPanes()</code></td>
<td><code>Panes</code></td>
<td>Returns an object for accessing different panes of the map (tile pane, marker pane, etc.).</td>
</tr>
</table>
2011-04-13 19:50:33 +08:00
<h3 id="map-stuff-methods">Methods for layers and controls</h3>
2011-03-24 00:35:29 +08:00
2011-04-13 19:50:33 +08:00
<table>
<tr id="map-addlayer">
<td><code>addLayer( &lt;ILayer&gt;&nbsp;<i>layer</i>&nbsp;)</code></td>
<td><code>this</code></td>
<td>Adds the given layer to the map.</td>
</tr>
<tr>
<td><code>removeLayer( &lt;ILayer&gt;&nbsp;<i>layer</i>&nbsp;)</code></td>
<td><code>this</code></td>
<td>Removes the given layer from the map.</td>
</tr>
<tr id="map-openpopup">
<td><code>openPopup( &lt;<a href="#popup">Popup</a>&gt;&nbsp;<i>popup</i>&nbsp;)</code></td>
<td><code>this</code></td>
<td>Opens the specified popup while closing the previously opened (to make sure only one is opened at one time for usability).</td>
</tr>
<tr id="map-closepopup">
<td><code>closePopup()</code></td>
<td><code>this</code></td>
<td>Closes the popup opened with <a href="#map-openpopup">openPopup</a>.</td>
</tr>
<tr id="map-addcontrol">
<td><code>addControl( &lt;<a href="#icontrol">IControl</a>&gt;&nbsp;<i>control</i>&nbsp;)</code></td>
<td><code>this</code></td>
<td>Adds the given control to the map.</td>
</tr>
<tr>
<td><code>removeControl( &lt;<a href="#icontrol">IControl</a>&gt;&nbsp;<i>control</i>&nbsp;)</code></td>
<td><code>this</code></td>
<td>Removes the given control from the map.</td>
</tr>
</table>
2011-03-24 00:35:29 +08:00
2011-04-01 21:09:19 +08:00
<h3 id="map-conversion-methods">Conversion methods</h3>
2011-03-24 00:35:29 +08:00
<table>
<tr>
<th>Method</th>
<th>Returns</th>
<th>Description</th>
</tr>
2011-03-24 23:08:39 +08:00
<tr>
<td><code>latLngToLayerPoint( &lt;<a href="#latlng">LatLng</a>&gt;&nbsp;<i>latlng</i>&nbsp;)</code></td>
2011-03-28 22:30:18 +08:00
<td><code><a href="#point">Point</a></code></td>
2011-03-24 23:08:39 +08:00
<td>Returns the map layer point that corresponds to the given geographical coordinates (useful for placing overlays on the map).</td>
</tr>
<tr>
2011-03-28 22:30:18 +08:00
<td><code>layerPointToLatLng( &lt;<a href="#point">Point</a>&gt;&nbsp;<i>point</i>&nbsp;)</code></td>
2011-03-24 23:08:39 +08:00
<td><code><a href="#latlng">LatLng</a></code></td>
<td>Returns the geographical coordinates of a given map layer point.</td>
</tr>
2011-03-24 00:35:29 +08:00
<tr>
<td><code>mouseEventToContainerPoint( &lt;MouseEvent&gt;&nbsp;<i>event</i>&nbsp;)</code></td>
2011-03-28 22:30:18 +08:00
<td><code><a href="#point">Point</a></code></td>
2011-03-24 00:35:29 +08:00
<td>Returns the pixel coordinates of a mouse click (relative to the top left corner of the map) given its event object.</td>
</tr>
<tr>
<td><code>mouseEventToLayerPoint( &lt;MouseEvent&gt;&nbsp;<i>event</i>&nbsp;)</code></td>
2011-03-28 22:30:18 +08:00
<td><code><a href="#point">Point</a></code></td>
2011-03-24 23:08:39 +08:00
<td>Returns the pixel coordinates of a mouse click relative to the map layer given its event object.
2011-03-24 00:35:29 +08:00
</tr>
<tr>
<td><code>mouseEventToLatLng( &lt;MouseEvent&gt;&nbsp;<i>event</i>&nbsp;)</code></td>
2011-03-24 22:18:53 +08:00
<td><code><a href="#latlng">LatLng</a></code></td>
2011-03-24 00:35:29 +08:00
<td>Returns the geographical coordinates of the point the mouse clicked on given the click's event object.</td>
</tr>
<tr>
2011-03-28 22:30:18 +08:00
<td><code>containerPointToLayerPoint( &lt;<a href="#point">Point</a>&gt;&nbsp;<i>point</i>&nbsp;)</code></td>
<td><code><a href="#point">Point</a></code></td>
2011-03-24 00:35:29 +08:00
<td>Converts the point relative to the map container to a point relative to the map layer.</td>
</tr>
<tr>
2011-03-28 22:30:18 +08:00
<td><code>layerPointToContainerPoint( &lt;<a href="#point">Point</a>&gt;&nbsp;<i>point</i>&nbsp;)</code></td>
<td><code><a href="#point">Point</a></code></td>
2011-03-24 00:35:29 +08:00
<td>Converts the point relative to the map layer to a point relative to the map container.</td>
</tr>
<tr>
2011-03-24 22:18:53 +08:00
<td><code>project( &lt;<a href="#latlng">LatLng</a>&gt;&nbsp;<i>latlng</i>, &lt;Number&gt;&nbsp;<i>zoom?</i>&nbsp;)</code></td>
2011-03-28 22:30:18 +08:00
<td><code><a href="#point">Point</a></code></td>
2011-03-24 00:35:29 +08:00
<td>Projects the given geographical coordinates to pixel coordinates for the given zoom level (current zoom level by default).</td>
</tr>
<tr>
2011-03-28 22:30:18 +08:00
<td><code>unproject( &lt;<a href="#point">Point</a>&gt;&nbsp;<i>point</i>, &lt;Number&gt;&nbsp;<i>zoom?</i>&nbsp;)</code></td>
2011-03-24 22:18:53 +08:00
<td><code><a href="#latlng">LatLng</a></code></td>
2011-03-24 00:35:29 +08:00
<td>Projects the given pixel coordinates to geographical coordinates for the given zoom level (current zoom level by default).</td>
</tr>
</table>
2011-04-13 20:55:15 +08:00
<h3 id="map-misc-methods">Other methods</h3>
2011-03-24 00:35:29 +08:00
2011-04-13 20:55:15 +08:00
<table>
<tr>
<th>Method</th>
<th>Returns</th>
<th>Description</th>
</tr>
<tr>
<td><code>getContainer()</code></td>
<td><code>HTMLElement</code></td>
<td>Returns the container element of the map.</td>
</tr>
<tr>
<td><code>getPanes()</code></td>
<td><code><a href="#map-panes">MapPanes</a></code></td>
<td>Returns an object with different map panes (to render overlays in).</td>
</tr>
</table>
<h3 id="map-panes">Map panes</h3>
<p>An object literal that contains different map panes that you can use to put your custom overlays in. The difference is mostly in zIndex order that such overlays get.</p>
<table>
<tr>
<th>Property</th>
<th>Type</th>
<th>Description</th>
</tr>
<tr>
<td><code>mapPane</code></td>
<td><code>HTMLElement</code></td>
<td>Pane that contains all other map panes.</td>
</tr>
<tr>
<td><code>tilePane</code></td>
<td><code>HTMLElement</code></td>
<td>Pane for tile layers.</td>
</tr>
<tr>
<td><code>objectsPane</code></td>
<td><code>HTMLElement</code></td>
<td>Pane that contains all the panes except tile pane.</td>
</tr>
<tr>
<td><code>shadowPane</code></td>
<td><code>HTMLElement</code></td>
<td>Pane for overlay shadows (e.g. marker shadows).</td>
</tr>
<tr>
<td><code>overlayPane</code></td>
<td><code>HTMLElement</code></td>
<td>Pane for overlays like polylines and polygons.</td>
</tr>
<tr>
<td><code>markerPane</code></td>
<td><code>HTMLElement</code></td>
<td>Pane for marker icons.</td>
</tr>
<tr>
<td><code>popupPane</code></td>
<td><code>HTMLElement</code></td>
<td>Pane for popups.</td>
</tr>
</table>
2011-04-01 21:09:19 +08:00
<h2 id="marker">L.Marker</h2>
<p>Used to put markers on the map.</p>
<h3>Usage example</h3>
<pre><code class="javascript">var marker = new L.Marker(latlng);
map.addLayer(marker);</code></pre>
<h3>Constructor</h3>
<table>
<tr>
<th>Constructor</th>
<th>Description</th>
</tr>
<tr>
<td><code>L.Marker( &lt;<a href="#latlng">LatLng</a>&gt;&nbsp;<i>latlng</i>, &lt;<a href="#marker-options">Marker&nbsp;options</a>&gt;&nbsp;<i>options?</i> )</code></td>
<td>Instantiates a Marker object given a geographical point and optionally an options object.</td>
</tr>
</table>
<h3 id="marker-options">Options</h3>
<table>
<tr>
<th>Option</th>
<th>Type</th>
<th>Default value</th>
<th>Description</th>
</tr>
<tr>
<td><code>icon</code></td>
<td>Class<br />(<code><a href="#icon">L.Icon</a></code>&nbsp;or&nbsp;its&nbsp;child)</td>
<td><code>L.Icon</code></td>
<td>Icon class to use for rendering the marker. See <a href="#icon">Icon documentation</a> for details on how to customize the marker icon.</td>
</tr>
<tr>
<td><code>clickable</code></td>
<td>Boolean</td>
<td><code>true</code></td>
<td>If false, the marker will not emit mouse events and will act as a part of the underlying map.</td>
</tr>
<tr>
<td><code>draggable</code></td>
<td>Boolean</td>
<td><code>false</code></td>
<td>Whether the marker is draggable with mouse/touch or not.</td>
</tr>
2011-04-01 21:09:19 +08:00
</table>
2011-05-12 23:14:35 +08:00
<h3>Events</h3>
<p>You can subscribe to the following events using <a href="#events">these methods</a>.</p>
<table>
<tr>
<th>Event</th>
<th>Data</th>
<th>Description</th>
</tr>
<tr>
<td><code>click</code></td>
<td><code><a href="#event">Event</a></code>
<td>Fired when the user clicks (or taps) the marker.</td>
</tr>
<tr>
<td><code>dblclick</code></td>
<td><code><a href="#event">Event</a></code>
<td>Fired when the user double-clicks (or double-taps) the marker.</td>
</tr>
</table>
2011-04-01 21:09:19 +08:00
<h3>Methods</h3>
<table>
<tr>
<th>Method</th>
<th>Returns</th>
<th>Description</th>
</tr>
<tr>
<td><code>getLatLng()</code></td>
<td><code><a href="#latlng">LatLng</a></code></td>
<td>Returns the current geographical position of the marker.</td>
</tr>
2011-04-02 19:54:16 +08:00
<tr id="#marker-bindpopup">
<td><code>bindPopup( &lt;String&gt;&nbsp;<i>htmlContent</i>, &lt;<a href="#popup-options">Popup&nbsp;options</a>&gt;&nbsp;<i>options?</i>&nbsp;)</code></td>
<td><code>this</code></td>
<td>Binds a popup with a particular HTML content to a click on this marker. You can also open the bound popup with the Marker <a href="#marker-openpopup">openPopup</a> method.</td>
</tr>
<tr id="#marker-openpopup">
<td><code>openPopup()</code></td>
<td><code>this</code></td>
<td>Opens the popup previously bound by the <a href="#marker-bindpopup">bindPopup</a> method.</td>
</tr>
2011-04-01 21:09:19 +08:00
</table>
<h3 id="marker-interaction-handlers">Interaction handlers</h3>
2011-04-01 21:09:19 +08:00
<p>Interaction handlers are properties of a marker instance that allow you to control interaction behavior in runtime, enabling or disabling certain features such as dragging (see <a href="#ihandler">IHandler</a> methods). Example:</p>
2011-04-01 21:09:19 +08:00
2011-04-12 05:14:01 +08:00
<pre><code class="javascript">marker.dragging.disable();</code></pre>
<table>
<tr>
<th>Property</th>
<th>Type</th>
<th>Description</th>
</tr>
<tr>
2011-04-12 05:14:01 +08:00
<td>dragging</td>
<td><a href="#ihandler">IHandler</a></td>
<td>Marker dragging handler (by both mouse and touch).</td>
</tr>
</table>
2011-04-02 18:58:36 +08:00
2011-04-12 05:14:01 +08:00
2011-04-02 18:58:36 +08:00
<h2 id="popup">L.Popup</h2>
2011-04-02 19:54:16 +08:00
<p>Used to open popups in certain places of the map. Use <a href="#map-openpopup">Map#openPopup</a> to open popups while making sure that only one popup is open at one time (recommended for usability), or use <a href="#map-addlayer">Map#addLayer</a> to open as many as you want.</p>
2011-04-02 18:58:36 +08:00
<h3>Usage example</h3>
2011-04-15 17:20:01 +08:00
<p>If you want to just bind a popup to marker click and then open it, it's really easy:</p>
<pre><code class="javascript">marker.bindPopup(popupContent).openPopup();</code></pre>
<p>Path overlays like polylines also have a <code>bindPopup</code> method. Here's a more complicated way to open a popup on a map:</p>
2011-04-02 18:58:36 +08:00
<pre><code class="javascript">var popupContent = '&lt;p&gt;Hello world!&lt;br /&gt;This is a nice popup.&lt;/p&gt;',
2011-04-15 17:20:01 +08:00
popup = new L.Popup();
popup.setLatLng(latlng);
popup.setContent(popupContent);
2011-04-02 18:58:36 +08:00
map.openPopup(popup);</code></pre>
<h3>Constructor</h3>
<table>
<tr>
<th>Constructor</th>
<th>Description</th>
</tr>
<tr>
2011-04-15 17:20:01 +08:00
<td><code>L.Popup( &lt;<a href="#popup-options">Popup&nbsp;options</a>&gt;&nbsp;<i>options?</i>&nbsp;)</code></td>
2011-04-02 18:58:36 +08:00
<td>Instantiates a Popup object given the geographical point where it will open, the HTML content it will have and optionally an options object.</td>
</tr>
</table>
<h3 id="popup-options">Options</h3>
<table>
<tr>
<th>Option</th>
<th>Type</th>
<th>Default value</th>
<th>Description</th>
</tr>
<tr>
<td><code>maxWidth</code></td>
<td><code>Number</code></td>
<td><code>300</code></td>
<td>Max width of the popup.</td>
</tr>
<tr>
<td><code>autoPan</code></td>
<td><code>Boolean</code></td>
<td><code>true</code></td>
<td>Set it to false if you don't want the map to do panning animation to fit the opened popup.'</td>
</tr>
<tr>
<td><code>closeButton</code></td>
<td><code>Boolean</code></td>
<td><code>true</code></td>
<td>Controls the presense of a close button in the popup.</td>
</tr>
<tr>
<td><code>closeMapOnClick</code></td>
<td><code>Boolean</code></td>
<td><code>true</code></td>
<td>Set it to false if you don't want the popup to close when user clicks the map.</td>
</tr>
<tr>
<td><code>offset</code></td>
<td><code><a href="#point">Point</a></code></td>
<td><code>Point(0,&nbsp;0)</code></td>
<td>The offset of the popup position. Useful to control the anchor of the popup when opening it on some overlays.</td>
</tr>
</table>
2011-04-15 17:20:01 +08:00
<h3>Methods</h3>
<table>
<tr>
<th>Method</th>
<th>Returns</th>
<th>Description</th>
</tr>
<tr>
<td><code>setLatLng( &lt;<a href="#latlng">LatLng</a>&gt;&nbsp;<i>latlng</i>&nbsp;)</code></td>
<td><code>this</code></td>
<td>Sets the geographical point where the popup will open.</td>
</tr>
<tr>
<td><code>setContent( &lt;String&gt;&nbsp;<i>htmlContent</i>&nbsp;)</code></td>
<td><code>this</code></td>
<td>Sets the HTML content of the popup.</td>
</tr>
</table>
2011-04-02 18:58:36 +08:00
2011-04-04 19:57:47 +08:00
<h2 id="tilelayer">L.TileLayer</h2>
<p>Used to load and display tile layers on the map, implements <a href="#ilayer">ILayer</a> interface.</p>
2011-04-06 17:43:50 +08:00
<h3>Usage example</h3>
<pre><code class="javascript">var cloudmadeUrl = 'http://{s}.tile.cloudmade.com/YOUR-API-KEY/997/256/{z}/{x}/{y}.png',
cloudmade = new L.TileLayer(cloudmadeUrl, {maxZoom: 18});</code></pre>
2011-04-04 19:57:47 +08:00
<h3>Constructor</h3>
<table>
<tr>
<th>Constructor</th>
<th>Description</th>
</tr>
<tr>
2011-04-13 20:55:15 +08:00
<td><code>L.TileLayer( &lt;String&gt;&nbsp;<i><a href="#url-template">urlTemplate</a></i>, &lt;<a href="#tilelayer-options">TileLayer&nbsp;options</a>&gt;&nbsp;<i>options?</i>&nbsp;)</code></td>
2011-04-04 19:57:47 +08:00
<td>Instantiates a tile layer object given a <a href="#url-template">URL template</a> and optionally an options object.</td>
</tr>
</table>
<h3 id="url-template">URL template</h3>
<p>A string of the following form:</p>
<pre><code class="javascript">'http://{s}.somedomain.com/blabla/{z}/{x}/{y}.png'</code></pre>
<p><code>{s}</code> means one of the randomly chosen subdomains (their range is specified in options; <code>a</code>, <code>b</code> or <code>c</code> by default, can be omitted), <code>{z}</code> &mdash; zoom level, <code>{x}</code> and <code>{y}</code> &mdash; tile coordinates.</p>
<h3 id="tilelayer-options">Options</h3>
<table>
<tr>
<th>Option</th>
<th>Type</th>
<th>Default value</th>
<th>Description</th>
</tr>
<tr>
<td><code>minZoom</code></td>
<td><code>Number</code></td>
<td><code>0</code></td>
<td>Minimum zoom number.</td>
</tr>
<tr>
<td><code>maxZoom</code></td>
<td><code>Number</code></td>
<td><code>18</code></td>
<td>Maximum zoom number.</td>
</tr>
<tr>
<td><code>tileSize</code></td>
<td><code>Number</code></td>
<td><code>256</code></td>
<td>Tile size (width and height in pixels, assuming tiles are square).</td>
</tr>
<tr>
<td><code>subdomains</code></td>
<td><code>String</code> or <code>String[]</code></td>
<td><code>'abc'</code></td>
<td>Subdomains of the tile service. Can be passed in the form of one string (where each letter is a subdomain name) or an array of strings.</td>
</tr>
<tr>
<td><code>errorTileUrl</code></td>
<td><code>String</code></td>
<td><code>''</code></td>
<td>URL to the tile image to show in place of the tile that failed to load.</td>
</tr>
<tr>
<td><code>attribution</code></td>
<td><code>String</code></td>
<td><code>''</code></td>
<td>e.g. "&copy; CloudMade" &mdash; the string used by the attribution control, describes the layer data.</td>
</tr>
<tr>
<td><code>unloadInvisibleTiles</code></td>
<td><code>Boolean</code></td>
<td>depends</td>
<td>If <code>true</code>, all the tiles that are not visible after panning are removed (for better performance). <code>true</code> by default on mobile WebKit, otherwise <code>false</code>.</td>
</tr>
<tr>
<td><code>updateWhenIdle</code></td>
<td><code>Boolean</code></td>
<td>depends</td>
<td>If <code>false</code>, new tiles are loaded during panning, otherwise only after it (for better performance). <code>true</code> by default on mobile WebKit, otherwise <code>false</code>.</td>
</tr>
</table>
2011-04-06 17:43:50 +08:00
<h2 id="imageoverlay">L.ImageOverlay</h2>
<p>Used to load and display a single image over specific bounds of the map, implements <a href="#ilayer">ILayer</a> interface.</p>
<h3>Usage example</h3>
<pre><code class="javascript">var imageBounds = new L.LatLngBounds(
new L.LatLng(40.712216,-74.22655),
new L.LatLng(40.773941,-74.12544));
var image = new L.ImageOverlay(
"http://www.lib.utexas.edu/maps/historical/newark_nj_1922.jpg", imageBounds);</code></pre>
<h3>Constructor</h3>
<table>
<tr>
<th>Constructor</th>
<th>Description</th>
</tr>
<tr>
<td><code>L.ImageOverlay( &lt;String&gt;&nbsp;<i>imageUrl</i>, &lt;<a href="#latlngbounds">LatLngBounds</a>&gt;&nbsp;<i>bounds</i><!--, &lt;<a href="#imageoverlay-options">ImageOverlay&nbsp;options</a>&gt;&nbsp;<i>options?</i>-->&nbsp;)</code></td>
<td>Instantiates an image overlay object given the URL of the image and the geographical bounds it is tied to.</td>
</tr>
</table>
2011-03-28 22:30:18 +08:00
2011-03-28 20:36:32 +08:00
<h2 id="path">L.Path</h2>
2011-03-24 00:35:29 +08:00
<p>An abstract class that contains options and constants shared between vector overlays (Polygon, Polyline, Circle). Do not use it directly.
<h3 id="path-options">Options</h3>
<table>
<tr>
<th>Option</th>
<th>Type</th>
<th>Default value</th>
<th>Description</th>
</tr>
<tr>
<td><code>stroke</code></td>
<td><code>Boolean</code></td>
<td><code>true</code></td>
<td>Whether to draw stroke along the path. Set it to <code>false</code> to disable borders on polygons or circles.</td>
</tr>
<tr>
<td><code>color</code></td>
<td><code>String</code></td>
<td><code>'#03f'</code></td>
<td>Stroke color.</td>
</tr>
<tr>
<td><code>weight</code></td>
<td><code>Number</code></td>
<td><code>5</code></td>
<td>Stroke width in pixels.</td>
</tr>
<tr>
<td><code>opacity</code></td>
<td><code>Number</code></td>
<td><code>0.5</code></td>
<td>Stroke opacity.</td>
</tr>
<tr>
<td><code>fill</code></td>
<td><code>Boolean</code></td>
<td>depends</td>
<td>Whether to fill the path with color. Set it to <code>false</code> to disable filling on polygons or circles.</td>
</tr>
<tr>
<td><code>fillColor</code></td>
<td><code>String</code></td>
<td>same as color</td>
<td>Fill color.</td>
</tr>
<tr>
<td><code>fillOpacity</code></td>
<td><code>Number</code></td>
<td>0.2</td>
<td>Fill opacity.</td>
</tr>
</table>
2011-05-12 23:14:35 +08:00
<h3>Events</h3>
<p>You can subscribe to the following events using <a href="#events">these methods</a>.</p>
<table>
<tr>
<th>Event</th>
<th>Data</th>
<th>Description</th>
</tr>
<tr>
<td><code>click</code></td>
<td><code><a href="#event">Event</a></code>
<td>Fired when the user clicks (or taps) the object.</td>
</tr>
<tr>
<td><code>dblclick</code></td>
<td><code><a href="#event">Event</a></code>
<td>Fired when the user double-clicks (or double-taps) the object.</td>
</tr>
</table>
2011-03-24 00:35:29 +08:00
<h3>Constants</h3>
<table>
<tr>
<th>Constant</th>
<th>Type</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
2011-04-06 17:43:50 +08:00
<td><code>L.Path.SVG</code></td>
<td><code>Boolean</code></td>
<td>depends</td>
<td>True if SVG is used for vector rendering (true for most modern browsers).</td>
2011-03-24 00:35:29 +08:00
</tr>
<tr>
2011-04-06 17:43:50 +08:00
<td><code>L.Path.VML</code></td>
<td><code>Boolean</code></td>
<td>depends</td>
<td>True if VML is used for vector rendering (IE 6-8).</td>
2011-03-24 00:35:29 +08:00
</tr>
<tr>
2011-04-06 17:43:50 +08:00
<td><code>L.Path.CLIP_PADDING</code></td>
<td><code>Number</code></td>
<td>0.5&nbsp;for&nbsp;SVG<br />0.02&nbsp;for&nbsp;VML</td>
<td>How much to extend the clip area around the map view (relative to its size, e.g. 0.5 is half the screen in each direction). Smaller values mean that you will see clipped ends of paths while you're dragging the map, and bigger values decrease drawing performance.</td>
2011-03-24 00:35:29 +08:00
</tr>
</table>
2011-04-02 19:54:16 +08:00
<h2 id="polyline">L.Polyline</h2>
2011-03-24 00:35:29 +08:00
<p>A class for drawing polyline overlays on a map. Extends Path. Use <a href="#map-addlayer">Map#addLayer</a> to add it to the map.</p>
2011-03-24 22:18:53 +08:00
<h3>Usage example</h3>
<pre><code class="javascript">// create a red polyline from an arrays of LatLng points
var polyline = new L.Polyline(latlngs, {color: 'red'});
// zoom the map to the polyline
map.fitBounds(new L.LatLngBounds(latlngs));
// add the polyline to the map
map.addLayer(polyline);</code></pre>
2011-03-24 00:35:29 +08:00
<h3>Constructor</h3>
<table>
<tr>
<th>Constructor</th>
<th>Description</th>
</tr>
<tr>
2011-03-24 22:18:53 +08:00
<td><code>L.Polyline( &lt;<a href="#latlng">LatLng</a>[]&gt;&nbsp;<i>latlngs</i>, &lt;<a href="#polyline-options">Polyline&nbsp;options</a>&gt;&nbsp;<i>options?</i> )</code></td>
2011-03-24 00:35:29 +08:00
<td>Instantiates a polyline object given an array of geographical points and optionally an options object.</td>
</tr>
</table>
<h3 id="polyline-options">Options</h3>
2011-03-28 23:37:24 +08:00
<p>You can use <a href="#path-options">Path options</a> and additionally the following options:</p>
2011-03-24 00:35:29 +08:00
<table>
<tr>
<th>Option</th>
<th>Type</th>
<th>Default value</th>
<th>Description</th>
</tr>
<tr>
<td><code>smoothFactor</code></td>
<td><code>Number</code></td>
<td><code>1.0</code></td>
<td>How much to simplify the polyline on each zoom level. More means better performance and smoother look, and less means more accurate representation.</td>
</tr>
<tr>
<td><code>noClip</code></td>
<td><code>Boolean</code></td>
<td><code>false</code></td>
<td>Disabled polyline clipping.</td>
</tr>
</table>
2011-04-02 19:54:16 +08:00
<h2 id="polygon">L.Polygon</h2>
2011-03-24 00:35:29 +08:00
<p>A class for drawing polygon overlays on a map. Extends Polyline. Use <a href="#map-addlayer">Map#addLayer</a> to add it to the map.</p>
<h3>Constructor</h3>
<table>
<tr>
<th>Constructor</th>
<th>Description</th>
</tr>
<tr>
2011-03-24 22:18:53 +08:00
<td><code>L.Polygon( &lt;<a href="#latlng">LatLng</a>[]&gt;&nbsp;<i>latlngs</i>, &lt;<a href="#polyline-options">Polyline&nbsp;options</a>&gt;&nbsp;<i>options?</i> )</code></td>
2011-03-24 00:35:29 +08:00
<td>Instantiates a polygon object given an array of geographical points and optionally an options object (the same as for Polyline).</td>
</tr>
</table>
2011-04-02 19:54:16 +08:00
<h2 id="circle">L.Circle</h2>
2011-03-24 00:35:29 +08:00
<p>A class for drawing circle overlays on a map. Extends Path. Use <a href="#map-addlayer">Map#addLayer</a> to add it to the map.</p>
<h3>Constructor</h3>
<table>
<tr>
<th>Constructor</th>
<th>Description</th>
</tr>
<tr>
2011-03-24 22:18:53 +08:00
<td><code>L.Circle( &lt;<a href="#latlng">LatLng</a>&gt;&nbsp;<i>latlng</i>, &lt;Number&gt;&nbsp;<i>radius</i>, &lt;<a href="#path-options">Path&nbsp;options</a>&gt;&nbsp;<i>options?</i> )</code></td>
2011-03-24 00:35:29 +08:00
<td>Instantiates a polygon object given an geographical point, a radius in pixels and optionally an options object.</td>
</tr>
</table>
2011-03-28 22:30:18 +08:00
2011-04-01 21:09:19 +08:00
<h2 id="latlng">L.LatLng</h2>
<p>Represents a geographical point with a certain latitude and longitude.</p>
<pre><code class="javascript">var latlng = new L.LatLng(50.5, 30.5);</code></pre>
<h3>Constructor</h3>
<table>
<tr>
<th>Constructor</th>
<th>Description</th>
</tr>
<tr>
<td><code>L.LatLng( &lt;Number&gt;&nbsp;<i>latitude</i>, &lt;Number&gt;&nbsp;<i>longitude</i>, &lt;Boolean&gt;&nbsp;<i>noWrap?</i> )</code></td>
<td>Creates a LatLng object with the given latitude and longitude. Wraps longitude to lie between -180 and 180 and clamps longitude between -90 and 90 by default &mdash; you can disable this with the noWrap argument.</td>
</tr>
</table>
<h3>Properties</h3>
<table>
<tr>
<th>Property</th>
<th>Type</th>
<th>Description</th>
</tr>
<tr>
<td><code>lat</code></td>
<td><code>Number</code></td>
<td>Latitude in degrees.</td>
</tr>
<tr>
<td><code>lng</code></td>
<td><code>Number</code></td>
<td>Longitude in degrees.</td>
</tr>
</table>
<h3>Methods</h3>
<table>
<tr>
<th>Method</th>
<th>Returns</th>
<th>Description</th>
</tr>
<tr>
<td><code>equals( &lt;<a href="#latlng">LatLng</a>&gt;&nbsp;<i>otherLatlng</i>&nbsp;)</code></td>
<td><code>Boolean</code></td>
<td>Returns true if the given LatLng point is at the same position (within a small margin of error).</td>
</tr>
<tr>
<td><code>toString()</code></td>
<td><code>String</code></td>
<td>Returns a string representation of the point (for debugging purposes).</td>
</tr>
</table>
<h3>Constants</h3>
<table>
<tr>
<th>Constant</th>
<th>Type</th>
<th>Value</th>
<th>Description</th>
</tr>
<tr>
<td><code>DEG_TO_RAD</code></td>
<td><code>Number</code></td>
<td><code>Math.PI / 180</code></td>
<td>A multiplier for converting degrees into radians.</td>
</tr>
<tr>
<td><code>RAD_TO_DEG</code></td>
<td><code>Number</code></td>
<td><code>180 / Math.PI</code></td>
<td>A multiplier for converting radians into degrees.</td>
</tr>
<tr>
<td><code>MAX_MARGIN</code></td>
<td><code>Number</code></td>
<td><code>1.0E-9</code></td>
<td>Max margin of error for the equality check.</td>
</tr>
</table>
2011-04-06 17:43:50 +08:00
<h2 id="latlngbounds">L.LatLngBounds</h2>
<p>Represents a rectangular geographical area on a map.</p>
<pre><code class="javascript">var southWest = new L.LatLng(40.712,-74.227),
northEast = new L.LatLng(40.774,-74.125),
bounds = new L.LatLngBounds(southWest, northEast);</code></pre>
<h3>Constructor</h3>
<table>
<tr>
<th>Constructor</th>
<th>Description</th>
</tr>
<tr>
<td><code>L.LatLngBounds( &lt;<a href="#latlng">LatLng</a>&gt;&nbsp;<i>southWest</i>, &lt;<a href="#latlng">LatLng</a>&gt;&nbsp;<i>northEast</i>&nbsp;)</code></td>
<td>Creates a LatLngBounds object by defining south-west and north-east corners of the rectangle.</td>
</tr>
<tr>
<td><code>L.LatLngBounds( &lt;<a href="#latlng">LatLng</a>[]&gt;&nbsp;<i>latlngs</i>&nbsp;)</code></td>
<td>Creates a LatLngBounds object defined by the geographical points it contains. Very useful for zooming the map to fit a particular set of locations with <a href="#map-fitbounds">fitBounds</a>.</td>
</tr>
</table>
<h3>Methods</h3>
<table>
<tr>
<th>Method</th>
<th>Returns</th>
<th>Description</th>
</tr>
<tr>
<td><code>extend( &lt;<a href="#latlng">LatLng</a>&gt;&nbsp;<i>latlng</i>&nbsp;)</code></td>
<td>-</td>
<td>Extends the bounds to contain the given LatLng point.</td>
</tr>
<tr>
<td><code>getSouthWest()</code></td>
<td><code><a href="#latlng">LatLng</a></code></td>
<td>Returns the south-west point of the bounds.</td>
</tr>
<tr>
<td><code>getNorthEast()</code></td>
<td><code><a href="#latlng">LatLng</a></code></td>
<td>Returns the north-east point of the bounds.</td>
</tr>
<tr>
<td><code>getNorthWest()</code></td>
<td><code><a href="#latlng">LatLng</a></code></td>
<td>Returns the north-west point of the bounds.</td>
</tr>
<tr>
<td><code>getSouthEast()</code></td>
<td><code><a href="#latlng">LatLng</a></code></td>
<td>Returns the south-east point of the bounds.</td>
</tr>
<tr>
<td><code>getCenter()</code></td>
<td><code><a href="#latlng">LatLng</a></code></td>
<td>Returns the center point of the bounds.</td>
</tr>
<tr>
<td><code>contains( &lt;<a href="#latlngbounds">LatLngBounds</a>&gt;&nbsp;<i>otherBounds</i>&nbsp;)</code></td>
<td><code>Boolean</code></td>
<td>Returns <code>true</code> if the rectangle contains the given one.</td>
</tr>
</table>
2011-04-01 21:09:19 +08:00
2011-03-28 22:30:18 +08:00
<h2 id="point">L.Point</h2>
<p>Represents a point with x and y coordinates in pixels.
<h3>Constructor</h3>
<table>
<tr>
<th>Constructor</th>
<th>Description</th>
</tr>
<tr>
<td><code>L.Point( &lt;Number&gt;&nbsp;<i>x</i>, &lt;Number&gt;&nbsp;<i>y</i> )</code></td>
<td>Creates a Point object with the given x and y coordinates.</td>
</tr>
</table>
<h3>Properties</h3>
<table>
<tr>
<th>Property</th>
<th>Type</th>
<th>Description</th>
</tr>
<tr>
<td><code>x</code></td>
<td><code>Number</code></td>
<td>The x coordinate.</td>
</tr>
<tr>
<td><code>y</code></td>
<td><code>Number</code></td>
<td>The y coordinate.</td>
</tr>
</table>
<h3>Methods</h3>
<table>
<tr>
<th>Method</th>
<th>Returns</th>
<th>Description</th>
</tr>
<tr>
<td><code>add( &lt;<a href="#point">Point</a>&gt;&nbsp;<i>otherPoint</i>&nbsp;)</code></td>
<td><code><a href="#point">Point</a></code></td>
<td>Returns the result of addition of the current and the given points.</td>
</tr>
<tr>
<td><code>subtract( &lt;<a href="#point">Point</a>&gt;&nbsp;<i>otherPoint</i>&nbsp;)</code></td>
<td><code><a href="#point">Point</a></code></td>
<td>Returns the result of subtraction of the given point from the current.</td>
</tr>
<tr>
<td><code>multiplyBy( &lt;Number&gt;&nbsp;<i>number</i>&nbsp;)</code></td>
<td><code><a href="#point">Point</a></code></td>
<td>Returns the result of multiplication of the current point by the given number.</td>
</tr>
<tr>
<td><code>divideBy( &lt;Number&gt;&nbsp;<i>number</i>&nbsp;)</code></td>
<td><code><a href="#point">Point</a></code></td>
<td>Returns the result of division of the current point by the given number.</td>
</tr>
<tr>
<td><code>distanceTo( &lt;<a href="#point">Point</a>&gt;&nbsp;<i>otherPoint</i>&nbsp;)</code></td>
<td><code>Number</code></td>
<td>Returns the distance between the current and the given points.</td>
</tr>
<tr>
<td><code>clone()</code></td>
<td><code><a href="#point">Point</a></code></td>
<td>Returns a copy of the current point.</td>
</tr>
<tr>
<td><code>round()</code></td>
<td><code><a href="#point">Point</a></code></td>
<td>Returns a copy of the current point with rounded coordinates.</td>
</tr>
<tr>
<td><code>toString()</code></td>
<td><code>String</code></td>
<td>Returns a string representation of the point for debugging purposes.</td>
</tr>
</table>
2011-04-13 20:55:15 +08:00
2011-04-15 06:23:44 +08:00
<h2 id="bounds">L.Bounds</h2>
<p>Represents a rectangular area in pixel coordinates.</p>
<pre><code class="javascript">var p1 = new L.Point(10, 10),
p2 = new L.Point(40, 60),
bounds = new L.Bounds(p1, p2);</code></pre>
<h3>Constructor</h3>
<table>
<tr>
<th>Constructor</th>
<th>Description</th>
</tr>
<tr>
<td><code>L.Bounds( &lt;<a href="#point">Point</a>&gt;&nbsp;<i>topLeft</i>, &lt;<a href="#point">Point</a>&gt;&nbsp;<i>bottomRight</i>&nbsp;)</code></td>
<td>Creates a Bounds object by defining top-left and bottom-right coordinates of the rectangle.</td>
</tr>
<tr>
<td><code>L.LatLngBounds( &lt;<a href="#point">Point</a>[]&gt;points&nbsp;)</code></td>
<td>Creates a Bounds object defined by the points it contains.</td>
</tr>
</table>
<h3>Properties</h3>
<table>
<tr>
<th>Property</th>
<th>Type</th>
<th>Description</th>
</tr>
<tr>
<td><code>min</code></td>
<td><code><a href="#point">Point</a></code>
<td>The top left corner of the rectangle.</td>
</tr>
<tr>
<td><code>max</code></td>
<td><code><a href="#point">Point</a></code>
<td>The bottom right corner of the rectangle.</td>
</tr>
</table>
<h3>Methods</h3>
<table>
<tr>
<th>Method</th>
<th>Returns</th>
<th>Description</th>
</tr>
<tr>
<td><code>extend( &lt;<a href="#point">Point</a>&gt;&nbsp;<i>point</i>&nbsp;)</code></td>
<td>-</td>
<td>Extends the bounds to contain the given point.</td>
</tr>
<tr>
<td><code>getCenter()</code></td>
<td><code><a href="#point">Point</a></code></td>
<td>Returns the center point of the bounds.</td>
</tr>
<tr>
<td><code>contains( &lt;<a href="#bounds">Bounds</a>&gt;&nbsp;<i>otherBounds</i>&nbsp;)</code></td>
<td><code>Boolean</code></td>
<td>Returns <code>true</code> if the rectangle contains the given one.</td>
</tr>
</table>
2011-04-13 20:55:15 +08:00
<h2 id="control-zoom">L.Control.Zoom</h2>
<p>A basic zoom control with two buttons (zoom in and zoom out). It is put on the map by default unless you set its <code>zoomControl</code> option to <code>false</code>. Implements <a href="#icontrol">IControl</a> interface.</p>
<h3>Constructor</h3>
<table>
<tr>
<th>Constructor</th>
<th>Description</th>
</tr>
<tr>
<td><code>L.Control.Zoom()</code></td>
<td>Creates a zoom control.</td>
</tr>
</table>
2011-04-15 19:46:55 +08:00
<h2 id="control-attribution">L.Control.Attribution</h2>
<p>The attribution control allows you to display attribution data in a small text box on a map. It is put on the map by default unless you set its <code>attributionControl</code> option to <code>false</code>, and it fetches attribution texts from layers with <code>getAttribution</code> method automatically. Implements <a href="#icontrol">IControl</a> interface.</p>
<h3>Constructor</h3>
<table>
<tr>
<th>Constructor</th>
<th>Description</th>
</tr>
<tr>
<td><code>L.Control.Attribution()</code></td>
<td>Creates an attribution control.</td>
</tr>
</table>
<h3>Methods</h3>
<table>
<tr>
<th>Method</th>
<th>Returns</th>
<th>Description</th>
</tr>
<tr>
<td><code>setPrefix( &lt;String&gt;&nbsp;<i>prefix</i>&nbsp;)</code></td>
<td>-</td>
<td>Sets the string before the attributions ("Powered by Leaflet" by default).</td>
</tr>
<tr>
<td><code>addAttribution( &lt;String&gt;&nbsp;<i>text</i>&nbsp;)</code></td>
<td>-</td>
<td>Adds an attribution text (e.g. "Vector data &amp;copy; CloudMade").</td>
</tr>
<tr>
<td><code>removeAttribution( &lt;String&gt;&nbsp;<i>text</i>&nbsp;)</code></td>
<td>-</td>
<td>Removes an attribution text.</td>
</tr>
</table>
2011-04-13 20:55:15 +08:00
2011-05-12 22:21:47 +08:00
2011-05-12 23:02:15 +08:00
<h2 id="events">Events methods</h2>
2011-05-12 22:21:47 +08:00
2011-05-12 23:02:15 +08:00
<p>A set of methods shared between event-powered classes (like Map). Generally, events allow you to execute some function when something happens with an object (e.g. the user clicks on the map, causing the map 'fire' event).</p>
2011-05-12 22:21:47 +08:00
<h3>Example</h3>
<pre><code class="javascript">map.on('click', function(e) {
alert(e.latlng);
});</code></pre>
<h3>Methods</h3>
<table>
<tr>
<th>Method</th>
<th>Returns</th>
<th>Description</th>
</tr>
<tr>
<td><code>addEventListener( &lt;String&gt;&nbsp;<i>type</i>, &lt;Function&gt;&nbsp;<i>fn</i>, &lt;Object&gt;&nbsp;<i>context?</i>&nbsp;)</code></td>
<td><code>this</code></td>
<td>Adds a listener function (<code>fn</code>) to a particular event type of the object. You can optionally specify the context of the listener (object the <code>this</code> keyword will point to).</td>
</tr>
<tr>
<td><code>removeEventListener( &lt;String&gt;&nbsp;<i>type</i>, &lt;Function&gt;&nbsp;<i>fn</i>, &lt;Object&gt;&nbsp;<i>context?</i>&nbsp;)</code></td>
<td><code>this</code></td>
<td>Removes a previously added listener function.</td>
</tr>
<tr>
<td><code>on( &hellip;&nbsp;)</code></td>
<td><code>this</code></td>
<td>Alias to <code>addEventListener</code>.</td>
</tr>
<tr>
<td><code>off( &hellip;&nbsp;)</code></td>
<td><code>this</code></td>
<td>Alias to <code>removeEventListener</code>.</td>
</tr>
<tr>
<td><code>hasListeners( &lt;String&gt;&nbsp;<i>type</i>&nbsp;)</code></td>
<td><code>Boolean</code></td>
<td>Returns true if a particular event type has some listeners attached to it.</td>
</tr>
<tr>
<td><code>fireEvent( &lt;String&gt;&nbsp;<i>type</i>, &lt;Object&gt;&nbsp;<i>data?</i>&nbsp;)</code></td>
<td><code>this</code></td>
<td>Fires an event of the specified type. You can optionally provide an data object &mdash; the first argument of the listener function will contain its properties.</td>
</tr>
<tr>
<td><code>fire( &hellip;&nbsp;)</code></td>
<td><code>this</code></td>
<td>Alias to <code>fireEvent</code>.</td>
</tr>
</table>
2011-05-12 23:02:15 +08:00
<h2 id="event-objects">Event objects</h2>
<p>Event object is an object that you recieve as an argument in a listener function when some event is fired, containing useful information about that event. For example:</p>
<pre><code class="javascript">map.on('click', function(e) {
alert(e.latlng); // e is an event object (MouseEvent in this case)
});</code></pre>
<h3 id="event">Event</h3>
<p>The base event object. All other event objects contain these properties too.</p>
<table>
<tr>
<th>property</th>
<th>type</th>
<th>description</th>
</tr>
<tr>
<td><code>type</code></td>
<td><code>String</code></td>
<td>The event type (e.g. "click").</td>
</tr>
<tr>
<td><code>target</code></td>
<td><code>Object</code></td>
<td>The object that fired the event.</td>
</tr>
</table>
<h3 id="mouse-event">MouseEvent</h3>
<table>
<tr>
<th>property</th>
<th>type</th>
<th>description</th>
</tr>
<tr>
<td><code>latlng</code></td>
<td><code><a href="#latlng">LatLng</a></code></td>
<td>The geographical point where the mouse event occured.</td>
</tr>
<tr>
<td><code>layerPoint</code></td>
<td><code><a href="#point">Point</a></code></td>
<td>Pixel coordinates of the point where the mouse event occured relative to the map layer.</td>
</tr>
</table>
<h3 id="location-event">LocationEvent</h3>
<table>
<tr>
<th>property</th>
<th>type</th>
<th>description</th>
</tr>
<tr>
<td><code>latlng</code></td>
<td><code><a href="#latlng">LatLng</a></code></td>
<td>Detected geographical location of the user.</td>
</tr>
<tr>
<td><code>bounds</code></td>
<td><code><a href="#latlngbounds">LatLngBounds</a></code></td>
<td>Geographical bounds of the area user is located in (with respect to the accuracy of location).</td>
</tr>
<tr>
<td><code>accuracy</code></td>
<td><code>Number</code></td>
<td>Accuracy of location in meters.</td>
</tr>
</table>
<h3 id="layer-event">LayerEvent</h3>
<table>
<tr>
<th>property</th>
<th>type</th>
<th>description</th>
</tr>
<tr>
<td><code>layer</code></td>
<td><code><a href="#ilayer">ILayer</a></code></td>
<td>The layer that was added or removed.</td>
</tr>
</table>
<!-- <h3>TileEvent</h3> -->
2011-05-12 22:21:47 +08:00
2011-03-28 22:30:18 +08:00
2011-04-01 21:09:19 +08:00
<h2 id="ihandler">IHandler</h2>
<p>An interface implemented by <a href="#map-interaction-handlers">interaction handlers</a>.</p>
2011-03-28 22:30:18 +08:00
<table>
<tr>
<th>Method</th>
<th>Returns</th>
<th>Description</th>
</tr>
<tr>
2011-04-01 21:09:19 +08:00
<td><code>enable()</code></td>
<td>-</td>
<td>Enables the handler.</td>
2011-03-28 22:30:18 +08:00
</tr>
<tr>
2011-04-01 21:09:19 +08:00
<td><code>disable()</code></td>
<td>-</td>
<td>Disables the handler.</td>
2011-03-28 22:30:18 +08:00
</tr>
<tr>
2011-04-01 21:09:19 +08:00
<td><code>enabled()</code></td>
<td><code>Boolean</code></td>
<td>Returns true if the handler is enabled.</td>
2011-03-28 22:30:18 +08:00
</tr>
</table>
2011-04-01 21:09:19 +08:00
2011-05-12 23:02:15 +08:00
2011-03-24 00:35:29 +08:00
<hr />
2011-03-24 20:02:42 +08:00
<p class="quiet">&copy; 2011 <a href="http://cloudmade.com">CloudMade</a>. Map data &copy; 2011 <a href="http://openstreetmap.org">OpenStreetMap</a> contributors, <a href="http://creativecommons.org/licenses/by-sa/2.0/">CC-BY-SA</a>.</p>
2011-03-24 00:35:29 +08:00
</div>
2011-03-24 20:02:42 +08:00
<a href="http://github.com/CloudMade/Leaflet"><img id="forkme" src="http://s3.amazonaws.com/github/ribbons/forkme_right_darkblue_121621.png" alt="Fork me on GitHub" /></a>
2011-03-24 00:35:29 +08:00
<script>
hljs.tabReplace = ' ';
hljs.initHighlightingOnLoad();
</script>
</body>
</html>