CarteAffichePosition (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Carte

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

CarteAffichePosition (Fonction)

En anglais : MapDisplayPosition

Centre la carte affichée dans un champ Carte sur une position géographique ou un lieu donné. Une animation est automatiquement réalisée.

A la fin de l'animation, l'événement "A chaque changement de position" du champ Carte sera exécuté. Si le positionnement sur la carte est annulé par l'utilisateur avant la fin de l'animation, cet événement ne sera pas exécuté.

Remarque : Cette fonction est disponible dans l'émulateur Android et dans le simulateur Android.

Exemple

Voir des exemples supplémentaires

// Centre la carte affichée par le champ "CARTE_Position" sur une position géographique
MaPosition est une géoPosition
CarteAffichePosition(CARTE_Position, MaPosition)

// Syntaxe équivalente (sans animation) : CARTE_Position = MaPosition

// Centre la carte affichée par le champ "CARTE_Position" sur une ville à partir de son nom
CarteAffichePosition(CARTE_Position, "Montpellier, France")

// Centre la carte affichée par le champ "CARTE_Position" sur un monument à partir de son nom
CarteAffichePosition(CARTE_Position, "Tour Eiffel")

Syntaxe

Afficher une position géographique Masquer les détails

<Résultat> = CarteAffichePosition(<Champ Carte> , <Position>)

<Résultat> : Booléen

Vrai si la carte a pu être positionnée sur la position spécifiée,
Faux dans le cas contraire. Pour plus de détails sur l'erreur, utilisez la fonction ErreurInfo.
<Résultat> est toujours à Vrai, même en cas d'erreur. Il n'est pas possible de savoir si le positionnement a bien été effectué.

<Champ Carte> : Nom de champ

Nom du champ Carte à manipuler. Si ce paramètre correspond à une chaîne vide (""), le champ Carte auquel appartient l'événement en cours sera utilisé.

<Position> : Variable de type géoPosition ou chaîne de caractères

Description du lieu sur lequel sera centrée la carte. Cette description peut correspondre :
au nom de la variable de type géoPosition décrivant la position géographique sur laquelle sera centrée la carte.
à une chaîne de caractères contenant une adresse, une ville, le nom d'un monument, ...
L'usage d'une chaîne de caractères peut entraîner une position incohérente via le service de cartographie de Bing Map.
à une variable de type Adresse.

Afficher une position géographique avec procédure de vérification Masquer les détails

CarteAffichePosition(<Champ Carte> , <Position> [, <Procédure WLangage>])

<Champ Carte> : Nom de champ

Nom du champ Carte à manipuler. Si ce paramètre correspond à une chaîne vide (""), le champ Carte auquel appartient l'événement en cours sera utilisé.

<Position> : Variable de type géoPosition ou chaîne de caractères

Description du lieu sur lequel sera centrée la carte. Cette description peut correspondre :
au nom de la variable de type géoPosition décrivant la position géographique sur laquelle sera centrée la carte.
à une chaîne de caractères contenant une adresse, une ville, le nom d'un monument, ...
L'usage d'une chaîne de caractères peut entraîner une position incohérente via le service de cartographie de Bing Map.
à une variable de type Adresse.

<Procédure WLangage> : Nom de procédure optionnel

Nom de la procédure WLangage (également nommée "callback") appelée après l'affichage de la nouvelle position géographique. Cette procédure est de la forme :
PROCEDURE <Nom de la procédure> (<Changement effectué>)

où <Changement effectué> est un booléen :
Vrai si la position a pu être modifiée,
Faux dans le cas contraire.
Ce paramètre n'est pas disponible.

Remarques

La fonction CarteAffichePosition utilise le service de géolocalisation de Google (ou Bing Map pour Universal Windows 10 App). Les positions déterminées à partir de la description d'un lieu dépendent de la quantité et de la précision des informations fournies dans cette description. Si une même description correspond à plusieurs lieux, le service de géolocalisation retournera les correspondances qui lui semble les meilleures.
Selon la version du mobile ou de la tablette utilisée, le service de cartographie utilisé n'est pas le même :
- avant iOS 6, le service utilisé est le service de géolocalisation de Google.
- après iOS 6, le service utilisé est le service de géolocalisation de Apple.
Il est préférable d'utiliser la syntaxe 2 "Afficher une position géographique avec procédure de vérification".
Le niveau de zoom de la carte n'est pas modifié lors du changement de position.
Pour centrer la carte sur une position donnée sans effectuer d'animation, il est possible d'affecter directement une variable de type géoPosition à la propriété Valeur d'un champ Carte.
Pour récupérer la liste des adresses correspondant à la description d'un lieu ou à une position géographique, utilisez la fonction géoRécupèreAdresse.
Pour connaître la position actuellement affichée au centre du champ Carte, utilisez la fonction CarteRécupèrePosition.
Le champ Carte utilise le service Bing Map.
Attention : L'utilisation du champ Carte est soumise à des conditions d'utilisations spécifiques. Il est nécessaire d'utiliser une clé Bing (fonction CarteLicenceBing). Vérifiez la licence Bing avant de déployer vos applications.

Liste des exemples associés :

Exemples unitaires (WEBDEV) : Le champ Carte

[ + ] Utilisation du champ Carte de WEBDEV.
Il permet d'afficher une carte comprenant des marqueurs et également d'afficher un itinéraire.

Exemples unitaires (WINDEV) : Le champ Carte

[ + ] Utilisation du champ Carte de WINDEV.
Il permet d'afficher une carte comprenant des marqueurs et également d'afficher un itinéraire.

Composante : wd300obj.dll

Voir Aussi

Version minimum requise

Version 17

Documentation également disponible pour…

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale