Localisation géographique

Affiche l'emplacement d'un utilisateur sur une carte au lieu d'un emplacement statique. Cette vue peut être utilisée en association avec les vues Carte et API OpenLayers.

Vous pouvez utiliser cette vue en association avec les vues Carte et API OpenLayers. Cependant, l'API OpenLayers pourrait ne pas être nécessaire, selon le périphérique. Le contenu de l'objet de localisation et la précision de ces mesures dépendent du périphérique sur lequel l'interface utilisateur s'exécute. Quel que soit le périphérique, une latitude et une longitude doivent être disponibles via cet objet. L'emplacement est une variable contextuelle disponible dans l'événement On Location Resolved de cette vue.

Pour que cette vue fonctionne, elle doit être connectée à un réseau de données, tel qu'un réseau mobile, wifi, Ethernet ou similaire. En l'absence de connexion, la vue ne fonctionne pas. En tant que fonction de sécurité intégrée au navigateur, la page demande l'autorisation d'accéder aux informations de localisation de l'utilisateur.

Comme la vue Géocodeur, la vue Géolocalisation ajoute une autre couche d'information en permettant aux utilisateurs de voir où ils se trouvent sur une carte. Vous pouvez l'utiliser pour fournir un point de référence. Pour plus d'efficacité, placez d'abord la vue API OpenLayers en haut de la page ou, à tout le moins, avant la vue Carte. Pour plus d'informations, voir Carte et APIOpenLayers.

Propriétés de configuration

Les propriétés de configuration de la vue Géolocalisation sont répertoriées dans le tableau ci-dessous :

Tableau 1. Propriétés de configuration du contrôle Géolocalisation
Propriété de configuration	Description	Type de données
Mode de surveillance	Modes de surveillance de la vue: Une fois en charge, Continu, Initialement arrêté.	`GeoMonitoringMode`
Précision élevée	Si vous sélectionnez cette option, la détection de localisation est plus précise mais utilise plus de batterie.	`Boolean`
Timeout	Vous pouvez entrer le nombre de millisecondes après quoi le périphérique cesse d'essayer de détecter l'emplacement spécifié. La valeur par défaut est 6000 ms.	`Integer`
Ancienneté maximale des données	Vous pouvez entrer, en millisecondes, les données de géolocalisation les plus anciennes que vous acceptez. La valeur par défaut est 0 ms.	`Integer`

Exemple

Dans cet exemple, vous sélectionnez une clé d'API pour une carte, localisez et affichez une adresse, personnalisez l'aspect de la carte et communiquez l'emplacement à la carte.

Utilisez la vue API OpenLayers pour spécifier une clé d'API.
Utilisez la vue Géolocalisation pour trouver l'emplacement de l'utilisateur et l'afficher sur la carte.
Utilisez la vue Géocodeur pour afficher une adresse physique sur une vue de texte, comme Remarque, Texte en sortie, Texte ou autres.
Ajoutez la vue Carte à la page et ajustez les propriétés d'apparence au besoin.

Ajoutez une vue Code HTML personnalisé pour que la vue Carte communique les coordonnées à la carte.

<script>
  function updateLocation(me, location){
     var map = page.ui.get("Map1");

     //Setting the center of the map and adding a marker
     map.setCenter(location.latitude, location.longitude);
     map.addMarker();

     // <optional> Printing the Coordinates to the Coordinates field 
     var coordinates= page.ui.get("Coordinates");
     coordinates.setText("Latitude: " + location.latitude +" "+"Longitude: "+

     location.longitude );
  }
</script>

Ce code HTML se présente comme suit.

function updateLocation(me, location): Cette fonction est appelée par la vue Géolocalisation. Le paramètre me fait référence à Geo_Location1 et transmet des informations de localisation.
var map = page.ui.get("Map1"): Cette fonction trouve la carte pour permettre la communication avec elle.
map.setCenter(location.latitude, location.longitude): Cette fonction utilise les informations de localisation qui ont été transmises pour définir le centre de la carte à partir des valeurs des paramètres location.latitude et location.longitude.
map.addMarker(): Cette fonction ajoute un marqueur à la position centrée.
var coordinates= page.ui.get("Coordinates"): Cette fonction récupère la zone de texte Coordonnées.
coordinates.setText("Latitude: " + location.latitude +" "+"Longitude: "+ location.longitude ): Cette fonction définit la zone de texte sur les coordonnées trouvées.

Le résultat montre l'emplacement de l'utilisateur comme indiqué dans la carte suivante.

Méthodes

Pour plus d'informations sur les méthodes disponibles pour le contrôle Géolocalisation, voir l'API Géolocalisation JavaScript .

Ressources supplémentaires

Pour plus d'informations sur la création d'un coach ou d'une page, voir Génération de coaches.
Pour plus d'informations sur les propriétés standard (Général, Configuration, Positionnement, Visibilitéet Attributs HTML), voir Afficher les propriétés.

Pour plus d'informations sur les vues géographiques associées, voir Géolocalisation, Carteet APIOpenLayers.