/leaflet-layerJSON

Build dynamic JSON Layer via Ajax/JSONP with caching

Primary LanguageJavaScript

Leaflet JSON Layer

Simple way for transform any JSON data source in a Leaflet Layer!

A Dynamic Leaflet Layer that load JSON data in layer in the form of markers with attributes

and minimize remote requests with caching system

Tested in Leaflet 0.7 and 1.1

Options

Option Data Description
url String remote url
jsonpParam String callback parameter name for jsonp request append to url
jsonpParam String callback parameter name for jsonp request append to url
callData String custom function for data source, params: (req: url
Filtering
propertyItems String json property used contains data items
propertyLoc String json property used as Latlng of marker, if is array: ['lat','lon'] select double fields
locAsGeoJSON String interpret location data as [lon, lat] value pair instead of [lat, lon]
propertyTitle String json property used as title in marker
filterData String function for pre-filter data
Rendering
dataToMarker String function that will be used for creating markers from json points
onEachMarker String function called on each marker created, similar to option onEachFeature of L.GeoJSON
layerTarget String pre-existing layer to add markers(L.LayerGroup, L.MarkerClusterGroup)
buildPopup String function popup builder
optsPopup String popup options
buildIcon String function icon builder
Caching
minShift String min shift for update data(in meters)
precision String number of digit send to server for lat,lng precision
updateOutBounds String request new data only if current bounds higher than last bounds

Events

Event Data Description
'dataloading' {req: url bbox}
'dataloaded' {data: json} fired on ajax/jsonp request success

Usage

var l = new L.LayerJSON({url: "search.php?lat1={lat1}&lat2={lat2}&lon1={lon1}&lon2={lon2}" });
map.addLayer(l);

Where

Demos:

http://labs.easyblog.it/maps/leaflet-layerjson

Source:

Github
Bitbucket
NPM
Atmosphere

Build

This plugin support Grunt for building process. Therefore the deployment require NPM installed in your system.

After you've made sure to have npm working, run this in command line:

npm install
grunt