DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer une application ou un site / Champs, fenêtres et pages / Champs : Types disponibles / Champ Carte
  • Présentation
  • Initialiser une carte
  • Afficher une carte
  • Gérer des paramètres avancés (WEBDEV)
  • Fonctions WLangage utilisables avec les champs Carte
  • Remarques
  • Propriétés spécifiques aux champs 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
Présentation
WINDEV, WEBDEV et WINDEV Mobile permettent de manipuler un champ Carte directement par programmation. Il suffit d'utiliser directement la variable du champ Carte dans le code.
La variable du champ Carte correspond au nom du champ Carte.
Cette page d'aide détaille comment manipuler un champ Carte par programmation.
Remarque : De nombreuses fonctions du WLangage sont spécifiques à la gestion des champs de type Carte. Pour plus de détails, consultez les fonctions de gestion des champs Carte.
Initialiser une carte

Afficher une carte

A l'ouverture de la fenêtre contenant un champ Carte, une carte du monde est automatiquement affichée : la carte est centrée sur l'Europe avec un niveau de zoom minimal.
Il est possible d'afficher la dernière position mémorisée : il suffit de sélectionner l'option "Mémoriser la dernière position affichée" dans l'onglet "Général" de la fenêtre de description du champ Carte. Dans ce cas, la dernière position est affichée avec le même niveau de zoom.
Pour afficher une carte correspondant à un lieu spécifique, utilisez :
  • soit la fonction CarteAffichePosition : Cette fonction peut être utilisée avec une position spécifique (variable de type géoPosition) ou sur une ville ou un monument.
    Par 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)

    // 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")
  • soit l'affectation directe avec une position spécifique. Dans ce cas, la position est affichée sans animation.
    Exemple :
    // Centre la carte affichée par le champ "CARTE_Position" 
    // sur une position géographique
    MaPosition est une géoPosition
    CARTE_Position = MaPosition
Gérer des paramètres avancés (WEBDEV)
Fonctions WLangage utilisables avec les champs Carte
Les fonctions WLangage utilisables avec les champs Carte peuvent être classées en plusieurs catégories :
  • Les fonctions permettant de gérer les positions sur la carte :
    CarteAffichePositionCentre la carte affichée dans un champ Carte sur une position géographique ou un lieu donné.
    CarteInfoPositionRenvoie les coordonnées en pixel du point d'un champ Carte correspondant à une position géographique (latitude et longitude).
    CarteInfoXYRenvoie la position géographique (latitude et longitude) correspondant à un point d'un champ Carte.
    CarteRécupèrePositionRenvoie la position géographique du point situé au centre de la carte actuellement affiché dans un champ Carte.
  • Les fonctions permettant de suivre le déplacement de l'appareil :
    CarteFinDéplacementArrête le suivi du déplacement de l'appareil dans un champ Carte.
    CarteSuitDéplacementAffiche la position courante de l'appareil dans un champ Carte et met à jour cette position durant son déplacement.
  • Les fonctions permettant de gérer les marqueurs sur la carte. Ces fonctions utilisent des variables de type Marqueur permettant de définir toutes les caractéristiques des marqueurs.
    CarteAjouteMarqueurAjoute un nouveau marqueur sur une carte affichée dans un champ Carte.
    CarteModifieMarqueurModifie un marqueur affiché dans un champ Carte.
    CarteSupprimeMarqueurSupprime un marqueur d'une carte affichée par un champ Carte.
    CarteSupprimeToutSupprime dans un champ Carte :
    • tous les marqueurs,
    • toutes les formes,
    • toutes les images.
  • Les fonctions permettant de gérer les itinéraires sur la carte.
    CarteAjouteItinéraireAjoute un itinéraire sur un champ Carte.
    CarteSupprimeItinéraireSupprime un itinéraire d'un champ Carte.
  • Les fonctions permettant de manipuler des options supplémentaires de l'API Google de gestion des cartes :
    CarteConfigureAPIGglDéclare des paramètres supplémentaires pour le champ Carte qui seront transmis à l'API Google.
    CarteExécuteJSExécute du code natif de l'API Google Maps dans un champ Carte en Javascript.
    CarteRécupèreObjetJSRetourne l'instance de l'API d'un champ Carte.

Remarques

  • AndroidiPhone/iPad La fonction géoLanceAppli permet de lancer l'application de cartographie native de l'appareil.
  • Universal Windows 10 App La fonction CarteLicenceBing permet de spécifier la clé Bing nécessaire dans le cadre de l'utilisation du champ Carte dans une application en mode Universal Windows 10 app.
Propriétés spécifiques aux champs Carte
Les propriétés suivantes sont spécifiques à la gestion d'un champ Carte par programmation :
ModeCarteRenvoie ou modifie le mode d'affichage de la carte dans le champ Carte.
ValeurPermet de centrer la carte sur la position correspondant à la variable de type géoPosition spécifiée.
ZoomRenvoie ou modifie le niveau de zoom utilisé pour l'affichage de la carte.

Pour connaître la liste complète des propriétés du WLangage pouvant être utilisées avec un champ Carte, consultez Propriétés associées au champ Carte.
Version minimum requise
  • Version 17
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 17/07/2023

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