W3cubDocs

/DOM

Geolocation

Secure context
This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

The Geolocation interface represents an object able to programmatically obtain the position of the device. It gives Web content access to the location of the device. This allows a Web site or app to offer customized results based on the user's location.

An object with this interface is obtained using the navigator.geolocation property implemented by the Navigator object.

Note: For security reasons, when a web page tries to access location information, the user is notified and asked to grant permission. Be aware that each browser has its own policies and methods for requesting this permission.

Properties

The Geolocation interface neither implements, nor inherits any property.

Methods

The Geolocation interface doesn't inherit any method.

Geolocation.getCurrentPosition() Secure context
Determines the device's current location and gives back a Position object with the data.
Geolocation.watchPosition() Secure context
Returns a long value representing the newly established callback function to be invoked whenever the device location changes.
Geolocation.clearWatch() Secure context
Removes the particular handler previously installed using watchPosition().

Specifications

Specification Status Comment
Geolocation API Recommendation Initial specification.

Browser compatibilityUpdate compatibility data on GitHub

Desktop
Chrome Edge Firefox Internet Explorer Opera Safari
Basic support 5 12 3.5
3.5
GPSD (GPS daemon) support added in Firefox 3.6. WiFi-based location is provided by Google (privacy) or a custom provider (MLS instructions).
 9 16
16
10.6 — 15
5
Secure context required 50 ? 55 No 37 Yes
clearWatch 5 Yes 3.5 9 16
16
10.6 — 15
Yes
getCurrentPosition 5 Yes 3.5 9 16
16
10.6 — 15
Yes
watchPosition 5 Yes 3.5 9 16
16
10.6 — 15
Yes
Mobile
Android webview Chrome for Android Edge Mobile Firefox for Android Opera for Android iOS Safari Samsung Internet
Basic support Yes Yes 12 4 15 Yes Yes
Secure context required 51
51
Secure context is only required for applications targeting Android Nougat (7) and higher. See bug 603574.
 50 ? 55 37 Yes ?
clearWatch Yes Yes Yes 4 15 Yes Yes
getCurrentPosition Yes Yes Yes 4 15 Yes Yes
watchPosition Yes ? Yes 4 15 Yes Yes

See also

Edit this page on MDN

© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Geolocation