Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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
- Mostrar rotas entre localizadores
- Desenhar e inserir formas
Pré-requisitos
Você precisará preencher alguns pré-requisitos para poder usar mapas em seus aplicativos de tela. Consulte a tabela de privacidade e segurança para obter mais detalhes sobre como os diferentes recursos de mapa usam dados.
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.
Adicionando marcadores, rotas e formas
Marcadores, rotas e formas são propriedades do conjunto de dados que precisam identificar um fonte de dados, que é uma tabela de uma coleção ou conector, e as colunas relevantes. O fonte de dados é 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 exemplo, ItemLatitudes, ItemLongitudes, etc. para marcadores). A seção Propriedades contém informações adicionais sobre esses conjuntos de dados e suas propriedades relacionadas.
Por exemplo, se você tivesse uma coleção de tabelas chamada Localizações com as colunas Nome, Longitude e Latitude:
| Nome | Longitude | Latitude |
|---|---|---|
| Fourth Coffee (exemplo) | -98,29277 | 26.2774 |
| Litware, Inc. (exemplo) | -96,85572 | 32,55253 |
| Adventure Works (exemplo) | -96,99952 | 32,72058 |
Para exibi-los como marcadores rotulados 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 de coluna relevantes precisam estar entre aspas nas propriedades relacionadas. A fonte de dados não deve ter aspas.
Você pode ver como fazer para exibir marcadores de uma planilha do Excel ou criar um aplicativo que use o controle de entrada de endereço para popular marcadores no controle de mapeamento como exemplos adicionais.
Observação
- Cada controle de mapeamento pode exibir até 5.000 marcadores de latitude ou longitude e 50 marcadores de endereços. O limite de marcadores é menor para endereços, pois o mapa precisa codificar geograficamente esses endereços em latitude ou longitude para exibi-los. Recomendamos não usar endereços sempre que possível. É possível salvar endereços codificados geograficamente na fonte de dados.
- Quando latitude ou longitude e um endereço forem fornecidos para um único marcador, o controle de mapeamento priorizará usando latitude ou longitude para evitar a codificação geográfica do endereço.
- O número máximo de formas que podem ser desenhadas em um controle de mapeamento é limitado a 500.
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.
O controle de mapeamento tem seis tipos diferentes de propriedade:
- Propriedades de estilo
- Propriedades comportamentais
- Propriedades de marcador
- Propriedades de rota
- Propriedades de forma
- Propriedades de saída
Propriedades de estilo
| Propriedade | Descrição | Tipo | Guia |
|---|---|---|---|
| Exibição satélite | Exibe o mapa na exibição de satélite. Deixe essa propriedade desativada para ver o mapa na exibição de estrada. | booleano | Propriedades; Avançado: SatelliteView |
| Estilo de mapa | Define o estilo do mapa. Opções: Rodoviário, Noite, Relevo sombreado de estrada, Satélite, Rótulos de rodovia por satélite, Alto contraste – claro, Alto contraste – escuro, Escala de cinza claro, Escala de cinza escuro. | Enumeração | Propriedades |
| Transparency | Determina a transparência do mapa, de 0 (opaco) a 100 (transparente). | Inteiro | Propriedades; Avançado: Transparency |
| Visible | Mostra ou oculta o mapa. | booleano | 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 |
| Raio da borda | 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 |
| 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). | Enumeração | Avançado |
Propriedades comportamentais
| Propriedade | Descrição | Tipo | Guia |
|---|---|---|---|
| Mostrar cartões de informações | 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. | Enumeração | Propriedades; Avançado: InfoCards |
| Usar localização padrão | Inicializa o mapa em uma localização padrão. | booleano | Propriedades; Avançado: DefaultLocation |
| Latitude padrão | 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 |
| Longitude padrão | 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 |
| Nível de zoom padrão | Define o nível de zoom se Usar localização padrão for habilitada, de 0 para 22. | Inteiro | Propriedades; Avançado: DefaultZoomLevel |
| Mostrar localização atual | Exibe a localização atual do usuário. | booleano | Propriedades; Avançado: CurrentLocation |
| Latitude do local atual | Define a coordenada de latitude do marcador de localização atual que o mapa mostrará se Mostrar localização atual estiver 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 |
| Longitude do local atual | Define a coordenada de longitude do marcador de localização atual que o mapa mostrará se Mostrar localização atual estiver 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 |
| Controle de zoom | Mostra o controle de zoom. | booleano | Propriedades; Avançado: Zoom |
| Controle da bússola | Mostra o controle da bússola. | booleano | Propriedades; Avançado: Compass |
| Controle de rotação sobre o eixo X | Mostra o controle pitch (inclinação). | booleano | Propriedades: Avançado: Pitch |
| 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 |
| 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 |
| 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. A latitude e longitude do ponto clicado estão na propriedade de saída ClickedLocation. | 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 |
Propriedades de marcador
| Propriedade | Descrição | Tipo | Guia |
|---|---|---|---|
| Locations(Items) | Identifica uma fonte de dados (Items) na forma de uma tabela 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. O uso de latitude ou longitude é recomendado, pois os endereços precisam ser codificados geograficamente e, assim, têm um limite de marcadores mais restritivo. A tabela pode ser uma coleção ou de um fonte de dados como o Excel Online. 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 |
| 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. Há um limite de quantos marcadores podem ser exibidos a partir de endereços. O recomendável é geocodificar seus endereços para pares de latitude e longitude e usá-los para exibir marcadores quando possível. | 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 |
| Marcadores do cluster | Agrupa marcadores de mapa próximos, em vez de exibi-los individualmente. | booleano | Propriedades; Avançado: Clustering |
| Cor do marcador | Determina a cor padrão dos marcadores mostrados no mapa. Essa cor é substituída pela propriedade ItemsColors, se definida | Seletor de cor | Propriedades: Avançado: PinColor |
| OnItemsChange | Contém código que é executado quando os marcadores no mapa são alterados. | Evento | Avançado |
Propriedades de rota
| Propriedade | Descrição | Tipo | Guia |
|---|---|---|---|
| Habilitar o roteamento | Determina se o usuário pode solicitar orientações para um local especificado. | booleano | Propriedades; Avançado: UseRouting |
| Pontos de passagem (Itens) | Mostra os localizadores de rota, conforme fornecido em uma fonte de dados (RouteWaypoints_Items) na forma de uma tabela. A tabela pode ser uma coleção ou de um fonte de dados como o Excel Online. Se Nenhum for selecionado, nenhum localizador será mostrado. | Enumeração | Propriedades; Avançado: RouteWaypoints_Items |
| 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 |
| Manter a ordem do ponto de passagem | Determina se uma rota calculada mantém os localizadores na ordem fornecida. | booleano | Propriedades; Avançado: RouteMaintainOrder |
| Otimizar rota | Determina se uma rota calculada é otimizada para distância, tempo, ou não é otimizada. | Enumeração | Propriedades: Avançado: RouteOptimization |
| Modo de viagem por rota | 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. | Enumeração | Propriedades; Avançado: RouteTravelMode |
| 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 |
Propriedades de forma
| Propriedade | Descrição | Tipo | Guia |
|---|---|---|---|
| Mostrar formas | Mostra as formas em Shapes_Items. | booleano | Propriedades; Avançado: ShowShapes |
| Shapes_Items | Identifica uma fonte de dados (Shapes_Items) na forma de uma tabela da qual obter formas a serem mostradas no mapa. A tabela pode ser uma coleção ou de um fonte de dados como o Excel Online. 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 |
| Mostrar rótulos de forma | Mostra os rótulos de forma, se fornecidos. | booleano | Propriedades; Avançado: ShowShapeLabels |
| Habilitar desenho de forma | Mostra as ferramentas de desenho no mapa. | booleano | Propriedades; Avançado: ShapeDrawing |
| Habilitar a edição de rótulos e a exclusão de formas | Determina se o usuário pode excluir formas e editar seus rótulos. | booleano | Propriedades; Avançado: ShapeEditingDeleting |
| 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 |
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 |
| ClickedLocation | Captura o último local que o usuário selecionou, seja .Latitude ou .Longitude. | Registro |
| Selecionado(s) | 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 |
| RouteWaypoints_Selected | Corresponde ao registro da forma selecionada em RouteWaypoints_Items. | Registro |
| RouteWaypoints_SelectedItems | Corresponde aos registros das formas de sobreposição selecionadas em RouteWaypoints_Items. | Tabela |
| 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 Entrada de endereço.
Limitações conhecidas
- Requer conexão com a Internet
Confira também
Criar um aplicativo com controles Entrada de endereço e Mapa