|
|
|
|
|
CarteAjouteItinéraire (Fonction) En anglais : MapAddItinerary Ajoute un itinéraire sur un champ Carte. // 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.
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é.
| itinéraireCycliste | L'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éraireManuel | L'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.
| itinérairePiéton | L'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 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.
<Epaisseur> : Entier optionnel Epaisseur (en pixels) du tracé de l'itinéraire. Par défaut, l'épaisseur est de 8 pixels.
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.
Pour gérer des fonctionnalités spécifiques concernant la gestion des itinéraires, utilisez la fonction CarteExécuteJS. 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 :
|
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.
|
|
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.
|
|
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 : wd300obj.dll
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|