Geolocation.getCurrentPosition()
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
(en-US) comme argument. error
Facultatif- Une fonction de rappel qui prend un objet
PositionError
(en-US) 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
Spécification | État | Commentaires |
---|---|---|
Geolocation API | Recommendation | Spécification initiale. |
Compatibilité des navigateurs
BCD tables only load in the browser