Calcula rutas entre puntos de referencia nun mapa (vista previa)

[Este tema é a documentación de pre-lanzamento e está suxeito a cambios.]

O control de mapas nunha aplicación de lenzo pode engadir pins de waypoints usando datos importados dunha táboa nun libro de Excel. O control pode calcular rutas entre waypoints, reordenar waypoints e recalcular unha ruta para mellorar o tempo ou a distancia da viaxe.

Importante

  • Esta é unha funcionalidade de vista previa.
  • As funcionalidades de vista previa non se deseñaron para uso de produción e poden ter funcionalidade restrinxida. Estas funcionalidades están dispoñibles antes da versión oficial para que os clientes poidan obter acceso a elas rápido e fornecer comentarios.

Necesitarás un orixe de datos que conteña unha táboa con nome coas seguintes columnas. Cada columna corresponde a unha propiedade avanzada do control de mapa. Cada fila está fixada como un waypoint no mapa.

Nome da columna Corresponde a Obrigatorio
Nome (ou etiqueta) RouteWaypointsLabels Opcional
Lonxitude RouteWaypointsLongitudes Opcional (obrigatorio se non se indica o enderezo)
Latitude RouteWaypointsLatitudes Opcional (obrigatorio se non se indica o enderezo)
Enderezo RouteWaypointsAddresses Opcional (obrigatorio se non se indican a lonxitude e a latitude)

Nota

Todas as propiedades son tecnicamente opcionais. Non obstante, debe proporcionarse polo menos un enderezo ou un par de latitude/lonxitude para que se trace a localización do waypoint.

Importar pins de waypoints dunha táboa de Excel

Neste exemplo, importaremos datos de waypoints dunha táboa de Excel denominada Datos de proba.

Crea un orixe de datos

  1. Crea unha táboa en Excel cos seguintes datos. Nomea a táboa Datos de proba.

    Nome Lonxitude Latitude Enderezo
    Traballar -122.156481 47.663448 1 Microsoft Way, Redmond, WA 98052
    Reunión -122.221037 47.57137
    Natación -122.144133 47.600373
    Tenis -122.137265 47.616115

    A túa táboa debería verse así:

    Un exemplo de folla de cálculo de Excel cunha táboa chamada TestData que contén a información necesaria para colocar puntos de referencia nun mapa.

  2. Garda o caderno de traballo no teu OneDrive for Business e pecha o ficheiro.

Vincular o orixe de datos a un control de mapa

  1. Crea unha aplicación de lenzo. Asegúrese de que cumpre co requisitos previos xeoespaciais.

  2. Insire un control de mapa.

  3. No control Propiedades ficha, seleccione o Puntos de ruta (elementos) caixa e tipo excel.

    Unha captura de pantalla que mostra como buscar un waypoint orixe de datos para conectarse a un control de mapa en Power Apps Studio .

  4. Seleccione Importar desde Excel.

  5. Navega ata o teu OneDrive for Business e seleccione o libro de Excel que gardou anteriormente.

  6. Seleccione a táboa Datos de proba e, a continuación, seleccione Conectar.

    Captura de pantalla do panel de selección de táboas.

  7. No Avanzado ficha, atopar RouteWaypointsLabels, ·, ·, e RouteWaypointsAddresses e introduza o nome da columna correspondente na táboa. (Neste exemplo, introduza Nome en RouteWaypointsLabels, en RutaWaypointsLatitudes, etc.) Engade o nome da columna entre comiñas.

    Nota

    O enderezo é intercambiable coa Latitude e Lonxitude. Se se proporcionan a latitude e a lonxitude, non se utiliza o enderezo. Se se proporciona o enderezo, non son necesarias a latitude nin a lonxitude. Hai un límite para o número de waypoints que se poden mostrar ao usar o enderezo, polo que utiliza a Latitude e a Lonxitude cando sexa posible.

