Inserir marcadors de punts del recorregut i traçar rutes entre ells (versió preliminar)

[Aquest tema forma part de la documentació preliminar i està subjecte a canvis.]

Podeu carregar una taula que contingui un conjunt de dades de waypoints al control del mapa. A continuació, el control col·locarà pins al mapa per a cada punt de pas i pot dibuixar rutes entre els punts de pas.

El control té opcions per reordenar els waypoints o reordenar la ruta per millorar el temps de viatge o la distància de viatge.

Important

  • Aquesta és una característica de visualització prèvia.
  • Les característiques de visualització prèvia no estan dissenyades per a un entorn de producció i poden tenir una funcionalitat restringida. Aquestes característiques estan disponibles abans d’un llançament oficial de producte per tal que els clients el puguin utilitzar abans i enviar-nos els seus comentaris.

Requisits previs

Afegir dades de punts del recorregut d'un llibre de treball de l'Excel

El font de dades ha de contenir una taula amb nom amb les columnes següents que s'han d'assignar a la propietat associada a la subfinestra Avançada del control.

Descripció de la columna S'assigna a la propietat Necessari
Etiqueta del punt del recorregut RouteWaypointsLabels Opcional
Longitud del punt del recorregut RouteWaypointsLongitudes Opcional
Latitud del punt del recorregut RouteWaypointsLatitudes Opcional
Adreça del punt del recorregut RouteWaypointsAddresses Opcional

Nota

Tot i que totes les propietats són opcionals, assegureu-vos que es compleix una de les condicions següents per trobar les ubicacions del punt del recorregut:

  • L'adreça del punt del recorregut és obligatòria.
  • La latitud i la longitud del punt del recorregut són obligatòries.

Per començar, utilitzeu un llibre de treball de l'Excel amb una taula semblant a la de l'exemple que es mostra a continuació amb les columnes necessàries:

Llibre de treball d'Excel d'exemple amb una taula anomenada TestData que conté les columnes Nom, Longitud, Latitud i Adreça.

Podeu copiar les següents dades d'exemple per provar aquesta funcionalitat:

Nom Longitud Latitud
Treballa -122.156481 47.663448
Troba'ns -122.221037 47.57137
Natació -122.144133 47.600373
Tenis -122.137265 47.616115

Un cop creat el llibre de treball de l'Excel, seguiu els passos següents per afegir dades del punt del recorregut des d'aquest llibre.

  1. Copieu i enganxeu la taula en una nova font de dades. En aquest exemple, estem utilitzant un llibre de treball de l'Excel.

  2. Seleccioneu una de les cel·les i, a continuació, a la pestanya Inici de la franja, seleccioneu Formata com a taula i trieu qualsevol estil i, a continuació, seleccioneu D'acord.

    Captura de pantalla que ressalta l'opció Formata com a taula a l'Excel.

  3. Seleccioneu la taula i, a continuació, aneu a la pestanya Disseny de la taula a la franja.

  4. Introduïu un nom per a la taula a Nom de la taula. Per exemple, TestData.

    Captura de pantalla que ressalta el nom de la taula a l'Excel.

  5. Deseu el llibre.

  6. Obriu o creeu una aplicació nova al Power Apps i inseriu el control del mapa.

  7. A la subfinestra Propietats, seleccioneu el camp Route waypoints(Items) i, a continuació, cerqueu excel i seleccioneu Importa des de l'Excel.

    Captura de pantalla de l'opció de punts del recorregut de la ruta.

  8. Localitzeu el llibre de l'Excel i, a continuació, seleccioneu Obre.

  9. Seleccioneu la taula que conté la informació, TestData i, a continuació, Connecta.

    Captura de pantalla de la subfinestra de selecció de la taula

  10. A la subfinestra Propietats, aneu a la pestanya Opcions avançades.

  11. Definiu les propietats següents:

    Propietat Valor
    RouteWaypointsLabels Nom
    RouteWaypointsLatitudes Latitud
    RouteWaypointsLongitudes Longitud
    RouteWaypointsAddresses Adreça
    NOTA: opcional, si el conjunt de dades té un camp d'adreça. L'adreça es pot utilitzar en lloc de Latitud i Longitud a totes les files on Latitud i Longitud no es defineixen.

    Nota

    L'adreça és intercanviable amb Latitud i Longitud. Si es proporcionen Latitud i Longitud, l'adreça no s'utilitzarà. Si només es proporciona Adreça, Latitud i Longitud no són necessàries.

  12. El control de mapa ara mostrarà cada fila de la taula com un pin, etiquetat amb el seu nom tal com es defineix a la taula de l'Excel i numerat en el mateix ordre que el conjunt de dades indicat.

    Captura de pantalla del mapa amb els punts del recorregut com a marcadors.

