Skip to content

Latest commit

 

History

History
71 lines (45 loc) · 2.27 KB

README.md

File metadata and controls

71 lines (45 loc) · 2.27 KB

Leaflet.Control.Compass

npm version

A leaflet control plugin to make simple rotating compass

If this project helped your work help me to keep this alive by Paypal DONATION ❤

Tested in Leaflet 0.7 and 1.2

require HTML5 API on mobile device!

Try the Demo online here:
opengeo.tech/maps/leaflet-compass

Tested platforms:

this project needs many tests on different devices, please help us using the demo page and report problems by opening an issue.

  • Chrome on Android
  • Safari on iOS

Image

Usage

Adding the Compass Control to the map:

map.addControl( new L.Control.Compass() );

Options

Option Default Description
autoActive false activate control at startup
showDigit false show angle value bottom compass
textErr '' error message on alert notification
callErr null function that run on compass error activating
angleOffset 2 min angle deviation before rotate, big angleOffset is need for device have noise in orientation sensor
position 'topright' position of control inside map

Methods

Method Arguments Description
autoActive false activate control at startup
getAngle return Azimut angle
setAngle angle set rotation compass
activate active tracking on runtime
deactivate deactive tracking on runtime

Events

Event Data Description
'compass:rotated' angle fired after compass data is rotated
'compass:disabled' fired when compass is disabled

Where

Source code:

Github
NPM