Leaflet-providers
Leaflet-providers
An extension to Leaflet that contains configurations for various free tile providers.
Usage
Leaflet-providers providers are refered to with a provider[.<variant>]
-string. Let’s say you want to add the nice Watercolor style from Stamen to your map, you pass Stamen.Watercolor
to the L.tileLayer.provider
-constructor, which will return a L.TileLayer instance for Stamens Watercolor tile layer.
// add Stamen Watercolor to map.
L.tileLayer.provider('Stamen.Watercolor').addTo(map);
Protocol relativity (https://
-urls)
Leaflet-providers tries to use https://
if the page uses https://
and the provider supports it.
You can force the use of http://
by passing force_http: true
in the options argument.
Providers
Leaflet-providers provides tile layers from different providers, including OpenStreetMap, MapQuestOpen, Stamen, Esri and OpenWeatherMap. The full listing of free to use layers can be previewed. The page will show you the name to use with leaflet-providers.js
and the code to use it without dependencies.
Providers requiring registration
In addition to the providers you are free to use, we support some layers which require registration.
HERE (formerly Nokia).
In order to use HERE layers, you must register. Once registered, you can create an app_id
and app_code
which you have to pass to L.tileLayer.provider
in the options:
L.tileLayer.provider('HERE.terrainDay', {
app_id: '<insert ID here>',
app_code: '<insert ID here>'
}).addTo(map);
Mapbox
In order to use Mapbox maps, you must register. If your user name is YourName
and your map is called MyMap
you can add it with:
L.tileLayer.provider('MapBox.YourName.MyMap');
Esri/ArcGIS
In order to use ArcGIS maps, you must register and abide by the terms of service. No special syntax is required.
Attribution
This work was inspired from https://gist.github.com/1804938, and originally created by Stefan Seelmann.