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
Ajoute un itinéraire sur un champ Carte.
Exemple
// Affiche un itinéraire automobile entre les deux adresses spécifiées
CarteAjouteItinéraire(CARTE_ChampCarte, ["Place de la comédie, Montpellier", ...
"Avenue des Champs Elysées, Paris"], itinéraireAutomobile)
// Affiche un itinéraire correspondant à la liste de positions géographiques spécifiées
posDépart est une géoPosition
posDépart.Latitude = XXX
posDépart.Longitude = XXX
 
posArrivée est une géoPosition
posArrivée.Latitude = XXX
posArrivée.Longitude = XXX
 
CarteAjouteItinéraire(CARTE_ChampCarte, [posDépart, posArrivée])
 
// Il est également possible d'utiliser le code suivant :  
// tabPositions est un tableau de géoPosition
// Ajoute(tabPositions, posDépart)
// Ajoute(tabPositions, posArrivée)
// CarteAjouteItinéraire(CARTE_ChampCarte, tabPositions)
Syntaxe
<Résultat> = CarteAjouteItinéraire(<Champ Carte> , <Positions> [, <Mode> [, <Couleur> [, <Opacité> [, <Epaisseur>]]]])
<Résultat> : Chaîne de caractères
  • Identifiant de l'itinéraire ajouté,
  • Chaîne vide ("") en cas d'erreur. Pour plus de détails sur l'erreur, utilisez la fonction ErreurInfo.
Universal Windows 10 AppiPhone/iPad Cette fonction est asynchrone : il n'est pas possible de savoir si la fonction a renvoyé une erreur.
<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é.
<Positions> : Tableau
Nom de la variable de type tableau contenant les différentes positions :
  • Le premier élément correspond au point de départ de l'itinéraire.
  • Le dernier élément correspond au point d'arrivée.
  • Les éventuels autres éléments du tableau constituent les étapes intermédiaires de l'itinéraire.