Os pinos aparecen no mapa nos lugares descritos polas coordenadas ou enderezos da táboa. Se a táboa incluía etiquetas, os pinos están rotulados. Os pinos están numerados na orde na que aparecen os puntos de referencia na táboa.

Unha captura de pantalla dun mapa con puntos de referencia fixados e etiquetados que se mostran xunto ás propiedades do mapa.

Calcular rutas entre os waypoints

Co control do mapa seleccionado, abra o Propiedades pestana e acende Activa o enrutamento.

O control calcula rutas entre os waypoints fixados.

Captura de pantalla dun mapa con rutas entre puntos de referencia fixados.

Nota

De forma predeterminada, o control do mapa reordena os puntos intermedios para diminuír o tempo de viaxe ou a distancia de viaxe. O primeiro e o último waypoint considéranse orixe e destino e non se poden reordenar. Para manter os waypoints na orde indicada no orixe de datos, active o control Manter a orde dos waypoints propiedade.

Propiedades

Cambia como se calcula unha ruta usando propiedades.

Propiedade Descripción Tipo Tabulador
Activar ruta Calcula rutas entre puntos de referencia. Boolean Propiedades; Avanzado: UseRouting
Manter a orde dos puntos de referencia Determina se unha ruta calculada mantén os waypoints na orde indicada no orixe de datos. Boolean Propiedades; Avanzado: RouteMaintainOrder
Optimizar ruta Determina se unha ruta calculada está optimizada para a distancia, o tempo ou non. Lista despregable Propiedades; Avanzado: Optimización de rutas
Modo de viaxe da ruta Determina se se calcula unha ruta para un coche ou un camión, o que pode requirir evitar pontes con certas restricións de altura ou peso. Lista despregable Propiedades; Avanzado: RouteTravelMode
Mostrar pinos da ruta Determina se os pinos se mostran sobre os puntos de referencia da ruta. Boolean Propiedades; Avanzado: MostrarRoutePins

Propiedades de saída

Algunhas propiedades están dispoñibles só cando cambia unha ruta calculada. Estes propiedades de saída colócanse no RouteDirection obxecto. O OnRouteDirectionChange O evento é unha forma recomendada de usar a saída noutros controis ou de personalizar a experiencia da aplicación.

Propiedade Descripción Tipo Tabulador
OnRouteDirectionChange Contén código que se executa cando se cambia a ruta. Evento Avanzado
RouteDirection Describe as saídas do enrutamento:
  • LengthInMeters: lonxitude en metros de toda a ruta
  • TravelTimeInSeconds: o tempo de viaxe previsto en segundos de toda a ruta
  • RouteGeoJSON: unha cadea que describe a ruta en formato GeoJSON
  • RouteLegs: unha táboa que describe cada tramo da ruta:
    • Índice: un número que representa a orde do tramo na ruta
    • LengthInMeters: a lonxitude da perna en metros
    • TravelTimeInSeconds: o tempo de viaxe previsto da perna en segundos
    • StartLabel: a etiqueta do punto de partida da perna
    • StartLatitude: a latitude do punto de partida da perna
    • StartLongitude: A lonxitude do punto de partida da perna
    • StartAddress: o enderezo do punto de partida da etapa
    • EndLabel: a etiqueta do punto final da perna
    • EndLatitude: a latitude do punto final da perna
    • EndLongitude: A lonxitude do punto final da perna
    • EndAddress: o enderezo do punto final do tramo
  • OrderedWaypoints: unha táboa que describe cada waypoint despois de que os waypoints sexan ordenados:
    • Índice: un número que representa a orde do waypoint na ruta
    • Etiqueta: a etiqueta do waypoint
    • Latitude: a latitude do waypoint
    • Lonxitude: a lonxitude do waypoint
    • Enderezo: o enderezo do waypoint
Obxecto Non se aplica (propiedade de saída só)

Consulte tamén

Control de mapa interactivo