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)
WEBDEV - Code ServeurWEBDEV - Code Navigateur Le champ Carte disponible en WEBDEV permet de nombreux paramétrages. Mais WEBDEV offre la possibilité d'utiliser des paramètres supplémentaires, disponibles dans l'API Google de gestion des cartes.
Pour cela, deux fonctions sont disponibles :
  • la fonction CarteConfigureAPIGgl utilisable en code serveur, qui permet de spécifier les paramètres supplémentaires à gérer sur le champ Carte. Ces paramètres sont globaux au projet.
  • la fonction CarteRécupèreObjetJS utilisable en code navigateur, qui permet de récupérer la carte et ses options dans un objet dynamique afin de manipuler le champ en code Javascript.
Exemple :
  • Déclaration des librairies à charger en code serveur :
    // Code serveur
    CarteConfigureAPIGgl("libraries=geometry,places","language=fr")
  • Récupération de l'objet dynamique en code navigateur :
    // Code navigateur
    MaCarte est un objet dynamique
    MaCarte = CarteRécupèreObjetJS(CARTE_Navigateur)
    // Appel de la fonction Javascript
    RechercheAdresse()
  • Fonction Javascript permettant de manipuler le champ Carte :
    // Fonction Javascript utilisant l'objet dynamique
    function RechercheAdresse()
    {
    var infowindow;
    // Rome : 41.873144, 12.480391
    var pyrmont = new google.maps.LatLng(41.873144, 12.480391);
    var request = {
    location: pyrmont,
    radius: 500,
    types: ['store']
    };
    infowindow = new google.maps.InfoWindow();
    var service = new google.maps.places.PlacesService(MaCarte);
    service.nearbySearch(request, RetourAdresse_WB);
    }
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

  • WEBDEV - Code Serveur La fonction CarteLicenceGgl permet de spécifier l'identifiant Google nécessaire dans le cadre d'une utilisation du champ Carte avec l'option Google Map API for Work. Pour plus de détails, consultez la licence d'utilisation de "Google Maps API".
    WEBDEV - Code Serveur Il est également possible de saisir la licence "Google Maps API" dans la fenêtre de description du projet (onglet "Avancé").
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