Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
Geolocation.getCurrentPosition()
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 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
Positioncomme argument. errorFacultatif-
Une fonction de rappel qui prend un objet
PositionErrorcomme argument. optionsFacultatif-
Un objet
PositionOptionsoptionnel. 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 rappelerrorsoit 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> |
Compatibilité des navigateurs
Chargement...