API Geolocation (golocalisation)

Baseline Large disponibilit

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.

En savoir plus
Voir la compatibilit complte

Contexte scuris: Cette fonctionnalit est uniquement disponible dans des contextes scuriss (HTTPS), pour certains navigateurs qui la prennent en charge.

L'API Geolocation permet une personne, si elle le veut, de fournir sa position gographique une application web. Pour respecter la vie prive, la permission est demande auprs de l'utilisatrice ou de l'utilisateur avant la rcupration des informations de golocalisation.

Les extensions web qui souhaitent utiliser l'objet Geolocation doivent ajouter la permission geolocation leur manifeste. Le systme d'exploitation demandera alors la personne la permission d'accder l'emplacement lors de la premire fois.

Concepts et utilisation

On souhaite parfois utiliser les informations gographiques d'une personne, par exemple pour indiquer son emplacement sur une carte, ou pour afficher des informations pertinentes par rapport au lieu actuel.

L'API Geolocation s'utilise en appelant navigator.geolocation. Cela va dclencher la demande de permission avec le navigateur. Lorsque la permission est donne d'accder aux donnes de golocalisation, le navigateur utilisera le meilleur outil sa disposition sur l'appareil pour dterminer cette position (par exemple, le GPS).

La position gographique peut alors tre utilise dans le code avec :

Geolocation.getCurrentPosition(): Qui rcupre l'emplacement actuel de l'appareil.
Geolocation.watchPosition(): Qui enregistre une fonction de rappel qui sera appele chaque fois que l'emplacement volue, en renvoyant la position jour.

Dans les deux cas, ces mthodes utilisent jusqu' trois arguments :

Une fonction de rappel obligatoire pour les cas de succs.
- Si la rcupration des informations d'emplacement s'est droule sans problme, la fonction de rappel est appele avec un seul paramtre qui est un objet GeolocationPosition qui fournit un accs aux donnes d'emplacement.
Une fonction de rappel optionnelle pour les cas d'erreur.
- Si la rcupration des informations d'emplacement a chou, la fonction de rappel est appele avec un seul paramtre qui est un objet GeolocationPositionError qui fournit des informations sur l'erreur.
Un objet optionnel qui fournit des options pour la rcupration des donnes d'emplacement.

Pour plus d'informations sur l'utilisation de cette API, nous vous conseillons de lire le guide Utiliser l'API Geolocation.

Interfaces

Geolocation: Il s'agit de la classe principale de cette API. Elle contient des mthodes pour rcuprer la position actuelle, suivre les modifications de position, arrter de suivre les dplacements.
GeolocationPosition: Reprsente la position d'une personne. Une instance de GeolocationPosition est renvoye lors d'un appel russi l'une des mthodes de Geolocation, dans une fonction de rappel de russite. Il contient un horodatage et une instance de GeolocationCoordinates.
GeolocationCoordinates: Reprsente les coordonnes de la position d'une personne. Une instance de GeolocationCoordinates contient les informations de latitude, longitude et d'autres informations importantes relatives l'emplacement.
GeolocationPositionError: Un objet GeolocationPositionError est renvoy par un des appels infructueux l'une des mthodes de Geolocation, dans une fonction de rappel en cas d'erreur. Il contient un code d'erreur et un message.
Navigator.geolocation: Le point d'entre pour cette API. Elle renvoie une instance de Geolocation partir de laquelle on peut accder aux autres fonctionnalits.

Exemples

Voir le guide Utiliser l'API Geolocation pour un exemple de code.

Spcifications

Spcification
Geolocation # geolocation_interface

Compatibilit des navigateurs

Disponibilit

Comme la dtermination de l'emplacement partir des rseaux Wi-Fi souvent fournie par Google, l'API Geolocation de base pourrait tre indisponible en Chine. Auquel cas, vous pouvez utiliser des fournisseurs tiers comme Baidu, Autonavi, ou Tencent. Ces services utilisent l'adresse IP de la personne et/ou une application locale pour dterminer l'emplacement.

Voir aussi

Aider amliorer MDN

Cette page vous a-t-elle t utile ?

Oui Non

Apprendre contribuer

Cette page a t modifie le 3 aot 2023 par les contributeurices du MDN.

Voir cette page sur GitHub Signaler un problme avec ce contenu