Ce tableau doit comporter deux éléments au minimum (position de départ et position d'arrivée). Si vous utilisez la licence Google Map par défaut, ce tableau peut contenir jusqu'à 8 positions intermédiaires (étapes). Si vous utilisez une clé de licence "Google Maps API", le nombre de positions intermédiaires est illimité.
iPhone/iPad Ce tableau doit comporter deux éléments (position de départ et position d'arrivée). Il n'est pas possible de spécifier les différentes étapes de l'itinéraire.
Ce tableau peut être :
  • un tableau de chaînes de caractères, décrivant l'adresse correspondant à chaque position de l'itinéraire. Par exemple : avenue des Champs Elysée, Paris, France.
    Universal Windows 10 App L'usage d'une chaîne de caractères est déconseillé avec le service de cartographie de Bing Map. Les positions peuvent en effet être incohérentes.
  • un tableau de variables de type Adresse, décrivant l'adresse correspondant à chaque position de l'itinéraire.
  • un tableau de variables de type géoPosition indiquant la position géographique correspondant à chaque position de l'itinéraire.
  • un tableau de variables de type Marqueur représentant chacune des positions de l'itinéraire sur la carte (les marqueurs seront automatiquement ajoutés au champ Carte si ce n'est pas déjà le cas).
<Mode> : Constante optionnelle de type Entier
Mode de calcul de l'itinéraire. Ce paramètre peut prendre l'une des valeurs suivantes :
itinéraireAutomobile
(Valeur par défaut)
L'itinéraire sera tracé en respectant les voies accessibles aux automobiles.
Caractéristiques de ce mode :
  • Ce mode utilise le mode de géolocalisation de Google. Un accès Internet est nécessaire.
  • L'ordre des étapes peut être modifié afin d'obtenir le trajet le plus optimal.
itinéraireAutomobileNonOptimiséL'itinéraire sera tracé en respectant les voies accessibles aux automobiles.
Caractéristiques de ce mode :
  • Ce mode utilise le mode de géolocalisation de Google. Un accès Internet est nécessaire.
  • L'ordre des étapes ne sera pas modifié.
Universal Windows 10 App Cette constante n'est pas disponible.
itinéraireCyclisteL'itinéraire sera tracé en respectant les voies accessibles aux vélos. Les itinéraires cyclistes ne sont pas disponibles dans tous les pays. Pour plus d'informations, consultez la documentation du service de géolocalisation de Google.
Caractéristiques de ce mode :
  • Ce mode utilise le mode de géolocalisation de Google. Un accès Internet est nécessaire.
  • L'ordre des étapes peut être modifié afin d'obtenir le trajet le plus optimal.
iPhone/iPad Cette constante n'est pas disponible.
itinéraireManuelL'itinéraire sera tracé de manière rectiligne entre chaque position spécifiée sans tenir compte des routes.
Ce mode permet de ne pas utiliser le mode de géolocalisation de Google. Dans ce cas, le paramètre <Positions> doit correspondre à un tableau de variables de type géoPosition ou de variables de type Marqueur.
Dans ce mode, les étapes intermédiaires sont prises en compte selon l'ordre d'ajout dans le tableau.
Universal Windows 10 App Cette constante n'est pas disponible.
PHP Attention : Si le navigateur utilisé est Internet Explorer 4, le paramètre <Positions> doit obligatoirement correspondre à un tableau de variables de type géoPosition.
itinérairePiétonL'itinéraire sera tracé en respectant les voies accessibles aux piétons.
Caractéristiques de ce mode :
  • Ce mode utilise le mode de géolocalisation de Google. Un accès Internet est nécessaire.
  • L'ordre des étapes peut être modifié afin d'obtenir le trajet le plus optimal.
iPhone/iPad Cette constante n'est pas disponible.
<Couleur> : Entier optionnel
Couleur du tracé de l'itinéraire. Cette couleur peut correspondre à :
<Opacité> : Entier optionnel
Pourcentage d'opacité du tracé de l'itinéraire.
  • 0 : tracé transparent,
  • 100 : aucune opacité.
Par défaut, ce paramètre vaut 60.
Universal Windows 10 App Ce paramètre n'est pas disponible.
<Epaisseur> : Entier optionnel
Epaisseur (en pixels) du tracé de l'itinéraire. Par défaut, l'épaisseur est de 8 pixels.
Universal Windows 10 App Ce paramètre n'est pas disponible.
Remarques
  • Utilisation de Google maps : l'API "Directions" doit être activée dans votre clé Google Maps.
  • Attention : L'ordre des étapes intermédiaires peut être automatiquement modifié pour afficher un itinéraire optimisé.
  • Pour personnaliser l'image des marqueurs de l'itinéraire, il suffit d'ajouter au préalable les marqueurs avec la fonction CarteAjouteMarqueur sur les mêmes positions de l'itinéraire.
  • Pour supprimer un itinéraire sur une carte, utilisez la fonction WLangage CarteSupprimeItinéraire.
  • Pour supprimer tous les itinéraires ajoutés sur une carte, utilisez la fonction CarteSupprimeTout.
  • Attention : La création d'itinéraires entre deux positions éloignées peut provoquer le stockage en mémoire d'un très grand nombre de points pour le dessin de l'itinéraire (en particulier pour les itinéraires cycliste et piéton). Il est donc conseillé de limiter le nombre d'itinéraires affichés simultanément sur le champ Carte.
  • WINDEV Pour gérer des fonctionnalités spécifiques concernant la gestion des itinéraires, utilisez la fonction CarteExécuteJS.
  • Universal Windows 10 App Le champ Carte utilise le service Bing Map.
    Attention : L'utilisation du champ Carte est soumis à des conditions d'utilisation 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.
WM Sports Exemples multiplateforme (WINDEV Mobile) : WM Sports
[ + ] Cet exemple est une application de sport vous permettant d'enregistrer vos performances.
L'application calcule la distance parcourue, le temps, la vitesse moyenne et le nombre de calories dépensées en fonction du sport pratiqué.
Le parcours réalisé est affiché sur un champ carte grâce à des marqueurs et un tracé d'itinéraire.
Si vous disposez d'une montre Apple Watch, vous pourrez piloter WM Sports avec votre montre !

L'exemple dispose aussi d'une partie serveur qui sert à la synchronisation des données des utilisateurs.
Ce webservice est disponible dans l'exemple WEBDEV "WW_Sports".
Composante : wd290obj.dll
Version minimum requise
  • Version 18
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