Controle Interactive map
Adicione facilmente um mapa interativo aos seus aplicativos de tela. Marcadores de plotagem de uma fonte de dados contendo endereços ou pares de latitude e longitude. Conforme você reduz o zoom, os marcadores opcionalmente agrupam-se para condensar grupos de dados. Em dispositivos móveis e experiências na Web, um mapa pode mostrar a posição atual do usuário e calcular uma rota para o destino do usuário. Os mapas podem ser alternados entre exibições de estrada e satélite.
Recursos de mapa interativo
- Usar uma fonte de dados para inserir marcadores
- Exibir informações sobre marcadores de mapa
- Desenhar e inserir formas
Pré-requisitos
Você precisará preencher alguns pré-requisitos para poder usar mapas em seus aplicativos de tela.
Adicionar um mapa a uma tela do aplicativo
Com o aplicativo aberto para edição no Power Apps Studio:
- Selecione a guia Inserir e expanda Mídia.
- Selecione Mapa para colocar um mapa na tela do aplicativo, ou arraste o controle para a tela de modo a posicioná-lo com mais precisão.
Propriedades
Altere o comportamento e a aparência de um mapa usando as propriedades. Algumas propriedades estão disponíveis apenas na guia Avançado.
| Propriedade | Descrição | Tipo | Guia |
|---|---|---|---|
| Locations(Items) | Identifica uma fonte de dados (Items) na forma de uma tabela em uma pasta de trabalho do Excel da qual obter locais a serem mostrados no mapa. A tabela lista conjuntos de longitudes e latitudes, ou endereços físicos, para exibir como marcadores. Cada linha deve ter uma entrada para rótulo, longitude e latitude, ou um endereço físico e, opcionalmente, a cor e o ícone do marcador. | Não aplicável | Propriedades; Avançado: Items |
| Transparency | Determina a transparência do mapa, de 0 (opaco) a 100 (transparente). | Inteiro | Propriedades; Avançado: Transparency |
| Visible | Mostra ou oculta o mapa. | Booliano | Propriedades; Avançado: Visible |
| Position | Coloca o canto superior esquerdo do mapa nas coordenadas da tela especificadas em x e y. | Número de ponto flutuante | Propriedades; Avançado: X, Y |
| Size | Determina o tamanho do mapa usando os valores de pixel fornecidos em Width e Height. | Inteiro | Propriedades; Avançado: Width, Height |
| Use default location | Inicializa o mapa em uma localização padrão. | Booliano | Propriedades; Avançado: DefaultLocation |
| Default latitude | Define a coordenada de latitude que o mapa mostrará se Usar localização padrão for habilitada. | Número de ponto flutuante | Propriedades; Avançado: DefaultLatitude |
| Default longitude | Define a coordenada de longitude que o mapa mostrará se Usar localização padrão for habilitada. | Número de ponto flutuante | Propriedades; Avançado: DefaultLongitude |
| Default zoom level | Define o nível de zoom se Usar localização padrão for habilitada, de 0 para 22. | Inteiro | Propriedades; Avançado: DefaultZoomLevel |
| Show current location | Exibe a localização atual do usuário. | Booliano | Propriedades; Avançado: CurrentLocation |
| Current location latitude | Define a coordenada de latitude que o mapa mostrará se Mostrar localização atual for habilitada. Para colocar o marcador na localização atual do usuário, defina essa propriedade para Location.Latitude. | Número de ponto flutuante | Propriedades; Avançado: CurrentLocationLatitude |
| Current location longitude | Define a coordenada de longitude que o mapa mostrará se Mostrar localização atual for habilitada. Para colocar o marcador na localização atual do usuário, defina essa propriedade para Location.Longitude. | Número de ponto flutuante | Propriedades; Avançado: CurrentLocationLongitude |
| Satellite view | Exibe o mapa na exibição de satélite. Deixe essa propriedade desativada para ver o mapa na exibição de estrada. | Booliano | Propriedades; Avançado: SatelliteView |
| Cluster pins | Agrupa marcadores de mapa próximos, em vez de exibi-los individualmente. | Booliano | Propriedades; Avançado: Clustering |
| Zoom control | Mostra o controle de zoom. | Booliano | Propriedades; Avançado: Zoom |
| Compass control | Mostra o controle da bússola. | Booliano | Propriedades; Avançado: Compass |
| Pitch control | Mostra o controle pitch (inclinação). | Booliano | Propriedades: Avançado: Pitch |
| Show info cards | Mostra informações sobre uma localização mapeada quando o usuário a seleciona (Ao clicar) ou aponta para ela (Ao passar o mouse). Se Nenhum for selecionado, nenhuma informação será mostrada. | Enum | Propriedades; Avançado: InfoCards |
| Pin color | Determina a cor dos marcadores mostrados no mapa. | Seletor de cor | Propriedades: Avançado: PinColor |
| Route waypoints(Items) | Mostra os localizadores de rota, conforme fornecido em uma fonte de dados (RouteWaypoints_Items) na forma de uma tabela em uma pasta de trabalho do Excel. Se Nenhum for selecionado, nenhum localizador será mostrado. | Enum | Propriedades; Avançado: RouteWaypoints_Items |
| Enable routing | Determina se o usuário pode solicitar orientações para um local especificado. | Booliano | Propriedades; Avançado: UseRouting |
| Maintain waypoint order | Determina se uma rota calculada mantém os localizadores na ordem fornecida. | Booliano | Propriedades; Avançado: RouteMaintainOrder |
| Optimize route | Determina se uma rota calculada é otimizada para distância, tempo, ou não é otimizada. | Enum | Propriedades: Avançado: RouteOptimization |
| Route travel mode | Determina se uma rota é calculada para um carro ou caminhão, o que pode exigir evitar pontes com certas restrições de altura ou peso. | Enum | Propriedades; Avançado: RouteTravelMode |
| Mostrar formas | Mostra as formas em Shapes_Items. | Booliano | Propriedades; Avançado: ShowShapes |
| Show shape labels | Mostra os rótulos de forma, se fornecidos. | Booliano | Propriedades; Avançado: ShowShapeLabels |
| Enable shape drawing | Mostra as ferramentas de desenho no mapa. | Booliano | Propriedades; Avançado: ShapeDrawing |
| Enable shape deleting and label editing | Determina se o usuário pode excluir formas e editar seus rótulos. | Booliano | Propriedades; Avançado: ShapeEditingDeleting |
| Border radius | Determina o raio do canto da borda do mapa. | Número de ponto flutuante | Propriedades; Avançado: BorderRadius |
| Border | Determina o estilo, a largura e a cor da borda do mapa. | Não aplicável | Propriedades; Avançado: BorderStyle, BorderThickness, BorderColor |
| TabIndex | Especifica a ordem em que o mapa será selecionado se o usuário navegar no aplicativo usando a tecla Tab. | Inteiro | Propriedades; Avançado: Tab index |
| OnItemsChange | Contém código que é executado quando os marcadores no mapa são alterados. | Evento | 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 usuário seleciona o mapa. | Evento | Avançado |
| OnShapeCreated | Contém código que é executado quando o usuário adiciona uma forma ao mapa. | Evento | Avançado |
| OnShapeSelected | Contém código que é executado quando o usuário seleciona uma forma no mapa. | Evento | Avançado |
| OnShapeEdited | Contém código que é executado quando o usuário modifica uma forma no mapa. | Evento | Avançado |
| OnShapeDeleted | Contém código que é executado quando o usuário exclui uma forma no mapa. | Evento | Avançado |
| OnRouteDirectionChange | Contém código que é executado quando o aplicativo detecta que o usuário mudou de direção durante uma rota calculada. | Evento | Avançado |
| OnChange | Contém código que é executado quando qualquer aspecto do mapa é alterado. | Evento | Avançado |
| OnSelect | Contém código que é executado quando o usuário seleciona algo no mapa. | Evento | Avançado |
| ItemsLabels | Identifica a coluna em Itens que contém os rótulos para os marcadores. | ColumnName | Avançado |
| ItemsLatitudes | Identifica a coluna em Itens que contém a posição de latitude dos marcadores. | ColumnName | Avançado |
| ItemsLongitudes | Identifica a coluna em Itens que contém a posição de longitude dos marcadores. | ColumnName | Avançado |
| ItemsAddresses | Identifica a coluna em Itens que contém endereços que representam a localização dos marcadores. | ColumnName | Avançado |
| ItemsColors | Identifica a coluna em Itens que contém as cores dos marcadores. | ColumnName | Avançado |
| ItemsIcons | Identifica a coluna em Itens que contém os ícones dos marcadores. | ColumnName | Avançado |
| Shapes_Items | Identifica uma fonte de dados (Shapes_Items) na forma de uma tabela em uma pasta de trabalho do Excel da qual obter formas a serem mostradas no mapa. Cada linha deve ter uma entrada para a forma (objeto GeoJSON) e (opcionalmente) um rótulo e uma cor. | TableName | Avançado |
| ShapeGeoJSONObjects | Identifica a coluna em Shapes_Items com cadeias de caracteres 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 os rótulos para as formas. | ColumnName | Avançado |
| ShapeColors | Identifica a coluna em Shapes_Items que contém as cores das formas. | ColumnName | Avançado |
| RouteWaypoints_Items | Identifica uma fonte de dados (RouteWaypoints_Items) na forma de uma tabela em uma pasta de trabalho do Excel da qual obter localizadores a serem mostrados no mapa. Cada linha deve ter uma entrada para rótulo, longitude e latitude (ou um endereço físico). | TableName | Avançado |
| RouteWaypointsLabels | Identifica a coluna em RouteWaypoints_Items que contém os rótulos para os localizadores. | ColumnName | Avançado |
| RouteWaypointsLatitudes | Identifica a coluna em RouteWaypoints_Items que contém a posição de latitude dos localizadores. | ColumnName | Avançado |
| RouteWaypointsLongitudes | Identifica a coluna em RouteWaypoints_Items que contém a posição de longitude dos localizadores. | ColumnName | Avançado |
| RouteWaypointsAddresses | Identifica a coluna em RouteWaypoints_Items que contém endereços que representam a localização dos localizadores. | ColumnName | Avançado |
| Tooltip | Determina o texto a ser exibido quando o usuário passa o mouse sobre um visual. | Cadeia de caracteres | Avançado |
| ContentLanguage | Determina o idioma de exibição do mapa, se for diferente do idioma usado no aplicativo. | Cadeia de caracteres | Avançado |
| DisplayMode | Determina se o controle permite a entrada de usuário (Editar), se haverá apenas exibição de dados (Exibir) ou se estará desabilitada (Desabilitado). | Enum | Avançado |
Propriedades de saída
Outras propriedades ficam disponíveis quando um usuário interage com um mapa. Você pode usar essas propriedades de saída em outros controles ou para personalizar a experiência do aplicativo.
| Propriedade | Descrição | Tipo |
|---|---|---|
| CenterLocation | Captura o ponto central do mapa. | Não Aplicável |
| OnMapClick | Captura o último local que o usuário selecionou. | Não Aplicável |
| Selected | Captura o marcador selecionado. | Registro |
| SelectedItems | Captura o(s) marcador(es) selecionado(s) no cluster selecionado. | Tabela |
| GeocodedItems | Captura os locais geocodificados dos marcadores. | Tabela |
| ClickedLocation | Captura o último local que o usuário selecionou, seja .Latitude ou .Longitude. | Registro |
| Shapes_Selected | Corresponde ao registro da forma selecionada em Shapes_Items. | Registro |
| Shapes_SelectedItems | Corresponde aos registros das formas de sobreposição selecionadas em Shapes_Items. | Tabela |
| SelectedShape | Captura .Perimeter e .Area da forma selecionada. | Registro |
| DeletedShape | Captura .Perimeter e .Area da última forma excluída. | Registro |
| GeoJSON | Captura a lista de formas no formato GeoJSON da Coleção de Recursos. | Cadeia de caracteres |
Outros controles geoespaciais
Para ver sugestões de endereços dinâmicas enquanto você digita, use o controle Address input.
Observação
Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)
A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).
Limitações conhecidas
- Requer conexão com a Internet
Consulte também
Comentários
Enviar e exibir comentários de