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.
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 |
|---|---|---|---|
| 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
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários