DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE
Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Carte
WINDEV
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
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.
Exemple
// 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 NavigateurAndroidiPhone/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
WINDEVAndroidiPhone/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.
iPhone/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, etc.
  • à une variable de type Adresse.
WINDEVWEBDEV - Code ServeurWEBDEV - Code NavigateurAndroidiPhone/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, etc.
  • à 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
  • WINDEVAndroid La fonction CarteAffichePosition utilise le service de géolocalisation de Google. 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 NavigateurAndroidiPhone/iPad Pour connaître la position actuellement affichée au centre du champ Carte, utilisez la fonction CarteRécupèrePosition.
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 : wd300obj.dll
Voir Aussi
Version minimum requise
  • Version 17
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 18/09/2024

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