Compartir a través de


Calcular rutas entre pines de waypoint en un mapa (vista previa)

[Este tema es documentación preliminar y está sujeto a modificaciones.]

El control de mapa en una aplicación de lienzo puede agregar pines de waypoint utilizando datos importados de una tabla en un libro de Excel. El control puede calcular rutas entre waypoints, reordenar waypoints y recalcular una ruta para mejorar el tiempo o la distancia del viaje.

Importante

  • Esta es una característica en versión preliminar.
  • Las vistas previas de características no se han diseñado para un uso de producción y pueden tener una funcionalidad restringida. Estas características están disponibles antes del lanzamiento oficial para que los clientes puedan tener un acceso anticipado y proporcionar comentarios.

Necesitará un origen de datos que contenga una tabla con nombre con las siguientes columnas. Cada columna corresponde a una propiedad avanzada del control Mapa. Cada fila se fija como waypoint en el mapa.

Nombre de la columna Corresponde con Obligatorio
Nombre (o Etiqueta) RouteWaypointsLabels Opcionales
Longitud RouteWaypointsLongitudes Opcional (obligatorio si no se proporciona la dirección)
Latitud RouteWaypointsLatitudes Opcional (obligatorio si no se proporciona la dirección)
Dirección RouteWaypointsAddresses Opcional (obligatorio si no se proporcionan la longitud y la latitud)

Nota

Todas las propiedades son técnicamente opcionales. Sin embargo, se debe proporcionar al menos una dirección o un par de latitud/longitud para trazar la ubicación del waypoint.

Importar pines de waypoint desde una tabla de Excel

En este ejemplo, importaremos datos de waypoint desde una tabla de Excel llamada TestData.

Crear un origen de datos

  1. Cree una tabla en Excel con los siguientes datos. Asigne a la tabla el nombre TestData.

    Name Longitud Latitud Dirección
    Trabajo -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

    La tabla deberá ser ahora similar a esto:

    Una hoja de cálculo de Excel de ejemplo con una tabla llamada TestData que contiene la información necesaria para colocar pines de waypoint en un mapa.

  2. Guarde el libro en su OneDrive for Business y cierre el archivo.

Vincular el origen de datos a un control de mapa

  1. Cree una aplicación de lienzo. Asegúrese de que cumpla con los Requisitos previos geoespaciales.

  2. Inserte un control de mapa.

  3. En la pestaña Propiedades de los controles, seleccione la casilla Puntos de referencia de la ruta (artículos) y escriba excel.

    Una captura de pantalla que muestra cómo buscar un waypoint origen de datos para conectarse a un control de mapa en Power Apps Studio.

  4. Seleccione Importar datos desde Excel.

  5. Navegue a su OneDrive for Business y seleccione el libro de Excel que guardó anteriormente.

  6. Seleccione la tabla TestData y luego Conectar.

    Captura de pantalla del panel de selección de tablas.

  7. En la pestaña Avanzado, busque RouteWaypointsLabels, RouteWaypointsLatitudes, RouteWaypointsLongitudes y RouteWaypointsAddresses e ingrese el nombre de la columna correspondiente en la tabla. (En este ejemplo, introduzca Nombe en RouteWaypointsLabels, Latitud en RouteWaypointsLatitudes, etc.). Escriba el nombre de la columna entre comillas.

    Nota

    La dirección es intercambiable con latitud y longitud. Si se proporcionan Latitud y Longitud, no se utiliza la Dirección. Si se proporciona Dirección, Latitud y Longitud no se necesitan. Hay un límite en la cantidad de waypoints que se pueden mostrar al usar la dirección, así que use Latitud y Longitud cuando sea posible.

Los pines aparecen en el mapa en las ubicaciones descritas por las coordenadas o direcciones de la tabla. Si la tabla incluía etiquetas, los pines están etiquetados. Los pines están numerados en el orden en que aparecen las ubicaciones de los waypoints en la tabla.

Una captura de pantalla de un mapa con waypoints anclados y etiquetados que se muestran junto a las propiedades del mapa.

Calcular rutas entre los puntos de referencia

Con el control de mapa seleccionado, abra la pestaña Propiedades y active Habilitar enrutamiento.

El control calcula rutas entre los waypoints anclados.

Captura de pantalla de un mapa con rutas entre waypoints fijados.

Nota

De forma predeterminada, el control de mapa reordena los puntos intermedios para reducir el tiempo de viaje o la distancia de viaje. El primer y último punto de referencia se consideran origen y destino y no se pueden reordenar. Para mantener los waypoints en el orden indicado en el origen de datos, active la propiedad Mantener el orden de los waypoints del control.

Propiedades

Cambie cómo se calcula una ruta usando propiedades.

Property Descripción Tipo Pestaña
Enable routing Calcula rutas entre puntos de referencia. Booleana Propiedades; Avanzadas: UseRouting
Maintain waypoint order Determina si una ruta calculada mantiene los puntos de referencia en el orden proporcionado en el origen de datos. Booleana Propiedades; Avanzadas: RouteMaintainOrder
Optimize route Determina si una ruta calculada está optimizada para la distancia, el tiempo o no está optimizada. Lista desplegable Propiedades; Avanzadas: RouteOptimization
Route travel mode Determina si una ruta se calcula para un automóvil o un camión, lo que puede requerir evitar puentes con ciertas restricciones de altura o peso. Lista desplegable Propiedades; Avanzadas: RouteTravelMode
Mostrar marcadores de ruta Determina si se muestran pines sobre los waypoints de la ruta. Booleana Propiedades; Avanzadas: ShowRoutePins

Propiedades de salida

Algunas propiedades solo están disponibles cuando cambia una ruta calculada. Estas propiedades de salida se colocan en el objeto RouteDirection. El evento OnRouteDirectionChange es una forma recomendada de utilizar la salida en otros controles o de personalizar la experiencia de la aplicación.

Property Descripción Tipo Pestaña
OnRouteDirectionChange Contiene código que se ejecuta cuando se cambia la ruta. Evento Avanzado
RouteDirection Describe las salidas de enrutamiento:
  • LengthInMeters: longitud en metros de toda la ruta
  • TravelTimeInSeconds: tiempo de viaje esperado en segundos de toda la ruta
  • RouteGeoJSON: cadena que describe la ruta en formato GeoJSON
  • RouteLegs: tabla que describe cada tramo de la ruta:
    • Índice: número que representa el orden del tramo de la ruta
    • LengthInMeters: longitud en metros del tramo
    • TravelTimeInSeconds: tiempo de viaje esperado en segundos del tramo
    • StartLabel: etiqueta del punto de partida del tramo
    • StartLatitude: latitud del punto de partida del tramo
    • StartLongitude: longitud del punto de partida del tramo
    • StartAddress: dirección del punto de partida del tramo
    • EndLabel: etiqueta del punto de finalización del tramo
    • EndLatitude: latitud del punto de finalización del tramo
    • EndLongitude: longitud del punto de finalización del tramo
    • EndAddress: dirección del punto de finalización del tramo
  • OrderedWaypoints: tabla que describe cada waypoint después de ordenar los waypoints:
    • Índice: número que representa el orden waypoint de la ruta
    • Etiqueta: etiqueta del waypoint
    • Latitud: latitud del waypoint
    • Longitud: longitud del waypoint
    • Dirección: dirección del waypoint
Objeto No aplicable (solo propiedad de salida)

Consulte también

Control interactive Mapa