Inserir marcadores de localizadores e traçar rotas entre eles (versão preliminar)

Artigo
03/30/2022
2 minutos para o fim da leitura

[Este tópico faz parte da documentação de pré-lançamento e está sujeito a alterações.]

É possível carregar uma tabela que contenha um conjunto de dados de localizadores no controle de mapeamento. O controle colocará marcadores no mapa para cada localizador e poderá traçar rotas entre os localizadores.

O controle tem opções para reordenar os localizadores ou reorganizar a rota a fim de melhorar o tempo ou a distância da viagem.

Importante

Esse é um recurso de visualização.
Os recursos de visualização não foram criados para uso em ambientes de produção e podem ter funcionalidade restrita. Esses recursos são disponibilizados antes de um lançamento oficial para que os clientes possam ter acesso antecipado e fornecer comentários.

Pré-requisitos

Crie um aplicativo de tela e verifique se ele atende aos pré-requisitos geoespaciais.
No aplicativo, insira um mapa.

Adicionar dados de localizador de uma pasta de trabalho do Excel

Seu fonte de dados precisa conter uma tabela nomeada com as colunas a seguir que devem ser mapeadas para a propriedade associada no painel Avançado do controle.

Descrição da coluna	Mapeia para propriedade	Obrigatória
Rótulo para o localizador	RouteWaypointsLabels	Opcional
Longitude do localizador	RouteWaypointsLongitudes	Opcional
Latitude do localizador	RouteWaypointsLatitudes	Opcional
Endereço do localizador	RouteWaypointsAddresses	Opcional

Observação

Embora todas as propriedades sejam opcionais, certifique-se de que uma das seguintes condições seja atendida para que os locais dos localizadores sejam encontrados:

O endereço do localizador é obrigatório.
A latitude e a longitude do localizador são obrigatórias.

Para começar, use uma pasta de trabalho do Excel com uma tabela semelhante ao exemplo mostrado abaixo com as colunas obrigatórias:

Pasta de trabalho do Excel de exemplo com uma tabela chamada TestData que contém as colunas Nome, Longitude, Latitude e Endereço.

Você pode copiar os seguintes dados de exemplo para testar esta funcionalidade:

Name	Longitude	Latitude
Trabalho	-122.156481	47.663448
Encontro	-122.221037	47.57137
Natação	-122.144133	47.600373
Tênis	-122.137265	47.616115

Depois de criar a pasta de trabalho do Excel, siga as etapas abaixo para adicionar dados de localizadores desta pasta de trabalho.

Copie e cole a tabela em uma nova fonte de dados. Neste exemplo, estamos usando uma pasta de trabalho do Excel.
Selecione uma das células e, na guia Página Inicial na faixa, selecione Formatar como Tabela, escolha qualquer estilo e selecione OK.
Selecione a tabela e acesse a guia Design de Tabela na faixa de opções.
Insira um nome para a tabela em Nome da Tabela. Por exemplo, TestData.
Salve a pasta de trabalho.
Abra ou crie um aplicativo no Power Apps e insira o controle de mapeamento.
No painel Propriedades, selecione o campo Localizadores de rota(itens) e, em seguida, pesquise excel e selecione Importar do Excel.
Localize a pasta de trabalho do Excel e selecione Abrir.
Selecione a tabela que contém as informações, TestData, e, em seguida, Conectar.
No painel Propriedades, vá para a guia Avançado.

Defina as seguintes propriedades:

Propriedade	Value
RouteWaypointsLabels	Name
RouteWaypointsLatitudes	Latitude
RouteWaypointsLongitudes	Longitude
RouteWaypointsAddresses	Address NOTA: opcional, se seu conjunto de dados tiver um campo de endereço. O endereço pode ser usado no lugar de Latitude e Longitude em qualquer linha em que a latitude e a longitude não estejam definidas.

Observação

O endereço é substituível por Latitude e Longitude. Se a latitude e a longitude forem fornecidas, o endereço não será usado. Se apenas o endereço for fornecido, a latitude e a longitude não serão necessárias.

