Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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.
Funcionalidades do mapa interativo
- Utilizar uma origem de dados para inserir marcadores
- Mostrar informações sobre alfinetes do mapa
- Mostrar rotas entre os pontos de passagem
- Desenhar e inserir formas
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:
- Selecione o separador Inserir e expanda Suporte de dados.
- 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:
Defina a propriedade Items como Localizações
Defina a propriedade ItemLabels como "Nome"
Defina a propriedade ItemLongitude como "Longitude"
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.
O controlo Mapa tem seis tipos diferentes de propriedades:
- Propriedades de estilo
- Propriedades comportamentais
- Propriedades de marcadores
- Propriedades de rota
- Propriedades de forma
- Propriedades de saída
Propriedades de estilo
| Propriedade | Descrição | Tipo | Separador |
|---|---|---|---|
| Vista satélite | 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. | booleano | Propriedades; Avançadas: Visible |
| Position | Coloca o canto superior esquerdo do mapa nas coordenadas do ecrã especificadas em x e y. | Número de ponto flutuante | Propriedades; Avançadas: X, Y |
| Size | Determina o tamanho do mapa utilizando os valores dos pixels fornecidos em Largura e Altura. | Número inteiro | Propriedades; Avançadas: Width, Height |
| Raio de fronteira | Determina o raio do canto do limite do mapa. | Número de ponto flutuante | 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 |
|---|---|---|---|
| Mostrar cartões informativos | 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 |
| Usar local padrão | Inicia o mapa numa localização predefinida. | booleano | Propriedades; Avançadas: DefaultLocation |
| Latitude padrão | Define a coordenada de latitude que o mapa mostra se Utilizar localização predefinida estiver ativada. | Número de ponto flutuante | Propriedades; Avançadas: DefaultLatitude |
| Longitude padrão | Define a coordenada de longitude que o mapa mostra se Utilizar localização predefinida estiver ativada. | Número de ponto flutuante | Propriedades; Avançadas: DefaultLongitude |
| Nível de zoom padrão | Define o nível de zoom se Utilizar localização predefinida estiver ativada, de 0 a 22. | Número inteiro | Propriedades; Avançadas: DefaultZoomLevel |
| Mostrar localização atual | Apresenta a localização do utilizador. | booleano | Propriedades; Avançadas: CurrentLocation |
| Latitude da localização atual | 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. | Número de ponto flutuante | Propriedades; Avançadas: CurrentLocationLatitude |
| Longitude da localização atual | 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. | Número de ponto flutuante | Propriedades; Avançadas: CurrentLocationLongitude |
| Controlo Zoom | Mostra o controlo Zoom. | booleano | Propriedades; Avançadas: Zoom |
| Controlo Bússola | Mostra o controlo Bússola. | booleano | 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çado |
| ContentLanguage | Determina o idioma de apresentação do mapa, se for diferente do idioma utilizado na aplicação. | String | Avançado |
| OnLoad | Contém código que é executado quando o mapa é carregado. | Evento | Avançado |
| 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çado |
| 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çado |
| ItemsLatitudes | Identifica a coluna em Items que contém a posição de latitude dos marcadores. | ColumnName | Avançado |
| ItemsLongitudes | Identifica a coluna em Items que contém a posição de longitude dos marcadores. | ColumnName | Avançado |
| 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çado |
| ItemsIcons | Identifica a coluna em Items que contém as cores dos ícones. | ColumnName | Avançado |
| Pinos de cluster | Agrupa marcadores de localização de mapa próximos, em vez de os apresentar individualmente. | booleano | Propriedades; Avançadas: Clustering |
| Cor do pino | Determina a cor predefinida dos marcadores mostrados no mapa. Esta cor é substituída pela propriedade ItemsColors, se definida | Seletor de cores | 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 |
|---|---|---|---|
| Habilitar roteamento | Determina se o utilizador pode pedir direções para uma localização especificada. | booleano | Propriedades; Avançadas: UseRouting |
| Pontos de passagem da rota (Itens) | 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çado |
| RouteWaypointsLatitudes | Identifica a coluna em RouteWaypoints_Items que contém a posição de latitude dos pontos de passagem. | ColumnName | Avançado |
| RouteWaypointsLongitudes | Identifica a coluna em RouteWaypoints_Items que contém a posição de longitude dos pontos de passagem. | ColumnName | Avançado |
| RouteWaypointsAddresses | Identifica a coluna em RouteWaypoints_Items que contém endereços que representam a localização de pontos de passagem. | ColumnName | Avançado |
| Manter a ordem dos pontos de passagem | Determina se uma rota calculada mantém os pontos de passagem na ordem fornecida. | booleano | Propriedades; Avançadas: RouteMaintainOrder |
| Otimizar rota | Determina se uma rota calculada é otimizada para distância, tempo ou não é otimizada. | Enum | Propriedades; Avançadas: RouteOptimization |
| Modo de viagem por rota | 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. | Enum | 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 |
|---|---|---|---|
| Mostrar formas | 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çado |
| 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çado |
| ShapeLabels | Identifica a coluna em Shapes_Items que contém as etiquetas para as formas. | ColumnName | Avançado |
| ShapeColors | Identifica a coluna em Shapes_Items que contém as cores das formas. | ColumnName | Avançado |
| Mostrar etiquetas de forma | Mostra as etiquetas de forma, se fornecidas. | booleano | Propriedades; Avançadas: ShowShapeLabels |
| Ativar desenho de forma | Mostra ferramentas de desenho no mapa. | booleano | Propriedades; Avançadas: ShapeDrawing |
| Ativar a exclusão de formas e a edição de rótulos | 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çado |
| OnShapeSelected | Contém código que é executado quando o utilizador seleciona uma forma no mapa. | Evento | Avançado |
| OnShapeEdited | Contém código que é executado quando o utilizador modifica uma forma no mapa. | Evento | Avançado |
| 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.
Limitações conhecidas
- Necessita de ligação à Internet
Consulte também
Criar uma aplicação com controlos Entrada de endereço e Mapa