Dom Geolocation : Objet Geolocation.getCurrentPosition

La méthode javascript getCurrentPosition

Définition

La méthode javascript getCurrentPosition(successCallback, errorCallback, Options) de l'objet Geolocation va vous permettre de faire un appel pour récupérer la position de géolocalisation de l'appareil mais pas de suivre sa position, pour cela utilisez la méthode watchPosition().
Si tout se passe bien, c'est le successCallback qui est lancé, dans le cas inverse c'est errorCallback qui est lancé.

Exemple de code :
function PositionCallback(Position){
  alert(Position.coords.latitude);
}
function PositionErrorCallback(PositionError){
  switch(PositionError.code) {
    case PositionError.TIMEOUT:
      alert("Timeout !");
    break;
    case PositionError.PERMISSION_DENIED:
      alert("Vous n’avez pas donné la permission");
    break;
    case PositionError.POSITION_UNAVAILABLE:
      alert("La position n’a pu être déterminée");
    break;
    case PositionError.UNKNOWN_ERROR:
      alert("Erreur inconnue");
    break;
  }
}
var PositionOptions = {timeout:Infinity};

//Exemple avec les trois paramètres :
var id = geolocation.getCurrentPosition(PositionCallback, PositionErrorCallback, PositionOptions )
//Exemple avec les deux paramètres :
var id = geolocation.getCurrentPosition(PositionCallback, PositionErrorCallback)

Paramètres de getCurrentPosition

Paramètres

La méthode javascript getCurrentPosition(PositionCallback, PositionErrorCallback, PositionOptions ) de l'objet Geolocation accepte trois paramètres :
- PositionCallback : fonction (avec comme paramètre Position).
- PositionErrorCallback : fonction (avec comme paramètre PositionError), paramètre optionnel.
- PositionOptions : objet PositionOptions, paramètre optionnel.

Valeur retournée de getCurrentPosition

Valeur retournée

La méthode getCurrentPosition() de l'objet javascript Geolocation ne renvoie aucune valeur.