The Geolocation Object

Geolocation Object

The Geolocation object allows the user to provide their location to web applications. For privacy reasons, the user is asked for permission to report location information.

Note: This feature is available only in secure contexts (HTTPS).

Note: Geolocation is most accurate for devices with GPS, like iPhone.

The Geolocation API is published through the navigator.geolocation object.

Geolocation Object Properties

Property Description
coordinates Returns the position and altitude of the device on Earth
position Returns the position of the concerned device at a given time
positionError Returns the reason of an error occurring when using the geolocating device
positionOptions Describes an object containing option properties to pass as a parameter of Geolocation.getCurrentPosition() and Geolocation.watchPosition()

Geolocation Object Methods

Method Description
clearWatch() Unregister location/error monitoring handlers previously installed using Geolocation.watchPosition()
getCurrentPosition() Returns the current position of the device
watchPosition() Returns a watch ID value that then can be used to unregister the handler by passing it to the Geolocation.clearWatch() method