O controle de mapeamento agora mostrará cada linha da tabela como um marcador, rotulado com seu Nome, conforme definido na tabela do Excel, e numerado na mesma ordem do conjunto de dados fornecido.

Traçar rotas entre os localizadores

Para traçar rotas entre os localizadores no mapa e personalizar como a rota é calculada, é necessário definir as seguintes configurações:

Abra o painel Propriedades com um mapa selecionado.
Alterne Habilitar roteamento para Ativado.
O controle agora traçará rotas entre os localizadores no mapa.

Observação

Por padrão, o controle reordenará os localizadores intermediários a fim de diminuir o tempo ou a distância da viagem. O primeiro e o último localizadores são considerados a origem e o destino e não podem ser reordenados. A ordem dos localizadores pode ser mantida bloqueada alternando o botão Manter a ordem dos localizadores para Ativado.

Propriedades

As seguintes propriedades podem configurar como a rota é calculada ou:

Propriedade	Descrição	Digitar	Location
Habilitar roteamento	Se as rotas são traçadas entre localizadores	Boolean	Propriedades (também em Avançado como UseRouting)
Manter ordem do localizador	Se verdadeiro, o controle reordenará os localizadores a fim de otimizar a rota com base na configuração Otimizar rota. Se for falso, o controle manterá a ordem que os localizadores têm no conjunto de dados, e a configuração Otimizar rota afetará apenas a rota traçada.	Boolean	Propriedades (também em Avançado como RouteMaintainOrder)
Otimizar rota	Indica se a rota deve ser otimizada para diminuir o tempo ou a distância da viagem.	Enumeração (nenhum, distância, tempo)	Propriedades (também em Avançado como RouteOptimization)
Modo de viagem da rota	Indica se a rota será feita de carro ou de caminhão.	Enumeração (carro, caminhão)	Propriedades (também em Avançado como RouteTravelMode)

Propriedades de saída

O controle produz várias propriedades quando a rota muda. Essas propriedades são todas colocadas no objeto RouteDirection. O evento OnRouteDirectionChange é uma maneira recomendada de usar a saída em outros controles ou personalizar a experiência.

Propriedade	Descrição	Tipo	Location
OnRouteDirectionChange	Como o aplicativo responde quando a rota é alterada	Evento	Avançado
RouteDirection	Objeto que descreve todas as saídas de roteamento: LengthInMeters: número que representa o comprimento em metros de toda a rota TravelTimeInSeconds: número que representa o tempo de viagem esperado em segundos de toda a rota RouteGeoJSON: cadeia de caracteres que contém a rota no formato GeoJSON RouteLegs: tabela que descreve as propriedades de cada trecho da rota: Índice: número que representa a ordem do trecho na rota LengthInMeters: número que representa o comprimento em metros do trecho da rota TravelTimeInSeconds: número que representa o tempo de viagem esperado em segundos do trecho da rota StartLabel: cadeia de caracteres que representa o rótulo do ponto inicial do trecho da rota StartLatitude: número que representa a latitude do ponto inicial do trecho da rota StartLongitude: número que representa a longitude do ponto inicial do trecho da rota StartAddress: cadeia de caracteres que representa o endereço do ponto inicial do trecho da rota EndLabel: cadeia de caracteres que representa o rótulo do ponto final do trecho da rota EndLatitude: número que representa a latitude do ponto final do trecho da rota EndLongitude: número que representa a longitude do ponto final do trecho da rota EndAddress: cadeia de caracteres que representa o endereço do ponto final do trecho da rota OrderedWaypoints: tabela que descreve as propriedades de cada localizador na rota depois de ordenar os localizadores: Índice: número que representa a ordem do localizador na rota Rótulo: cadeia de caracteres que representa o rótulo do localizador Latitude: número que representa a latitude do localizador Longitude: número que representa a longitude do localizador Endereço: cadeia de caracteres que representa o endereço do localizador	Objeto	Não aplicável (somente propriedade de saída)

Confira também

Controle de mapeamento interativo