Géocodeur

Affiche l'adresse d'un utilisateur, en fonction de l'emplacement physique de ce dernier ou convertit les coordonnées de latitude et de longitude en une adresse. Cet élément doit être utilisé conjointement avec les vues Carte, API OpenLayers et Géolocalisation.

Comme la vue Géolocalisation, la vue Géocodeur 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.

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();

     //Get physical address of user

     var geoCoder = page.ui.get("Geo_Coder1");
     geoCoder.requestAddressLookup(location.latitude, 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 geoCoder = page.ui.get("Geo_Coder1"): Cette fonction trouve l'emplacement géographique pour permettre la communication avec lui.
geoCoder.requestAddressLookup(location.latitude, location.longitude): Cette fonction utilise la méthode requestAddressLookup pour inférer l'adresse de l'utilisateur à partir des valeurs des paramètres location.latitude et location.longitude.

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

Evénements

Vous pouvez définir ou modifier des gestionnaires d'événements pour la vue dans l'onglet Evénements. Vous pouvez définir des événements à déclencher par programmation ou lorsqu'un utilisateur interagit avec la vue. Pour plus d'informations sur la manière de définir et de coder des événements, voir Evénements définis par l'utilisateur.

Pour la vue Géocodeur, vous pouvez activer les gestionnaires d'événements suivants :

lors du chargement de la page, par exemple
lorsque l'emplacement est demandé, par exemple
lorsque l'emplacement est résolu, par exemple
lorsqu'une erreur se produit lors de l'extraction de l'emplacement, par exemple

Méthodes

Pour plus d'informations sur les méthodes disponibles pour le codeur de géo, voir l'API JavaScript du codeur de géo .

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.