Calcular rotas entre marcadores de pontos de passagem num mapa (pré-visualização)

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

O controlo Mapa numa aplicação de tela pode adicionar pontos de passagem utilizando dados importados de uma tabela num livro do Excel. O controlo pode calcular rotas entre pontos de passagem, reordenar pontos de passagem e recalcular uma rota para melhorar o tempo ou a distância da viagem.

Importante

• Esta é uma funcionalidade de pré-visualização.
• As funcionalidades de pré-visualização não se destinam à produção e poderão ter funcionalidades restritas. Estas funcionalidades estão disponíveis antes do lançamento oficial, para que os clientes possam ter acesso antecipadamente e enviar comentários.

Irá precisar de uma origem de dados que contenha uma tabela nomeada com as colunas que se seguem. Cada coluna corresponde a uma propriedade avançada controlo Mapa. Cada linha é afixada como um ponto de passagem no mapa.

Nome da coluna	Corresponde a	Obrigatório
Nome (ou Etiqueta)	RouteWaypointsLabels	Opcional
Longitude	RouteWaypointsLongitudes	Opcional (obrigatório se não for fornecido Endereço)
Latitude	RouteWaypointsLatitudes	Opcional (obrigatório se não for fornecido Endereço)
Endereço	RouteWaypointsAddresses	Opcional (necessário se não forem fornecidos Longitude e Longitude)

Nota

Todas as propriedades são, tecnicamente, opcionais. No entanto, tem de ser fornecido, pelo menos, um endereço ou um par longitude/latitude para que a localização do pontos de passagem sejam desenhados.

Importar marcadores de pontos de passagem a partir de uma tabela do Excel

Neste exemplo, importaremos dados de pontos de passagem de uma tabela do Excel denominada TestData.

Criar uma origem de dados

1. Crie uma tabela no Excel com os dados que seguem. Chame a tabela de TestData.

   Nome	Longitude	Latitude	Endereço
   Trabalho	-122.156481	47.663448	1 Microsoft Way, Redmond, WA 98052
   Encontrar	-122.221037	47.57137
   Nadar	-122.144133	47.600373
   Ténis	-122.137265	47.616115

   A tabela deverá ter um aspeto semelhante ao seguinte:

   

2. Guarde o livro no seu OneDrive para Empresas e feche o ficheiro.

Vincular a origem de dados a um controlo Mapa

1. Criar uma aplicação de tela. Certifique-se de que cumpre os pré-requisitos geoespaciais.

2. Inserir um controlo Mapa.

3. No separador Propriedades do controlo, selecione a caixa Route waypoints(Items) e escreva excel.

   

4. Selecione Importar do Excel.

5. Navegue para o seu OneDrive para Empresas e selecione o livro do Excel que guardou anteriormente.

6. Selecione a tabela TestData e selecione Ligar.

   

7. No separador Avançado, localize RouteWaypointsLabels, RouteWaypointsLatitudes, RouteWaypointsLongitudes e RouteWaypointsAddresses e introduza o nome da coluna correspondente na tabela. (Neste exemplo, introduza Nome em RouteWaypointsLabels, Latitude em RouteWaypointsLatitudes, e assim por diante.) Coloque o nome da coluna entre aspas.

   Nota

   O endereço é permutável com a Latitude e a Longitude. Se a Latitude e a Longitude forem fornecidas, o Endereço não é utilizado. Se o Endereço for fornecido, a Latitude e Longitude não são necessárias. Existe um limite para o número de pontos de passagem que podem ser apresentados ao utilizar o endereço, por isso, utilize Latitude e Longitude sempre que possível.

Os marcadores aparecem no mapa nas localizações descritas pelas coordenadas ou endereços na tabela. Se a tabela incluía etiquetas, os marcadores estão etiquetados. Os marcadores são numerados pela ordem em que as localizações dos pontos de passagem aparecem na tabela.

Calcular rotas entre os pontos de passagem

Com o controlo Mapa selecionado, abra o separador Propriedades e ative Ativar encaminhamento.

O controlo calcula rotas entre os pontos de passagem afixados.

Nota

Por predefinição, o controlo Mapa reordena os pontos de passagem intermédios para diminuir o tempo de viagem ou a distância de viagem. Os primeiros e últimos pontos de passagem são considerados a origem e o destino e não podem ser reordenados. Para manter os pontos de passagem na ordem dada na origem de dados, ative a propriedade Maintain waypoint order do controlo.

Propriedades

Altere a forma como uma rota é calculada utilizando propriedades.

Propriedade	Descrição	Tipo	Separador
Enable routing	Calcula rotas entre pontos de passagem.	Booleano	Propriedades; Avançadas: UseRouting
Maintain waypoint order	Determina se uma rota calculada mantém os pontos de passagem na ordem fornecida na origem de dados.	Booleano	Propriedades; Avançadas: RouteMaintainOrder
Optimize route	Determina se uma rota calculada é otimizada para distância, tempo ou não é otimizada.	Lista pendente	Propriedades; Avançadas: RouteOptimization
Route travel mode	Determina se uma rota é calculada para um carro ou um camião, o que pode exigir evitar pontes com determinadas restrições de altura ou de peso.	Lista pendente	Propriedades; Avançadas: RouteTravelMode
Show route pins	Determina se os marcadores são mostrados ao longo dos pontos de passagem.	Booleano	Propriedades; Avançada: ShowRoutePins

Propriedades de saída

Algumas propriedades só ficam disponíveis quando uma rota calculada muda. Estas propriedades de saída são todas colocadas no objeto RouteDirection. O evento OnRouteDirectionChange é uma forma recomendada de utilizar a saída noutros controlos ou de personalizar a experiência da aplicação.

Propriedade	Descrição	Tipo	Separador
OnRouteDirectionChange	Contém código que é executado quando a rota é alterada.	Evento	Avançado
RouteDirection	Descreve as saídas do encaminhamento: LengthInMeters: o comprimento em metros de toda a rota TravelTimeInSeconds: o tempo de viagem esperado em segundos de toda a rota RouteGeoJSON: uma cadeia que descreve a rota no formato GeoJSON RouteLegs: uma tabela que descreve cada etapa da rota: Índice: um número que representa a ordem da etapa na rota LengthInMeters: o comprimento da etapa em metros TravelTimeInSeconds: o tempo de viagem esperado da etapa em segundos StartLabel: a etiqueta do ponto de partida da etapa StartLatitude: a latitude do ponto de partida da etapa StartLongitude: a longitude do ponto de partida da etapa StartAddress: o endereço do ponto de partida da etapa EndLabel: a etiqueta do ponto final da etapa EndLatitude: a latitude do ponto final da etapa EndLongitude: a longitude do ponto final da etapa EndAddress: o endereço do ponto final da etapa OrderedWaypoints: uma tabela que descreve cada ponto de passagem após os pontos de passagem serem encomendados: Índice: um número que representa a ordem do ponto de passagem na rota Etiqueta: a etiqueta do ponto de passagem Latitude: a latitude do ponto de passagem Longitude: a longitude do ponto de passagem Endereço: o endereço do ponto de passagem	Object	Não aplicável (apenas propriedade de saída)

Consulte também

Controlo Mapa interativo