Partilhar via


Controlo Mapa interativo

Adicione facilmente um mapa interativo às suas aplicações de tela. Marcadores de enredo de uma origem de dados que contém endereços ou pares de latitude e longitude. À medida que reduz, os marcadores irão agrupar-se opcionalmente para condensar grupos de dados. Em dispositivos móveis e experiências Web, um mapa pode mostrar a posição atual do utilizador e calcular uma rota para o destino do utilizador. Os mapas podem ser alternados entre as vistas da estrada e de satélite.

Uma captura de ecrã de uma aplicação de tablet na qual um controlo Mapa está em construção no Microsoft Power Apps Studio.

Funcionalidades do mapa interativo

Pré-requisitos

Precisará satisfazer alguns pré-requisitos antes de utilizar mapas nas suas aplicações de tela. Consulte a tabela de privacidade e segurança para obter mais detalhes sobre a forma como as diferentes funcionalidades de mapa utilizam dados.

Adicionar um mapa a um ecrã de aplicação

Com a sua aplicação aberta para edição no Power Apps Studio:

  1. Selecione o separador Inserir e expanda Suporte de dados.
  2. Selecione Mapa para colocar um mapa no ecrã da aplicação ou arraste o controlo para o ecrã para o posicionar de forma mais precisa.

Adicionar marcadores, rotas e formas

Os marcadores, rotas e formas são propriedades de conjuntos de dados que necessitam de identificar uma origem de dados, que é uma tabela de uma coleção ou conector e as colunas relevantes. A origem de dados está definida na propriedade Items (Items para marcadores, RouteWaypoints_Items para rotas, Shape_Items para formas) e as colunas relevantes são definidas nas propriedades relacionadas (por ex.: ItemLatitudes, ItemLongitudes, etc. para marcadores). A secção Propriedades contém informações adicionais sobre estes conjuntos de dados e as respetivas propriedades relacionadas.

Por exemplo, se tivesse uma coleção de tabelas chamada Localizações como as colunas Nome, Longitude e Latitude:

Nome Longitude Latitude
Fourth Coffee (amostra) -98.29277 26.2774
Litware, Inc. (exemplo) -96.85572 32.55253
Adventure Works (amostra) -96.99952 32.72058

Para os apresentar como marcadores etiquetados no mapa:

  1. Defina a propriedade Items como Localizações

  2. Defina a propriedade ItemLabels como "Nome"

  3. Defina a propriedade ItemLongitude como "Longitude"

  4. Defina a propriedade ItemLatitude como "Latitude"

    Importante

    Os nomes das colunas relevantes têm de estar entre aspas nas propriedades relacionadas. A origem de dados não deve ter aspas.

Pode ver como apresentar marcadores de uma folha do Excel ou criar uma aplicação que utiliza o controlo Entrada de endereço para preencher marcadores no controlo Mapa como exemplos adicionais.

Nota

  • Cada controlo de mapas pode apresentar até 5000 pinos de latitude ou longitude e 50 pinos de endereços. O limite de pinos é mais baixo para endereços, uma vez que o mapa necessita de geocodificar estes endereços para a latitude ou longitude apresentar. Recomendamos que não utilize endereços sempre que possível. Pode guardar endereços geocodificados na origem de dados.
  • Quando a latitude ou longitude e um endereço é dado para um único pino, o controlo dos mapas atribuirá prioridade utilizando a latitude ou longitude para evitar geocodificar o endereço.
  • O número máximo de formas que podem ser desenhadas num controlo de mapas está limitado a 500.

_Propriedades

Altere o comportamento e aparência de um mapa utilizando propriedades. Algumas propriedades só estão disponíveis no separador Avançadas.

Uma captura de ecrã de uma aplicação de telefone na qual é mostrado um controlo Mapa junto do separador Propriedades no Microsoft Power Apps Studio.

O controlo Mapa tem seis tipos diferentes de propriedades:

  1. Propriedades de estilo
  2. Propriedades comportamentais
  3. Propriedades de marcadores
  4. Propriedades de rota
  5. Propriedades de forma
  6. Propriedades de saída

Propriedades de estilo

Propriedade Descrição Tipo Separador
Satellite view Apresenta o mapa na vista de satélite. Deixe esta propriedade desativada para apresentar o mapa na vista de estrada. Booleano Propriedades; Avançadas: SatelliteView
Mapa style Define o estilo do mapa. Opções: Estrada, Noite, Relevo com sombra de estrada, Satélite, Etiquetas de estrada de satélite, Luz de alto contraste, Alto Contraste Escuro, Tons de cinzento claro, Tons de cinzento escuro. Enum Propriedades
Transparency Determina a transparência do mapa, de 0 (opaco) a 100 (transparente). Número inteiro Propriedades; Avançadas: Transparency
Visible Mostra ou oculta o mapa. Boolean Propriedades; Avançadas: Visible
Position Coloca o canto superior esquerdo do mapa nas coordenadas do ecrã especificadas em x e y. Floating point number Propriedades; Avançadas: X, Y
Size Determina o tamanho do mapa utilizando os valores dos pixels fornecidos em Largura e Altura. Integer Propriedades; Avançadas: Width, Height
Border radius Determina o raio do canto do limite do mapa. Floating point number Propriedades; Avançadas: BorderRadius
Border Determina o estilo, a largura e a cor do limite do mapa. Não aplicável Propriedades; Avançadas: BorderStyle, BorderThickness, BorderColor
DisplayMode Determina se o controlo permite a intervenção do utilizador (Editar), apenas apresenta os dados (Ver) ou se está desativado (Desativado). Enum Avançado

Propriedades comportamentais

Propriedade Descrição Tipo Separador
Show info cards Mostra informações sobre uma localização mapeada quando o utilizador a seleciona (Ao clicar) ou aponta para ela (Ao pairar). Se Nenhuma, nenhuma informação é mostrada. Enum Propriedades; Avançadas: InfoCards
Use default location Inicia o mapa numa localização predefinida. Boolean Propriedades; Avançadas: DefaultLocation
Default latitude Define a coordenada de latitude que o mapa mostra se Utilizar localização predefinida estiver ativada. Floating point number Propriedades; Avançadas: DefaultLatitude
Default longitude Define a coordenada de longitude que o mapa mostra se Utilizar localização predefinida estiver ativada. Floating point number Propriedades; Avançadas: DefaultLongitude
Default zoom level Define o nível de zoom se Utilizar localização predefinida estiver ativada, de 0 a 22. Número inteiro Propriedades; Avançadas: DefaultZoomLevel
Show current location Apresenta a localização do utilizador. Boolean Propriedades; Avançadas: CurrentLocation
Current location latitude Define a coordenada de latitude do marcador de localização atual que o mapa mostra se Mostrar localização atual estiver ativada. Para colocar o marcador na localização atual do utilizador, defina esta propriedade como Location.Latitude. Floating point number Propriedades; Avançadas: CurrentLocationLatitude
Current location longitude Define a coordenada de longitude do marcador de localização atual que o mapa mostra se Mostrar localização atual estiver ativada. Para colocar o marcador na localização atual do utilizador, defina esta propriedade como Location.Longitude. Floating point number Propriedades; Avançadas: CurrentLocationLongitude
Controlo Zoom Mostra o controlo Zoom. Booleano Propriedades; Avançadas: Zoom
Controlo Bússola Mostra o controlo Bússola. Boolean Propriedades; Avançadas: Compass
Controlo Rotação Mostra o controlo Rotação (inclinação). Booleano Propriedades; Avançadas: Pitch
TabIndex Especifica a ordem pela qual o mapa é selecionado se o utilizador navegar na aplicação utilizando a tecla do separador. Número inteiro Propriedades; Avançadas: Tab index
Tooltip Determina o texto a visualizar quando o utilizador paira sobre um elemento visual. String Avançadas
ContentLanguage Determina o idioma de apresentação do mapa, se for diferente do idioma utilizado na aplicação. Cadeia (de carateres) Avançado
OnLoad Contém código que é executado quando o mapa é carregado. Evento Avançadas
OnMapClick Contém código que é executado quando o utilizador seleciona o mapa. A latitude e longitude do ponto clicado encontra-se na propriedade de saída ClickedLocation. Evento Avançado
OnChange Contém código que é executado quando qualquer aspeto do mapa é alterado. Evento Avançadas
OnSelect Contém código que é executado quando o utilizador seleciona algo no mapa. Evento Avançado

