HTMLGeolocationElement: position property
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The position read-only property of the HTMLGeolocationElement interface returns a GeolocationPosition object representing the user's position, in the event of successful location data retrieval.
The retrieved position may or may not be up to date. The user's position will only be retrieved once when the <geolocation> element's button control is pressed, unless you set the watch attribute to true, in which case a new position will be retrieved each time the user's device moves. To read the user's current position, you should read the position property in response to the location event firing.
If location data retrieval fails, associated error information will be available in the HTMLGeolocationElement.error property.
Value
A GeolocationPosition object, or null if location data retrieval failed or data has not yet been retrieved.
Examples
Basic usage
<geolocation autolocate></geolocation>
const geo = document.querySelector("geolocation");
geo.addEventListener("location", () => {
if (geo.position) {
console.log(
`(${geo.position.coords.latitude},${geo.position.coords.longitude})`,
);
} else if (geo.error) {
console.log(geo.error.message);
}
});
See our Embedded map example walkthrough for a real-world example that includes position.
Specifications
| Specification |
|---|
| The HTML Geolocation Element # dom-htmlgeolocationelement-position |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
position
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
- Experimental. Expect behavior to change in the future.
See also
<geolocation>element