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

js
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 rappel error soit appelé. Si cette propriété vaut 0, la fonction d'erreur ne sera jamais appelée.
  • enableHighAccuracy : un booléen qui indique si une précision élevée est requise.

Exemples

js
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

BCD tables only load in the browser

Voir aussi