Propriedades de marcadores

Propriedade Descrição Tipo Separador
Locations(Items) Identifica uma origem de dados (Items) sob a forma de uma tabela a partir do qual obter localizações para mostrar no mapa. A tabela lista conjuntos de longitudes e latitudes, ou endereços físicos, para apresentar como marcadores. Recomenda-se a utilização da latitude ou longitude, pois os endereços têm de ser geocodificados e têm um limite de afixação mais restritivo. A tabela pode ser uma coleção ou proveniente de uma origem de dados, como o Excel Online. Cada linha tem de ter uma entrada para etiqueta, longitude e latitude, ou um endereço físico, e opcionalmente a cor e o ícone do marcador. Não aplicável Propriedades; Avançadas: Items
ItemsLabels Identifica a coluna em Items que contém as etiquetas para os marcadores. ColumnName Avançadas
ItemsLatitudes Identifica a coluna em Items que contém a posição de latitude dos marcadores. ColumnName Avançadas
ItemsLongitudes Identifica a coluna em Items que contém a posição de longitude dos marcadores. ColumnName Avançadas
ItemsAddresses Identifica a coluna em Items que contém endereços que representam a localização dos marcadores. Existe um limite para o número de marcadores que podem ser apresentados a partir de endereços. Recomendamos a geocodificação dos endereços para pares de latitude e longitude, e que os utilize para apresentar marcadores, sempre que possível. ColumnName Avançado
ItemsColors Identifica a coluna em Items que contém as cores dos marcadores. ColumnName Avançadas
ItemsIcons Identifica a coluna em Items que contém as cores dos ícones. ColumnName Avançado
Cluster pins Agrupa marcadores de localização de mapa próximos, em vez de os apresentar individualmente. Booleano Propriedades; Avançadas: Clustering
Pin color Determina a cor predefinida dos marcadores mostrados no mapa. Esta cor é substituída pela propriedade ItemsColors, se definida Color picker Propriedades; Avançadas: PinColor
OnItemsChange Contém código que é executado quando as marcações no mapa são alteradas. Evento Avançado

Propriedades de rota

Propriedade Descrição Tipo Separador
Enable routing Determina se o utilizador pode pedir direções para uma localização especificada. Booleano Propriedades; Avançadas: UseRouting
Route waypoints(Items) Mostra os pontos de passagem, conforme fornecidos numa origem de dados (RouteWaypoints_Items) sob a forma de uma tabela. A tabela pode ser uma coleção ou proveniente de uma origem de dados, como o Excel Online. Se for Nenhum, não são mostrados pontos de passagem. Enum Propriedades; Avançadas: RouteWaypoints_Items
RouteWaypointsLabels Identifica a coluna em RouteWaypoints_Items que contém as etiquetas para os pontos de passagem. ColumnName Avançadas
RouteWaypointsLatitudes Identifica a coluna em RouteWaypoints_Items que contém a posição de latitude dos pontos de passagem. ColumnName Avançadas
RouteWaypointsLongitudes Identifica a coluna em RouteWaypoints_Items que contém a posição de longitude dos pontos de passagem. ColumnName Avançadas
RouteWaypointsAddresses Identifica a coluna em RouteWaypoints_Items que contém endereços que representam a localização de pontos de passagem. ColumnName Avançado
Maintain waypoint order Determina se uma rota calculada mantém os pontos de passagem na ordem fornecida. Boolean Propriedades; Avançadas: RouteMaintainOrder
Optimize route Determina se uma rota calculada é otimizada para distância, tempo ou não é otimizada. Enum 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. Enumerar Propriedades; Avançadas: RouteTravelMode
OnRouteDirectionChange Contém código que é executado quando a aplicação deteta que o utilizador mudou de direção quando está numa rota calculada. Evento Avançado

