PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Ajoute un itinéraire sur un champ Carte.
Versions 20 et supérieures
WINDEVWindows Cette fonction est désormais disponible dans les applications WINDEV pour Windows.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code Navigateur.
WEBDEV - Code ServeurWindowsLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Windows et sous Linux.
PHP Cette fonction est désormais disponible pour les sites PHP.
Nouveauté 20
WINDEVWindows Cette fonction est désormais disponible dans les applications WINDEV pour Windows.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code Navigateur.
WEBDEV - Code ServeurWindowsLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Windows et sous Linux.
PHP Cette fonction est désormais disponible pour les sites PHP.
WINDEVWindows Cette fonction est désormais disponible dans les applications WINDEV pour Windows.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
WEBDEV - Code Navigateur Cette fonction est désormais disponible en code Navigateur.
WEBDEV - Code ServeurWindowsLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Windows et sous Linux.
PHP Cette fonction est désormais disponible pour les sites PHP.
Versions 21 et supérieures
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Universal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
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.
iPhone/iPadUniversal Windows 10 App 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.
Versions 21 et supérieures
itinéraireAutomobileNonOptimisé
Nouveauté 21
itinéraireAutomobileNonOptimisé
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.
iPhone/iPad Cette constante n'est pas disponible.
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 correspond :
<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
  • 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.
  • Versions 20 et supérieures
    WINDEV Pour gérer des fonctionnalités spécifiques concernant la gestion des itinéraires, utilisez la fonction CarteExécuteJS.
    Nouveauté 20
    WINDEV Pour gérer des fonctionnalités spécifiques concernant la gestion des itinéraires, utilisez la fonction CarteExécuteJS.
    WINDEV Pour gérer des fonctionnalités spécifiques concernant la gestion des itinéraires, utilisez la fonction CarteExécuteJS.
  • Versions 21 et supérieures
    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.
    Nouveauté 21
    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.
    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.

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 : wd240obj.dll
Version minimum requise
  • Version 18
Documentation également disponible pour…
Commentaires
Problème avec la fonctionne CarteAjouteItinéraire
J'ai un Problème avec cette fonction sous android.
Je suis en windev mobile 23 et ça marche pas.
https://forum.pcsoft.fr/fr-FR/pcsoft.fr.windevmobile/36840-probleme-avec-fonctionne-carteajouteitineraire/read.awp
Des solutions ?
Riad BENGRICHE
05 juin 2019
Ne fonctionne plus avec la version 22 de Webdev (73h)
Google a du changer quelque chose car cela ne fonctionne pas avec la version 73h de Webdev 22.
christophe
12 jan. 2019