leaflet-globe-minimap
v0.0.4-rev2.0
Published
A L.Control plugin for Leaflet that provides a 3d globe minimap in the corner of the map view.
Downloads
13
Maintainers
Readme
Leaflet.GlobeMiniMap
Leaflet.GlobeMiniMap is a simple minimap control that places a 3d Globe in the corner of your map, centered on the same location as the main map.
Try the example out out now on github pages
Using the GlobeMiniMap control
Leaflet.GlobeMiniMap requires d3.js & topojson.js. You can load them from a CDN like this:
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/leaflet/1.9.3/leaflet.css" integrity="sha512-mD70nAW2ThLsWH0zif8JPbfraZ8hbCtjQ+5RU1m4+ztZq6/MymyZeB55pWsi4YAX+73yvcaJyk61mzfYMvtm9w==" crossorigin="anonymous" referrerpolicy="no-referrer" />
<script src="https://cdnjs.cloudflare.com/ajax/libs/d3/3.5.5/d3.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/topojson/1.6.19/topojson.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/leaflet/1.9.3/leaflet.js" integrity="sha512-Dqm3h1Y4qiHUjbhxTuBGQsza0Tfppn53SHlu/uj1f+RT+xfShfe7r6czRf5r2NmllO2aKx+tYJgoxboOkn1Scg==" crossorigin="anonymous" referrerpolicy="no-referrer"></script>
Node doesnt need leaflet 1.9 just works with it.
The library is also looking for /data/world.json
in order to load the world topojson file. You can use the option topojsonSrc
to define another source.
Add the globe minimap with one line of code:
var miniMap = new L.Control.GlobeMiniMap(options).addTo(map);
You can pass in an options object to define colors for the water, land and marker on the globe minimap:
{
land:'#FFFF00',
water:'#3333FF',
marker:'#000000',
topojsonSrc: 'path/to/world.json',
durations: 1250, // use to control how snapy the animation is
width: 82, // the size, as of now they must be same as height
height: 82, // maybe we should renam radius and have one options
onAdd: null, // calback functions for listners
onRemove: null,
}
The minimap is reactive, it only changes when the main map's center point changes. You can't interact with the mini map to move the main map.
Attribution
I saw this static 3d minimap and thought it would be a great plugin for leaflet. Static 3d Minimap
The globe is built with d3, and is based on World Tour an excellent block by Mike Bostock.
The code for the plugin was modified from Leaflet.MiniMap by Robert Nordon
The marker SVG on the minimap is from fontawesome via wikimedia.org
Issues / todo
- Need a smooth resize animation.
- need rotation support
- need a way of mapping the pointer location on the globe to a latlon.
Please report issues on github. I am a noob at this plugin business, and am not sure if the /dist and build stuff is working properly, so advice and Pull Requests are welcome!