Partager via


Calculer des itinéraires entre des points de cheminement sur une carte (version préliminaire)

[Cette rubrique fait partie de la documentation en version préliminaire et peut faire l'objet de modifications.]

Le contrôle Carte dans une application canevas peut ajouter des épingles de point de repère à l’aide de données importées depuis un tableau dans un classeur Excel. La commande peut calculer des itinéraires entre des points de repère, réorganiser des points de repère et recalculer un itinéraire pour améliorer le temps de trajet ou la distance.

Important

  • Cette fonctionnalité est en version préliminaire.
  • Les fonctionnalités préliminaires ne sont pas destinées à une utilisation en production et peuvent avoir des fonctionnalités restreintes. Ces fonctionnalités sont disponibles avant une publication officielle afin que les clients puissent y accéder de façon anticipée et fournir des commentaires.

Vous aurez besoin d’un source de données qui contient une table nommée avec les colonnes suivantes. Chaque colonne correspond à une propriété avancée du contrôle Carte. Chaque ligne est épinglée comme point de repère sur la carte.

Nom de colonne Correspond à Requise
Nom (ou Étiquette) RouteWaypointsLabels Facultatif
Longitude RouteWaypointsLongitudes Facultatif (obligatoire si l’adresse n’est pas indiquée)
Latitude RouteWaypointsLatitudes Facultatif (obligatoire si l’adresse n’est pas indiquée)
Address RouteWaypointsAddresses Facultatif (obligatoire si la longitude et la latitude ne sont pas fournies)

Notes

Toutes les propriétés sont techniquement facultatives. Cependant, au moins une adresse ou une paire latitude/longitude doit être fournie pour que l’emplacement du point de repère soit tracé.

Importer des épingles de point de repère à partir d’un tableau Excel

Dans cet exemple, nous allons importer des données de point de repère à partir d’un tableau Excel nommé TestData.

Créer une source de données

  1. Créer un tableau dans Excel avec les données suivantes. Nommez le tableau TestData.

    Nom Longitude Latitude Address
    Emploi -122.156481 47.663448 1 Microsoft Way, Redmond, WA 98052
    Se rencontrer -122.221037 47.57137
    Natation -122.144133 47.600373
    Tennis -122.137265 47.616115

    Votre table doit ressembler à ce qui suit :

    Un exemple de feuille de calcul Excel avec une table nommée TestData qui contient les informations nécessaires pour placer des épingles de point de repère sur une carte.

  2. Enregistrez le classeur sur votre OneDrive for Business et fermez le fichier.

Associer la source de données à un contrôle Carte

  1. Créer une application canevas. Veillez à ce qu’elle réponde aux prérequis géospatiaux.

  2. Insérer un contrôle Carte.

  3. Sur l’onglet Propriétés du contrôle, sélectionnez la zone Points de repère de l’itinéraire (Articles) et saisissez excel.

    Une capture d’écran qui montre comment rechercher une source de données de point de repère pour se connecter à un contrôle Carte dans Power Apps Studio.

  4. Sélectionnez Importer à partir d’Excel.

  5. Accédez à votre OneDrive for Business et sélectionnez le classeur Excel que vous avez enregistré précédemment.

  6. Sélectionnez la table TestData, puis sélectionnez Se connecter.

    Capture d’écran du volet de sélection de table.

  7. Sur l’onglet Avancé, recherchez RouteWaypointsLabels, RouteWaypointsLatitudes, RouteWaypointsLongitudes et RouteWaypointsAddresses et saisissez le nom de la colonne correspondante dans la table. (Dans cet exemple, saisissez Nom dans RouteWaypointsLabels, Latitude dans RouteWaypointsLatitudes, etc.) Placez le nom de la colonne entre guillemets.

    Notes

    L’adresse est interchangeable avec la latitude et la longitude. Si la latitude et la longitude sont fournies, l’adresse ne sera pas utilisée. Si l’adresse est fournie, la latitude et la longitude ne sont plus requises. Il y a une limite au nombre de points de repère qui peuvent être affichés lors de l’utilisation de l’adresse, utilisez donc la latitude et la longitude lorsque cela est possible.

Les épingles apparaissent sur la carte aux emplacements décrits par les coordonnées ou adresses dans la table. Si la table comprenait des Étiquettes, les épingles sont étiquetées. Les épingles sont numérotées dans l’ordre dans lequel les emplacements des points de repère apparaissent dans le tableau.

Une capture d’écran d’une carte avec des points de repère épinglés et étiquetés affichés à côté des propriétés de la carte.

Calculer les itinéraires entre les points de repère

Avec le contrôle Carte sélectionné, ouvrez l’onglet Propriétés et activez Activer l’itinéraire.

La commande calcule les itinéraires entre les points de repère épinglés.

Une capture d’écran d’une carte avec des itinéraires entre des points de repère épinglés.

Notes

Par défaut, le contrôle Carte réorganise les points de repère du milieu pour réduire le temps de trajet ou la distance de trajet. Le premier et le dernier points de repère sont considérés comme l’origine et la destination et ne peuvent pas être réorganisés. Pour conserver les points de repère dans l’ordre indiqué dans le source de données, activez la propriété Maintenir l’ordre des points de repère.

Propriétés

Modifiez la façon dont un itinéraire est calculé à l’aide des propriétés.

Propriété Description Type Tab
Enable routing Calcule les itinéraires entre des points de repère. Entier Propriétés ; Avancé : UseRouting
Maintain waypoint order Détermine si un itinéraire calculé conserve les points de repère dans l’ordre fourni dans la source de données. Entier Propriétés ; Avancé : RouteMaintainOrder
Optimize route Détermine si un itinéraire calculé est optimisé pour la distance, le temps ou n’est pas optimisé. Liste déroulante Propriétés ; Avancé : RouteOptimization
Route travel mode Détermine si un itinéraire est calculé pour une voiture ou un camion, ce qui peut nécessiter d’éviter des ponts avec certaines restrictions de hauteur ou de poids. Liste déroulante Propriétés ; Avancé : RouteTravelMode
Afficher les épingles de l’itinéraire Détermine si les épingles sont affichées sur les points de repère de l’itinéraire. Entier Propriétés ; Avancé : ShowRoutePins

Propriétés de sortie

Certaines propriétés deviennent disponibles uniquement lorsqu’un itinéraire calculé change. Ces propriétés de sortie sont toutes placées dans l’objet RouteDirection. L’événement OnRouteDirectionChange est un moyen recommandé d’utiliser la sortie dans d’autres contrôles ou de personnaliser l’expérience des applications.

Propriété Description Type Tab
OnRouteDirectionChange Contient du code qui s’exécute lorsque l’itinéraire est changé. Événement Avancé
RouteDirection Décrit les sorties de routage :
  • LengthInMeters - la longueur en mètres de l’ensemble de l’itinéraire
  • TravelTimeInSeconds - Le temps de trajet prévu en secondes de l’ensemble de l’itinéraire
  • RouteGeoJSON - Une chaîne décrivant l’itinéraire au format GeoJSON
  • RouteLegs - Un tableau décrivant les propriétés de chaque segment de l’itinéraire :
    • Index - Un numéro représentant l’ordre du segment d’itinéraire dans l’itinéraire
    • LengthInMeters - La longueur en mètres du segment
    • TravelTimeInSeconds - Le temps de trajet prévu en secondes du segment en secondes
    • StartLabel : L’Étiquette du point de départ du segment
    • StartLatitude : La latitude du point de départ du segment
    • StartLongitude : La longitude du point de départ du segment
    • StartAddress : L’adresse du point de départ du segment
    • EndLabel : L’Étiquette du point final du segment
    • EndLatitude : La latitude du point final du segment
    • EndLongitude : La longitude du point final du segment
    • EndAddress : L’adresse du point final du segment
  • OrderedWaypoints - Un tableau décrivant les propriétés de chaque point de repère de l’itinéraire après avoir ordonné les points de repère :
    • Index - Un numéro représentant l’ordre des points de repère dans l’itinéraire
    • Étiquette : L’Étiquette du point de repère
    • Latitude : la latitude du point de repère
    • Longitude : la longitude du point de repère
    • Adresse : l’adresse du point de repère
Object Sans objet (propriété de sortie uniquement)

Voir aussi

Contrôle Carte interactive