Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

HTMLGeolocationElement : évènement location

Expérimental: Il s'agit d'une technologie expérimentale.
Vérifiez attentivement le tableau de compatibilité des navigateurs avant de l'utiliser en production.

L'évènement location de l'interface HTMLGeolocationElement est déclenché chaque fois que le navigateur reçoit des données de localisation, ou des informations d'erreur lorsque la demande de données de localisation a échoué.

Syntaxe

Utilisez le nom de l'évènement dans des méthodes comme addEventListener(), ou définissez une propriété gestionnaire d'évènement.

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

onlocation = (event) => { }

Type d'évènement

Un objet Event.

Exemples

Utiliser location pour réagir aux données de localisation et aux erreurs

Dans notre démonstration de carte intégrée (angl.) (code source (angl.)), nous utilisons un gestionnaire d'évènement location pour réagir à la réception des données de localisation et des erreurs :

js
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);
  }
});

Si les données de localisation sont retournées avec succès, nous accédons à la propriété HTMLGeolocationElement.position et récupérons les valeurs de latitude et de longitude. Nous les affichons dans la console, puis les traçons sur une carte en les passant à la fonction drawMap() avec une référence à l'objet HTMLGeolocationElement. Si la demande de données échoue, nous accédons à l'erreur par la propriété HTMLGeolocationElement.error et affichons le message d'erreur dans la console.

Voir la page principale HTMLGeolocationElement pour une explication complète de cet exemple.

Spécifications

Specification
Unknown specification
# dom-htmlgeolocationelement-onlocation

Compatibilité des navigateurs

Voir aussi