Traçar rutes entre els punts del recorregut

Per traçar rutes entre els punts de la ruta del mapa i personalitzar com es calcula la ruta, heu de configurar les opcions següents:

  1. Obriu la subfinestra Propietats amb un mapa seleccionat.

  2. Canvieu Habilita l'encaminament a Activat.

  3. El control ara dibuixarà rutes entre els punts de pas del mapa.

    Captura de pantalla del mapa amb rutes.

    Nota

    Per defecte, el control reordenarà els punts de referència del mig per disminuir el temps de viatge o la distància de viatge. Els primers i els darrers punts del recorregut es consideren l'origen i la destinació i no es poden reordenar. L'ordre dels punts del recorregut es pot mantenir blocat canviant l'ordre de Mantén l'ordre dels punts del recorregut a Activa.

Propietats

Les propietats següents poden configurar com es calcula la ruta o:

Propietat Descripció Type Location
Habilita rutes Si les es tracen rutes entre els punts del recorregut Boolean Propietats (també a Avançat com UseRouting)
Mantén l'ordre dels punts de recorregut Si és cert, el control reordenarà els waypoints per optimitzar la ruta en funció de la configuració Optimitza la ruta. Si és fals, el control mantindrà l'ordre que els waypoints tenen al conjunt de dades, i la configuració Optimitza la ruta només afectarà la ruta dibuixada. Boolean Propietats (també a Avançat com RouteMaintainOrder)
Optimitza la ruta Si s'optimitzarà la ruta per reduir el temps de viatge o reduir la distància de viatge. Enumeració (Cap, Distància, Temps) Propietats (també a Avançat com RouteOptimization)
Mode de viatge de la ruta Si la ruta es recorrerà amb cotxe o amb camió. Enumeració (Cotxe, Camió) Propietats (també a Avançat com RouteTravelMode)

Propietats de sortida

El control surt de diverses propietats quan la ruta canvia. Aquestes propietats es col·loen a l'objecte RouteDirection. L'esdeveniment OnRouteDirectionChange és una manera recomanada d'utilitzar la sortida en altres controls o de personalitzar l'experiència.

Propietat Descripció Type Location
OnRouteDirectionChange Com respon l’aplicació quan es canvia la ruta Esdeveniment Avançada
RouteDirection Objecte que descriu totes les sortides de la ruta:
  • LengthInMeters: nombre que representa la longitud de la ruta sencera
  • TravelTimeInSeconds: número que representa el temps de viatge previst en segons de tota la ruta
  • RouteGeoJSON: cadena que conté la ruta en format GeoJSON
  • RouteLegs: taula que descriu les propietats de cada ramal de la ruta:
    • Índex: número que representa l'ordre dels ramals de la ruta
    • LengthInMeters: nombre que representa la longitud del ramal de la ruta
    • TravelTimeInSeconds: número que representa el temps de viatge previst en segons del ramal de la ruta
    • StartLabel: cadena que representa l'etiqueta del punt d'inici del ramal de la ruta
    • StartLatitude: número que representa la latitud del punt d'inici del ramal de la ruta
    • StartLongitude: número que representa la longitud del punt d'inici del ramal de la ruta
    • StartAddress: cadena que representa l'adreça del punt d'inici del ramal de la ruta
    • EndLabel: cadena que representa l'etiqueta del punt final del ramal de la ruta
    • EndLatitude: número que representa la latitud del punt final del ramal de la ruta
    • EndLongitude: número que representa la longitud del punt final del ramal de la ruta
    • EndAddress: cadena que representa l'adreça del punt final del ramal de la ruta
  • OrderedWaypoints: taula que descriu les propietats de cada punt del recorregut de la ruta després d'ordenar-los:
    • Índex: número que representa l'ordre dels punts del recorregut de la ruta
    • Etiqueta: cadena que representa l'etiqueta del punt del recorregut
    • Latitude: número que representa la latitud del punt del recorregut
    • Longitud: número que representa la longitud del punt del recorregut
    • Adreça: cadena que representa l'adreça del punt del recorregut
Objecte No aplicable (només propietat de sortida)

Consulteu també

Control de mapes interactius