-
Notifications
You must be signed in to change notification settings - Fork 21
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
2 changed files
with
133 additions
and
2 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,6 +1,6 @@ | ||
| { | ||
| "name": "Leaflet.autolayers", | ||
| "tagline": "A dynamic leaflet layers control that pulls from multiple mapservers and manages basemaps and overlays plus order", | ||
| "body": "# Leaflet.AutoLayers\r\nA dynamic leaflet layers control that pulls from multiple mapservers and manages basemaps and overlays plus order\r\n", | ||
| "body": "# Leaflet.AutoLayers\r\n\r\nA dynamic leaflet layers control that pulls from multiple mapservers and manages basemaps and overlays plus their order.\r\n\r\n## Getting Started\r\n\r\nSee [this demo page](http://aebadirad.github.io/Leaflet.AutoLayers/example/index.html) for an example.\r\n\r\n### Configuration Breakdown\r\n\r\nThe configuration is an object that is passed in as the first signature on the method call (L.control.autolayers()). The second is the standard Layers options object which is optional.\r\n\r\nList of possible configuration keys:\r\n* overlays: OPTIONAL - standard built control layers object as built statically [here](http://leafletjs.com/examples/layers-control.html)\r\n* baseLayers: OPTIONAL - standard built control layers object as built statically [here](http://leafletjs.com/examples/layers-control.html)\r\n* selectedBasemap: RECOMMENDED - determines which baselayer gets selected first by layer 'name'\r\n* selectedOverlays: OPTIONAL - determines which overlays are auto-selected on load\r\n* mapServers: OPTIONAL - but this is kind of the whole point of this plugin\r\n * url: REQUIRED - the base url of the service (e.g. http://services.arcgisonline.com/arcgis/rest/services)\r\n * baseLayers: RECOMMENDED - tells the control what layers to place in base maps, else all from this server go into overlays\r\n * dictionary: REQUIRED - where the published service list dictionary is (e.g. http://services.arcgisonline.com/arcgis/rest/services?f=pjson)\r\n * tileUrl: REQUIRED - the part that comes after the layer name in the tileserver with xyz coords placeholders (e.g. /MapServer/tile/{z}/{y}/{x} or /{z}/{x}/{y}.png)\r\n * name: REQUIRED - the name of the server, or however you want to identify the source\r\n * type: REQUIRED - current options: esri or nrltileserver\r\n * whitelist: OPTIONAL - ONLY display these layers, matches against both baselayers and overlays. Do not use with blacklist.\r\n * blacklist: OPTIONAL - DO NOT display these layers, matches against both baselayers and overlays. Do not use with whitelist.\r\n\r\n### Prerequisities\r\n\r\n1. A recent browser (IE 10 or later, Firefox, Safari, Chrome etc)\r\n2. [Leaflet](https://github.com/Leaflet/Leaflet) mapping library\r\n\r\nThat's it! It has its own built in ajax and comes bundled with x2js, you can drop both of these for your own with some slight modifications.\r\n\r\n### Installing\r\n\r\n1. Clone\r\n2. Include leaflet-autolayers.js and the accompanying css/images in your project where appropriate\r\n3. Create your configuration and place L.control.autolayers(config).addTo(map) where you have your map implemented\r\n4. And that's it!\r\n\r\n\r\nSample Configuration that pulls from the public ArcGIS and Navy Research Labs tileservers:\r\n```\r\n var config = {\r\n overlays: overlays, //custom overlays group that are static\r\n baseLayers: baseLayers, //custom baselayers group that are static\r\n selectedBasemap: 'Streets', //selected basemap when it loads\r\n selectedOverlays: [\"ASTER Digital Elevation Model 30M\", \"ASTER Digital Elevation Model Color 30M\", \"Cities\"], //which overlays should be on by default\r\n mapServers: [{\r\n \"url\": \"http://services.arcgisonline.com/arcgis/rest/services\",\r\n \"dictionary\": \"http://services.arcgisonline.com/arcgis/rest/services?f=pjson\",\r\n \"tileUrl\": \"/MapServer/tile/{z}/{y}/{x}\",\r\n \"name\": \"ArcGIS Online\",\r\n \"type\": \"esri\",\r\n \"baseLayers\": [\"ESRI_Imagery_World_2D\", \"ESRI_StreetMap_World_2D\", \"NGS_Topo_US_2D\"],\r\n \"whitelist\": [\"ESRI_Imagery_World_2D\", \"ESRI_StreetMap_World_2D\", \"NGS_Topo_US_2D\"]\r\n }, {\r\n \"url\": \"http://geoint.nrlssc.navy.mil/nrltileserver\",\r\n \"dictionary\": \"http://geoint.nrlssc.navy.mil/nrltileserver/wms?REQUEST=GetCapabilities&VERSION=1.1.1&SERVICE=WMS\",\r\n \"tileUrl\": \"/{z}/{x}/{y}.png\",\r\n \"name\": \"Navy NRL\",\r\n \"type\": \"nrltileserver\",\r\n \"baseLayers\": [\"bluemarble\", \"Landsat7\", \"DTED0_GRID_COLOR1\", \"ETOPO1_COLOR1\", \"NAIP\", \"DRG_AUTO\"],\r\n \"blacklist\": [\"BlackMarble\"]\r\n }]\r\n };\r\n\r\n```\r\n\r\n## Deployment\r\n\r\nMake sure all your layers you include are of the same projection. Currently map projection redrawing based on baselayer is not implemented, so if you don't have matching layer projections, things will not line up properly.\r\n\r\n\r\nNote: because of the nature of not all browsers supporting ES6 and not always having jQuery, the default calls provided are SYNCHRONOUS and therefore will cause delay in loading the map as it waits for each server to respond with its list of layers.\r\n\r\n\r\nIf you have a build environment that supports promises (angular, ember, react or jquery framework), you can do two things:\r\n\r\n1. Replace the builtin ajax function with a deferred/promise supported call.\r\n2. Pull out the code that does the calls and simply build the baselayers/overlays object and pass it in with blank mapservers entries in the config. This will have the same effect and you'll still get all the layer management capabilities.\r\n\r\n## Contributing\r\n\r\nContributions, especially for other map servers or enhancements welcome.\r\n\r\n## Versioning\r\nFor now it's going to remain in beta until the Leaflet 1.0.0 release. After that time a standard version 1.x will begin.\r\n\r\n## Authors\r\n\r\n* **Alex Ebadirad** - *Initial work* - [aebadirad](https://github.com/aebadirad)\r\n\r\n## License\r\n\r\nThis project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details\r\n\r\n## Acknowledgments\r\n\r\n* [Houston Engineering, INC](www.heigeo.com) for the simple ajax utility\r\n* [x2js](https://github.com/abdmob/x2js) for parsing the WMS response to json\r\n", | ||
| "note": "Don't delete this file! It's used internally to help with page regeneration." | ||
| } |