As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Painel Mapa geográfico **** Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 9.x**. Para espaços de trabalho do Grafana que suportam a versão 12.x do Grafana, consulte. [Trabalhando na versão 12 do Grafana](using-grafana-v12.md) Para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x, consulte [Trabalhar no Grafana versão 10](using-grafana-v10.md). Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md). A visualização do painel Mapa geográfico permite que você visualize e personalize o mapa-múndi usando dados geoespaciais. Você pode definir vários estilos de sobreposição e configurações de visualização do mapa para focar facilmente as características importantes dos dados com base na localização. ## Visualização de mapa A visualização de mapa controla a visualização inicial do mapa quando o dashboard é carregado. **Visualização inicial** A visualização inicial configura como o GeoMap painel é renderizado quando o painel é carregado pela primeira vez. + **Visualização** define o centro do mapa quando o painel é carregado pela primeira vez. + **Ajustar aos dados** ajusta a visualização do mapa com base nas extensões de dados das camadas do mapa e atualiza quando os dados são alterados. + A opção **Dados** permite a seleção da extensão com base nos dados de “Todas as camadas”, uma única “Camada” ou o “Último valor” de uma camada selecionada. + **Camada** poderá ser selecionada se estiver ajustando dados de uma única “Camada” ou do “Último valor” de uma camada. + **Preenchimento** definirá o preenchimento em porcentagem relativa além da extensão dos dados (não disponível somente ao analisar “Último valor”). + **Zoom máximo** define o nível máximo de zoom ao ajustar os dados. + **Coordenadas** definem a visualização do mapa com base em: + **Latitude** + **Longitude** + As visualizações padrão também estão disponíveis, incluindo: + **(0°, 0°)** + **América do Norte** + **América do Sul** + **Europa** + **África** + **Ásia Ocidental** + **Ásia Meridional** + **South-East Ásia** + **Leste Asiático** + **Austrália** + **Oceania** + **Zoom** define o nível de zoom inicial. ## Camadas do mapa A visualização Mapa geográfico é compatível com a exibição de várias camadas. Cada camada determina como você visualiza os dados geoespaciais na parte superior do mapa base. **Tipos** Há três tipos de camadas de mapa para escolher na visualização do Mapa geográfico. + [Camada de marcadores](#v9-panels-geomap-markers) renderiza um marcador em cada ponto de dados. + [Camada do mapa de calor](#v9-panels-geomap-heatmap) visualiza um mapa de calor dos dados. + [Camada GeoJSON](#v9-panels-geomap-geojson) renderiza dados estáticos de um arquivo GeoJSON. Há também cinco tipos de camadas que estão atualmente em alfa. + [Camada Noite/Dia (Alfa)](#v9-panels-geomap-nightday) renderiza uma região noturna ou diurna. + **Ícone no último ponto (alfa)** renderiza um ícone no último ponto de dados. + **GeoJSON dinâmico (alfa)** estiliza um arquivo GeoJSON com base nos resultados da consulta. + **Rota (alfa)** renderiza pontos de dados como uma rota. + [Camada de fotos (Alfa)](#v9-panels-geomap-photos) renderiza uma foto em cada ponto de dados. **Controles de camadas** Os controles de camadas permitem criar camadas, alterar seus nomes, reordenar e excluir camadas. + **Adicionar camada** cria uma camada de dados adicional e configurável para a visualização do mapa geográfico. Quando você adiciona uma camada, você é solicitado a selecionar um tipo de camada. Você pode alterar o tipo de camada em qualquer ponto durante a configuração do painel. Consulte a seção **Tipos de camada** acima para obter detalhes sobre cada tipo de camada. + Os controles de camadas permitem renomear, excluir e reordenar as camadas do painel. + **Editar nome da camada** (ícone de lápis) renomeia a camada. + **Lixeira** exclui a camada. + **A reordenação** (seis dots/grab alças) permite que você altere a ordem das camadas. Os dados nas camadas superiores aparecerão acima dos dados nas camadas inferiores. O painel atualizará a ordem das camadas conforme você arrasta e solta para ajudar a simplificar a escolha da ordem das camadas. Você pode adicionar várias camadas de dados a um único painel do Mapa geográfico para criar visualizações completas e detalhadas. **Local** O painel Mapa geográfico precisa de uma fonte de dados geográficos. Esses dados vêm de uma consulta ao banco de dados, e há quatro opções de mapeamento para seus dados. + **Automático** pesquisa automaticamente os dados de localização. Use esta opção quando sua consulta for baseada em um dos nomes a seguir para campos de dados. + geohash: “geohash” + latitude: “latitude”, “lat” + longitude: “longitude”, “lng”, “long” + pesquisa: “pesquisa” + **Coords** especifica que sua consulta contém dados de coordenadas. Você será solicitado a selecionar campos de dados numéricos para latitude e longitude na consulta do banco de dados. + **Geohash** especifica que sua consulta contém dados de geohash. Você será solicitado a selecionar um campo de dados de string para o geohash da sua consulta de banco de dados. + **Pesquisa** especifica que sua consulta contém dados do nome do local que precisam ser mapeados para um valor. Você será solicitado a selecionar o campo de pesquisa da sua consulta no banco de dados e um dicionário geográfico. O dicionário geográfico é o diretório usado para mapear os dados consultados até um ponto geográfico. ## Camada de marcadores A camada de marcadores permite que você exiba pontos de dados em diferentes formas de marcadores, como círculos, quadrados, triângulos, estrelas e muito mais. Os marcadores têm muitas opções de personalização. + **Cor do marcador** configura a cor do marcador. O padrão `Single color` mantém todos os pontos em uma única cor. Há uma opção alternativa para ter várias cores, dependendo dos valores dos pontos de dados e do limite definido na seção `Thresholds`. + **Tamanho do marcador** configura o tamanho do marcador. O padrão é `Fixed size`, o que torna todos os tamanhos de marcadores iguais, independentemente dos pontos de dados. No entanto, também existe a opção de escalar os círculos para os pontos de dados correspondentes. O tamanho do marcador `Min` e `Max` deve ser definido de forma que a camada do marcador possa ser escalada dentro desse intervalo. + **Tamanho do marcador** permite que você escolha a forma, o ícone ou o gráfico para ajudar a fornecer contexto visual adicional aos seus dados. Escolha entre os ativos incluídos no Grafana, como formas simples ou a biblioteca Unicon. Você também pode especificar um URL contendo um ativo de imagem. A imagem deve ser um gráfico vetorial escalável (SVG). + **Opacidade de preenchimento** configura a transparência de cada marcador. ## Camada do mapa de calor A camada do mapa de calor agrupa vários pontos de dados para visualizar locais com densidades diferentes. Para adicionar uma camada de mapa de calor: Clique no menu suspenso em Camada de dados e escolha `Heatmap`. Da mesma forma como com `Markers`, você recebe opções para determinar quais pontos de dados visualizar e como deseja visualizá-los. + **Valores de ponderação** configuram a intensidade dos clusters do mapa de calor. `Fixed value` mantém um valor de ponderação constante em todos os pontos de dados. Este valor deve estar entre 0 e 1. Semelhante aos marcadores, há uma opção alternativa na lista suspensa para dimensionar automaticamente os valores de ponderação, dependendo dos valores dos dados. + **Raio** configura o tamanho dos clusters de mapas de calor. + **Desfoque** configura a quantidade de desfoque em cada cluster. ## Camada GeoJSON A camada GeoJSON permite selecionar e carregar um arquivo GeoJSON estático do sistema de arquivos. + **URL GeoJSON** fornece uma opção de arquivos GeoJSON que vêm com o Grafana. + **Estilo padrão** controla quais estilos aplicar quando nenhuma regra acima corresponde. + **Cor** configura a cor do estilo padrão + **Opacidade** configura a opacidade padrão + **Regras de estilo** aplicam estilos com base nas propriedades do recurso + **Regra** permite que você selecione um *recurso*, *condição* e *valor* do arquivo GeoJSON para definir uma regra. O ícone de lixeira pode ser usado para excluir a regra atual. + **Cor** configura a cor do estilo para a regra atual + **Opacidade** configura o nível de transparência para a regra atual + **Adicionar regra de estilo** cria regras de estilo adicionais. ## Camada CARTO Uma camada CARTO é dos mapas base [CARTO](https://carto.com/about-us/) Raster. **Opções** + **Tema** Escolha um tema. Pode ser um tema **claro**, um **escuro** ou um **automático**. + **Mostrar rótulos** mostra os detalhes do país na parte superior do mapa. + **Opacidade** de 0 (transparente) a 1 (opaca) ## Camada de blocos XYZ A camada de blocos XYZ é um mapa de uma camada genérica de blocos. **nota** Para obter mais informações sobre camadas genéricas de blocos, consulte [Mapas de blocos da Web](https://en.wikipedia.org/wiki/Tiled_web_map) e [Lista de servidores de blocos do OpenStreetMap](https://wiki.openstreetmap.org/wiki/Tile_servers). **Opções** + **Modelo do URL** **nota** Defina um URL de servidor de blocos válido, com {z}/{x}/{y}, por exemplo: `https://tile.openstreetmap.org/{z}/{x}/{y}.png`. + **Atribuição** define a string de referência para a camada, se exibida nos [controles do mapa](#v9-panels-geomap-controls). + **Opacidade** de 0 (transparente) a 1 (opaca) ## Camada do OpenStreetMap Um mapa do [OpenStreetMap](https://www.openstreetmap.org/about), um banco de dados geográfico mundial colaborativo e gratuito. **Opções** + **Opacidade** de 0 (transparente) a 1 (opaca) ## Camada do ArcGIS Uma camada do [ArcGIS é](https://services.arcgisonline.com/arcgis/rest/services) uma camada de um [ESRI](https://www.esri.com/en-us/about/about-esri/overview) ArcGIS. MapServer **Opções** + **Instância do servidor** para selecionar entre os tipos de mapa a seguir. + Mapa de ruas do mundo + Imagens do mundo + Mundo físico + Topográfico + Topográfico dos EUA + Oceano mundial + Personalizado MapServer (consulte [XYZ](#v9-panels-geomap-xyz) para formatação) + Modelo do URL + Atribuição + **Opacidade** de 0 (transparente) a 1 (opaca) ## Camada Noite/Dia (Alfa) A camada Noite/Dia exibe regiões diurnas e noturnas com base no intervalo de tempo atual. **nota** Para obter mais informações, consulte [Extensões para OpenLayers - DayNight](https://viglino.github.io/ol-ext/examples/layer/map.daynight.html). **Opções** + **Mostrar** alterna a fonte de tempo do intervalo de tempo do painel + **Cor da região noturna** escolhe a cor da região noturna + **Exibir sol** alterna o ícone do sol + **Opacidade** de 0 (transparente) a 1 (opaca) ## Camada de fotos (Alfa) A camada Fotos renderiza uma foto em cada ponto de dados. **nota** Para obter mais informações, consulte [Extensões para OpenLayers - Estilo de foto de imagem](http://viglino.github.io/ol-ext/examples/style/map.style.photo.html). **Opções** + **Campo de origem da imagem** Selecione um campo de string contendo dados de imagem em um dos seguintes formatos: + **URLs de imagem** + Imagem binária **codificada em Base64** (`data:image/png;base64,…`) + **Tipo** selecione o estilo da moldura ao redor das imagens + **Square (Quadrado)** + **Circle (Círculo)** + **Ancorado** + **Fólio** + **Cortar** alterna caso as imagens sejam cortadas para caber + **Sombra** alterna uma caixa de sombra por trás das imagens + **Borda** define o tamanho da borda ao redor das imagens + **Cor da borda** define a cor da borda ao redor das imagens + **Raio** define o tamanho geral das imagens em pixels ## Controles do mapa A interface de controles do mapa contém as opções para informações do mapa e sobreposições de ferramentas a seguir. **Zoom** Esta seção descreve cada um dos controles de zoom. *Mostrar controle de zoom* Exibe controles de zoom no canto superior esquerdo. *Zoom na roda do mouse* Liga ou desliga usando a roda do mouse para aumentar ou diminuir o zoom. **Mostrar atribuição** Exibe a atribuição para camadas do mapa base no mapa. **Mostrar escala** Exibe as informações da escala no canto inferior esquerdo. **nota** Exibe unidades em [m]/[km]. **Mostrar ferramentas de medição** Exibe as ferramentas de medida no canto superior direito. As medições aparecem somente quando esse controle está aberto. + **Clique** para começar a medir + **Continue clicando** para continuar a medição + **Double-click**para finalizar a medição **nota** Quando você altera o tipo de medida ou as unidades, a medida anterior é removida do mapa. Se o controle for fechado e depois reaberto, será exibida a medição mais recente. Uma medida pode ser modificada clicando e arrastando-a. *Comprimento* Obtenha o comprimento esférico de uma geometria. Esse comprimento é a soma das distâncias do grande círculo entre as coordenadas. Para geometrias de várias partes, o comprimento é a soma do comprimento de cada parte. Supõe-se que as geometrias estejam em 'EPSG:3857'. Você pode escolher as seguintes unidades para medidas de comprimento: + **Métrica (m/km)** + **Pés (ft)** + **Milhas (mi)** + **Milhas náuticas (nmi)** *Área* Obtenha a área esférica de uma geometria. Essa área é calculada assumindo que as bordas do polígono sejam segmentos de grandes círculos em uma esfera. Supõe-se que as geometrias estejam em 'EPSG:3857'. Você pode escolher as seguintes unidades para medidas de área: + **Metros quadrados (m²)** + **Quilômetros quadrados (km²)** + **Pés quadrados (ft²)** + **Milhas quadradas (mi²)** + **Acres (acre)** + **Hectare (ha)** **Mostrar depuração** Exibe informações de depuração no canto superior direito do mapa. Isso pode ser útil para depurar ou validar uma fonte de dados. + **Zoom** exibe o nível de zoom atual do mapa. + **Centro** exibe a **longitude** e a **latitude** atuais do centro do mapa. **Dica de ferramenta** + **Nenhum** exibe dicas de ferramentas somente quando um ponto de dados é clicado. + **Detalhes** exibem dicas de ferramentas quando o ponteiro do mouse passa sobre um ponto de dados.