Geolocation.getCurrentPosition()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Contexte sécurisé: Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.
La méthode Geolocation.getCurrentPosition()
fournit la position actuelle de l'appareil.
Syntaxe
navigator.geolocation.getCurrentPosition(success[, error[, [options]])
Paramètres
success
-
Une fonction de rappel qui prend un objet
Position
comme argument. error
Facultatif-
Une fonction de rappel qui prend un objet
PositionError
comme argument. options
Facultatif-
Un objet
PositionOptions
optionnel. Les options décrites par cet objet sont :maximumAge
: un entier qui exprime une durée en millisecondes ou l'infini pour indiquer la durée maximale pendant laquelle mettre en cache la position.timeout
: un entier qui exprime la durée, en millisecondes, avant que la fonction de rappelerror
soit appelé. Si cette propriété vaut0
, la fonction d'erreur ne sera jamais appelée.enableHighAccuracy
: un booléen qui indique si une précision élevée est requise.
Exemples
var options = { enableHighAccuracy: true, timeout: 5000, maximumAge: 0, }; function success(pos) { var crd = pos.coords; console.log("Votre position actuelle est :"); console.log(`Latitude : ${crd.latitude}`); console.log(`Longitude : ${crd.longitude}`); console.log(`La précision est de ${crd.accuracy} mètres.`); } function error(err) { console.warn(`ERREUR (${err.code}): ${err.message}`); } navigator.geolocation.getCurrentPosition(success, error, options);
Spécifications
Specification |
---|
Geolocation # getcurrentposition-method |