DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Carte
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
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é.
Android Remarque : Cette fonction est disponible dans l'émulateur Android et dans le simulateur Android.
// 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
WINDEVWEBDEV - Code ServeurWEBDEV - Code NavigateurUniversal Windows 10 AppAndroidiPhone/iPadPHP
// 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
WINDEVUniversal Windows 10 AppAndroidiPhone/iPad

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.
Universal Windows 10 AppiPhone/iPad <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, ...
    Universal Windows 10 App 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.
WINDEVWEBDEV - Code ServeurWEBDEV - Code NavigateurUniversal Windows 10 AppAndroidiPhone/iPadPHP

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, ...
    Universal Windows 10 App 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.
WEBDEV - Code ServeurPHP Ce paramètre n'est pas disponible.
Remarques
  • WINDEVUniversal Windows 10 AppAndroid 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.
  • iPhone/iPad 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.
  • iPhone/iPad 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.
  • Android 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.
  • WINDEVWEBDEV - Code NavigateurUniversal Windows 10 AppAndroidiPhone/iPad Pour connaître la position actuellement affichée au centre du champ Carte, utilisez la fonction CarteRécupèrePosition.
  • Universal Windows 10 App 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 :
Le champ Carte 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.
Le champ Carte 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 : wd290obj.dll
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