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 : propriété position

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.

La propriété en lecture seule position de l'interface HTMLGeolocationElement retourne un objet GeolocationPosition représentant la position de l'utilisateur·ice, en cas de récupération réussie des données de localisation.

La position récupérée peut être ou non à jour. La position de l'utilisateur·ice ne sera récupérée qu'une seule fois lorsque le bouton de contrôle de l'élément <geolocation> est pressé, sauf si vous définissez l'attribut watch sur true, auquel cas une nouvelle position sera récupérée chaque fois que l'appareil de l'utilisateur·ice se déplace. Pour lire la position actuelle de l'utilisateur·ice, vous devez lire la propriété position en réponse au déclenchement de l'évènement location.

Si la récupération des données de localisation échoue, les informations d'erreur associées seront disponibles dans la propriété HTMLGeolocationElement.error.

Valeur

Un objet GeolocationPosition, ou null si la récupération des données de localisation a échoué ou si les données n'ont pas encore été récupérées.

Exemples

Exemple simple

html
<geolocation autolocate></geolocation>
js
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);
  }
});

Voir notre exemple détaillé de carte intégrée pour un exemple réel incluant position.

Spécifications

Specification
Unknown specification
# dom-htmlgeolocationelement-position

Compatibilité des navigateurs

Voir aussi