MDN self-hosted library · e01.org

HTMLGeolocationElement: location event

HTML DOM

HTML DOM

The location event of the 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 addEventListener():

addEventListener("location", (event) => { })

Alternatively, assign to the event handler property of the interface:

onlocation = (event) => { }

Event type

An 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 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 HTMLGeolocationElement.error property and log the error message to the console.

See the main HTMLGeolocationElement page for a full walkthrough of this example.

Specifications

Browser compatibility

See also

  • geolocation element