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
Windows Cette fonction est désormais disponible dans les applications WINDEV pour Windows.
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
Windows Cette fonction est désormais disponible dans les applications WINDEV pour Windows.
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.
Windows Cette fonction est désormais disponible dans les applications WINDEV pour Windows.
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.
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.
<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é.
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.
  • 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é.
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.
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.
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.
<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.
<Epaisseur> : Entier optionnel
Epaisseur (en pixels) du tracé de l’itinéraire. Par défaut, l'épaisseur est de 8 pixels.
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.
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