Propriedades de forma

Propriedade Descrição Tipo Separador
Show shapes Mostra as formas em Shapes_Items. Booleano Propriedades; Avançadas: ShowShapes
Shapes_Items Identifica uma origem de dados (Shapes_Items) sob a forma de uma tabela a partir do qual obter formas para mostrar no mapa. A tabela pode ser uma coleção ou proveniente de uma origem de dados, como o Excel Online. Cada linha tem de ter uma entrada para a forma (objeto GeoJSON) e (opcionalmente) uma etiqueta e cor. TableName Avançadas
ShapeGeoJSONObjects Identifica a coluna em Shapes_Items com cadeias que representam os objetos GeoJSON das formas, na coleção de formas ou no formato GeoJSON de forma única. ColumnName Avançadas
ShapeLabels Identifica a coluna em Shapes_Items que contém as etiquetas para as formas. ColumnName Avançadas
ShapeColors Identifica a coluna em Shapes_Items que contém as cores das formas. ColumnName Avançado
Show shape labels Mostra as etiquetas de forma, se fornecidas. Booleano Propriedades; Avançadas: ShowShapeLabels
Enable shape drawing Mostra ferramentas de desenho no mapa. Boolean Propriedades; Avançadas: ShapeDrawing
Enable shape deleting and label editing Determina se o utilizador pode eliminar formas e editar as suas etiquetas. Booleano Propriedades; Avançadas: ShapeEditingDeleting
OnShapeCreated Contém código que é executado quando o utilizador adiciona uma forma ao mapa. Evento Avançadas
OnShapeSelected Contém código que é executado quando o utilizador seleciona uma forma no mapa. Evento Avançadas
OnShapeEdited Contém código que é executado quando o utilizador modifica uma forma no mapa. Evento Avançadas
OnShapeDeleted Contém código que é executado quando o utilizador elimina uma forma no mapa. Evento Avançado

Propriedades de saída

Outras propriedades ficam disponíveis quando um utilizador interage com um mapa. Pode utilizar estas propriedades de saída noutros controlos ou para personalizar a experiência da aplicação.

Propriedade Descrição Tipo
CenterLocation Captura o ponto central do mapa. Não Aplicável
ClickedLocation Captura a última localização selecionada pelo utilizador, .Latitude ou .Longitude. Registo
Selected Captura o marcador selecionado. Registo
SelectedItems Captura o marcador ou marcadores selecionados no cluster selecionado. Tabela
GeocodedItems Captura as localizações geocodificadas dos marcadores. Tabela
RouteWaypoints_Selected Corresponde ao registo da forma selecionada em RouteWaypoints_Items. Registo
RouteWaypoints_SelectedItems Corresponde aos registos das formas sobrepostas selecionadas em RouteWaypoints_Items. Tabela
Shapes_Selected Corresponde ao registo da forma selecionada em Shapes_Items. Registo
Shapes_SelectedItems Corresponde aos registos das formas sobrepostas selecionadas em Shapes_Items. Tabela
SelectedShape Captura o .Perimeter e .Area da forma selecionada. Registo
DeletedShape Captura o .Perimeter e .Area da última forma eliminada. Registo
GeoJSON Captura a lista de formas no formato de Coleção de Funcionalidades GeoJSON. String

Outros controlos geoespaciais

Para ver sugestões de endereços dinâmicos à medida que escreve, utilize o controlo Entrada de endereço.

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).

Limitações conhecidas

  • Necessita de ligação à Internet

Consulte também

Criar uma aplicação com controlos Entrada de endereço e Mapa