HTMLGeolocationElement: location event
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("HTML DOM")}}{{SeeCompatTable}}
The **location** event of the {{domxref("HTMLGeolocationElement")}} interface is fired whenever the browser receives location data, or error information when a location data request was unsuccessful.
Syntax
Use the event name in {{domxref("EventTarget/addEventListener", "addEventListener()")}}:
addEventListener("location", (event) => { })Alternatively, assign to the event handler property of the interface:
onlocation = (event) => { }Event type
An {{domxref("Event")}}.
Examples
Using location to respond to location data and errors
In our Embedded map demo (source code), we use a location event handler to respond to location data and errors being received:
geo.addEventListener("location", () => {
if (geo.position) {
console.log(
`${geo.position.coords.latitude},${geo.position.coords.longitude}`,
);
drawMap(geo.position.coords.latitude, geo.position.coords.longitude, geo);
} else if (geo.error) {
console.log(geo.error.message);
}
});If location data is returned successfully, we access it via the {{domxref("HTMLGeolocationElement.position")}} property, and retrieve the latitude and longitude values. We log those to the console, then plot them on a map by passing them into the drawMap() function along with a reference to the HTMLGeolocationElement object. If the data request fails, we access the error via the {{domxref("HTMLGeolocationElement.error")}} property and log the error message to the console.
See the main {{domxref("HTMLGeolocationElement")}} page for a full walkthrough of this example.
Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- {{htmlelement("geolocation")}} element