Esri Leaflet: An Introduction
Allan Laframboise
slides.com/alaframboise
Agenda
- Leaflet
- Esri Leaflet
- Plugins
Leaflet
Small, simple, light-weight JavaScript mapping library
Library, not a Framework
Open Source
Extensible
What can you do with it?
- Display map tiles
- Zoom and pan
- Render markers and layers (GeoJSON)
- Symbolize and color layers (CSS)
- Show popups
- Handle events
- ...
What do you need?
- Basemap (url to tiles)
- GeoJSON (data)
How to get started?
<!DOCTYPE html>
<html>
<head>
<title>Leaflet Quick Start Guide Example</title>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<!-- Load Leaflet from CDN-->
<link rel="stylesheet" href="http://cdn.leafletjs.com/leaflet-0.7.5/leaflet.css" />
</head>
<body>
<div id="map" style="position: absolute; top: 0; bottom: 0; left: 0; right: 0;"></div>
<script src="http://cdn.leafletjs.com/leaflet-0.7.5/leaflet.js"></script>
<script>
var map = L.map('map').setView([45.548, -122.632], 11);
L.tileLayer('http://{s}.tile.osm.org/{z}/{x}/{y}.png', {
attribution: '© <a href="http://osm.org/copyright">OpenStreetMap</a> contributors'
}).addTo(map);
</script>
</body>
</html>
Leaflet Plugins
Esri Leaflet
Plugin for accessing ArcGIS Services
ArcGIS Online and Server Services
What can you do with it?
- Display ArcGIS basemaps and tiles
- Zoom and pan
- Render FeatureLayers (vector layers)
- Symbolize and color layers
- Show popups with feature attributes
- Handle events
- ...
What else can you do?
- Make requests to ArcGIS REST Services
- Tasks: Query, Find, Identify...
- Get Time-based data
- Convert ArcGIS JSON to GeoJSON
- Fetch feature collections
- ...
How does it work?
How do you get started?
<!-- Load Esri Leaflet from CDN -->
<script src="//cdn.jsdelivr.net/leaflet.esri/1.0.0/esri-leaflet.js"></script>
<script>
var map = L.map('map').setView([45.548, -122.632], 11);
L.esri.basemapLayer('Streets').addTo(map);
</script>
Basemap
<script>
L.esri.featureLayer({
url: 'http://services.arcgis.com/uCXeTVveQzP4IIcx/arcgis/rest/services/PDX_Neighborhoods_Styled/FeatureServer/0'
}).addTo(map);
</script>
FeatureLayer
Styling
var layer = L.esri.featureLayer({
url: 'http://services.arcgis.com/uCXeTVveQzP4IIcx/arcgis/rest/services/PDX_Neighborhoods_Styled/FeatureServer/0',
style: function (feature) {
if(feature.properties.TOTPOP_CY < 1000){
return {color: 'green', weight: 2 };
} else if(feature.properties.TOTPOP_CY > 1000 && feature.properties.TOTPOP_CY < 10000){
return { color: 'yellow', weight: 2 };
} else if(feature.properties.TOTPOP_CY > 10000) {
return { color: 'red', weight: 2 };
}
}
});
layer.addTo(map);
Esri Leaflet Plugins
Renderers
<!-- Load Esri Leaflet Renderers -->
<script src="//cdn-geoweb.s3.amazonaws.com/esri-leaflet-renderers/0.0.1-beta.3/esri-leaflet-renderers.js"></script>
L.esri.featureLayer({
url: 'http://services.arcgis.com/uCXeTVveQzP4IIcx/arcgis/rest/services/PDX_Neighborhoods_Styled/FeatureServer/0'
}).addTo(map);
Popups
var layer = L.esri.featureLayer({
url: 'http://services.arcgis.com/uCXeTVveQzP4IIcx/arcgis/rest/services/PDX_Neighborhoods_Styled/FeatureServer/0'});
layer.bindPopup(function (feature) {
return L.Util.template('<p><b>{NAME}</b><br>POPULATION: {TOTPOP_CY}</p>',
feature.properties);
});
layer.addTo(map);
Geocoder
<link rel="stylesheet" href="//cdn.jsdelivr.net/leaflet.esri.geocoder/1.0.2/esri-leaflet-geocoder.css">
<script src="//cdn.jsdelivr.net/leaflet.esri.geocoder/1.0.2/esri-leaflet-geocoder.js"></script>
...
var searchControl = L.esri.Geocoding.Controls.geosearch().addTo(map);
var results = L.layerGroup().addTo(map);
searchControl.on('results', function(data){
results.clearLayers();
for (var i = data.results.length - 1; i >= 0; i--) {
results.addLayer(L.marker(data.results[i].latlng));
}
});
Geoprocessing
<script src="//cdn.jsdelivr.net/leaflet.esri.gp/1.0.2/esri-leaflet-gp.js"></script>
...
var gpService = L.esri.GP.Services.geoprocessing({
url: "http://sampleserver1.arcgisonline.com/ArcGIS/rest/services/Network/ESRI_DriveTime_US/GPServer/CreateDriveTimePolygons",
useCors:false
});
var gpTask = gpService.createTask();
gpTask.setParam("Drive_Times", "1 3 5");
var driveTimes = L.featureGroup();
map.addLayer(driveTimes);
layer.bindPopup(function (feature) {
return L.Util.template("<p><b>{NAME}</b><br>POPULATION: {TOTPOP_CY}</p><a href='#' onclick='getDriveTime(" + feature.id + ");'>Show Drive Times</a>", feature.properties);
});
function getDriveTime(id) {
var f = layer.getFeature(id);
driveTimes.clearLayers();
gpTask.setParam("Input_Location", f._popup._latlng)
gpTask.run(driveTimeCallback);
}
function driveTimeCallback(error, response, raw){
driveTimes.addLayer(L.geoJson(response.Output_Drive_Time_Polygons));
}
What's not there?
- Deep integration with ArcGIS
- Visual controls (ArcGIS JS Dijits)
- Limited geometry operations
- Smart mapping
- Vector tiles (v2.0) and 3D
- Support for projected data (v2.0)
- ArcGIS Web AppBuilder & Templates
- Webmap support
- Dojo
Roadmap
- Plugins
- esri-leaflet-demographic-layer
- esri-leaflet-routing
- Esri-Leaflet 2.0
- Support for Leaflet 1.0
- Vector tile support
- Layer ordering
- Handling of large number of shapes
Need more help?
What's next?
- Deeper dive into the codebase
- Debugging
- Contributing code
- More plugins...
Thank you!
Allan Laframboise
Esri Leaflet: An Introduction
By alaframboise
Esri Leaflet: An Introduction
- 3,213