CarteAffichePosition (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français

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é.

Attention : Cette fonction est disponible dans l'émulateur Android. Cette fonction n'est pas disponible dans le simulateur Android.

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

Versions 18 et supérieures

Cette fonction est désormais disponible pour les applications iPhone/iPad.

Nouveauté 18

Cette fonction est désormais disponible pour les applications iPhone/iPad.

Versions 20 et supérieures

Cette fonction est désormais disponible pour les applications WINDEV sous Windows.

Cette fonction est désormais disponible en code Navigateur.

Cette fonction est désormais disponible pour les sites WEBDEV sous Windows et sous Linux.

Cette fonction est désormais disponible pour les sites PHP.

Nouveauté 20

Cette fonction est désormais disponible pour les applications WINDEV sous Windows.

Cette fonction est désormais disponible en code Navigateur.

Cette fonction est désormais disponible pour les sites WEBDEV sous Windows et sous Linux.

Cette fonction est désormais disponible pour les sites PHP.

Cette fonction est désormais disponible pour les applications WINDEV sous Windows.

Cette fonction est désormais disponible en code Navigateur.

Cette fonction est désormais disponible pour les sites WEBDEV sous Windows et sous Linux.

Cette fonction est désormais disponible pour les sites PHP.

Versions 21 et supérieures

Cette fonction est désormais disponible en mode Universal Windows 10 App.

Nouveauté 21

Cette fonction est désormais disponible en mode Universal Windows 10 App.

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

Versions 20 et supérieures

Cette syntaxe est disponible à partir de la version 20.

Nouveauté 20

Cette syntaxe est disponible à partir de la version 20.

// 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.
Ce paramètre ne peut pas être une chaîne de caractères ou une variable de type Adresse.

Versions 20 et supérieures

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> : Chaîne de caractères optionnelle (avec guillemets)

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.

Nouveauté 20

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> : Chaîne de caractères optionnelle (avec guillemets)

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.

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> : Chaîne de caractères optionnelle (avec guillemets)

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.
Versions 21 et supérieures
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.
Nouveauté 21
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.
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.

Pour afficher sur une carte la position d'une adresse, il est conseillé de réaliser les opérations suivantes :
1. Faire une requête HTTP sur Google MAP pour récupérer les coordonnées d'une adresse.
2. Utiliser les coordonnées récupérées avec la fonction CarteAffichePosition.

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 : wd240obj.dll

Voir Aussi

Version minimum requise

Version 17

Documentation également disponible pour…

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 18/06/2019

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