Operação

Retorna geometrias de pontos para endereços em uma tabela, ou seja, geocodificação. Especifique uma cadeia de endereço na propriedade Pesquisar Texto ou partes estruturadas nas propriedades correspondentes, como País, Rua etc. Combinações também são permitidas. Esta operação requer uma licença especial. Os endereços que não foram encontrados por qualquer motivo não são retornados no resultado.

A funcionalidade oferecida pelo Qlik Geocoding (via AddressPointLookup e PointToAddressLookup) é diferente de outros recursos de pesquisa de localização. O Qlik Geocoding permite pesquisas em nível do endereço, enquanto pesquisas regulares de localização só podem ser tão precisas quanto o nível do CEP.

Ao começar com o Qlik Geocoding, use o modelo referenciado em Configurando o Qlik Geocoding (somente em inglês).

A maioria dos parâmetros vem em duas versões, uma que especifica o valor real, como country="SWE", e outra que especifica um nome de campo do qual o valor real deve ser recuperado, como countryField="CountryIso2".

Retorna as seguintes colunas:

• <coluna chave do conjunto de dados> - a coluna chave do conjunto de dados de entrada.
• Address - o endereço encontrado, formatado para atender aos padrões do país.
• Geometry - o ponto para o item encontrado.
• HouseNumber - o número da casa do item encontrado.
• Street - a rua do item encontrado.
• PostalCode - o código postal do item encontrado.
• City - o nome da divisão administrativa no nível da cidade para o item encontrado.
• Adm1: o nome ou nome abreviado para a divisão administrativa de primeira ordem (estado) do item encontrado.
• CountryIso2 - o código do país para o item encontrado.
• Match: um valor entre 0 e 1 que mostra o quão bom foi a correspondência. Um valor de 1 significa uma correspondência perfeita.
• Todas as colunas, exceto a coluna chave do conjunto de dados, prefixadas com o nome do conjunto de dados.

Os campos retornados podem estar vazios quando não aplicáveis ou quando os dados não estiverem disponíveis.

É compatível com:

• ScriptEval em scripts de carregamento.

Exemplo que geocodifica alguns endereços suecos em que cada item está em cada campo:

Este exemplo mostra a geocodificação em um estilo de texto livre:

Gera compartimentos retangulares ou hexagonais para um conjunto de dados de pontos. Essa é uma maneira de agregar dados de pontos para que uma visão geral dos dados possa ser exibida de forma eficiente.

Retorna as seguintes colunas:

• <coluna chave do conjunto de dados> - a coluna chave do conjunto de dados de entrada.
• BinId - identidade do compartimento.
• BinTable.BinPolygon - o polígono para o compartimento.
• BinTable.CenterPoint - ponto no centro do compartimento.
• Todas as colunas, exceto a coluna chave do conjunto de dados, prefixadas com o nome do conjunto de dados.

É compatível com:

• ScriptEval em scripts de carregamento.

Exemplo que carrega compartimentos hexagonais dos aeroportos dos EUA:

Retorna relações e distâncias entre objetos em um conjunto de dados e os objetos mais próximos em outro, se algum estiver mais próximo do que a distância máxima. O custo também pode ser calculado ao longo das estradas e, nesse caso, opcionalmente, usar o tempo de viagem. Essa operação é útil em muitos casos, não só para obter as relações mais próximas, mas também para obter matrizes de distância entre um conjunto de pontos.

Retorna as seguintes colunas:

• <nome de dataset1>_<nome de dataset2>_RelationId - uma chave gerada para a relação entre as duas geometrias
• <coluna de chave dataset1> - a coluna de chave do dataset1 de entrada.
• <coluna de chave dataset2> - a coluna de chave do dataset2 de entrada.
• Distance - a distância na unidade especificada em costUnit.
• Status - o status retornado é "ok" ou "failed:" seguido por uma mensagem de erro.
• LowResLine - uma versão de baixa resolução da linha de rota, disponível apenas para tipos de distâncias que não sejam bird.
• Todas as colunas, exceto a coluna chave do conjunto de dados dataset1 de entrada, prefixadas com o nome do conjunto de dados.
• Todas as colunas, exceto a coluna chave do conjunto de dados dataset2 de entrada, prefixadas com o nome do conjunto de dados.

É compatível com:

• ScriptEval em scripts de carregamento.

Este exemplo encontra os aeroportos mais próximos dos pontos em uma tabela:

Produz agrupamentos a partir de um conjunto de dados de pontos com base na proximidade geográfica entre os pontos. A geração do cluster é controlada pelo parâmetro de distância, que define a distância que um ponto pode estar do agrupamento ao qual ele pertence. Retorna uma tabela com relações entre pontos e agrupamentos. Também retorna uma tabela unida chamada Agrupamentos com geometrias de agrupamento. Contém os campos ClusterID, ClusterCenter (geometria de ponto) e PointCount. O campo de contagem contém o número de pontos no agrupamento.

Retorna as seguintes colunas:

• <coluna chave do conjunto de dados> - a coluna chave do conjunto de dados de entrada.
• ClusterID - ID do cluster ao qual o ponto pertence
• Clusters.ClusterPoint - ponto central do cluster.
• Clusters.PointCount - número de pontos originais pertencentes ao cluster.
• Todas as colunas, exceto a coluna de chave do conjunto de dados de entrada, prefixadas com o nome do conjunto de dados.

É compatível com:

• ScriptEval em scripts de carregamento.

Esse exemplo agrupa aeroportos nos EUA, de forma que os aeroportos mais próximos de 50 km pertencem a um agrupamento:

Dissolve e simplifica áreas para formar áreas maiores com base no mapeamento entre identidades de área (ou geometrias) antigas e novas identidades de área. Normalmente, é usado para construir áreas personalizadas que são construídas por áreas menores e bem definidas, como áreas postais ou áreas administrativas.

Retorna as seguintes colunas:

• <dissolveField> - o campo especificado como dissolveField em indata.
• DissolvedPolygon - as geometrias das novas áreas dissolvidas.

É compatível com:

• ScriptEval em scripts de carregamento.

O conjunto de dados de geometria é opcional. Se não forem fornecidas, as geometrias deverão estar disponíveis no conjunto de dados de definição de dissolução.

Observe que as sobreposições de polígonos são removidas em todas as resoluções, exceto Fonte.

Este exemplo cria duas regiões, uma consistindo em CA e AZ e outra, em WA e OR:

Retorna uma tabela que mapeia entre a chave em dataset1 e a chave em dataset2 para todos os objetos que se cruzam. Se ambos os conjuntos de dados contiverem polígonos, a área de sobreposição relativa comparada às áreas no respectivo conjunto de dados será retornada.

É possível limitar o número de geometrias que se cruzam no segundo conjunto de dados que devem ser mapeadas para cada geometria no primeiro conjunto de dados especificando intersectsCount. Então, a maioria das geometrias que se cruzam são retornadas na ordem. A operação é simétrica se intersectsCount não for especificado.

Retorna as seguintes colunas:

• <nome de dataset1>_<nome de dataset2>_RelationId - uma chave gerada para a relação entre as duas geometrias
• <coluna de chave dataset1> - a coluna de chave do dataset1 de entrada.
• <coluna de chave dataset2> - a coluna de chave do dataset2 de entrada.
• <nome do dataset1>.RelativeOverlap - a sobreposição em comparação com o polígono no dataset1. Somente retornado se ambos os conjuntos de dados contiverem polígonos. Há uma penalidade de desempenho para solicitar este campo.
• <nome do dataset2>.RelativeOverlap - a sobreposição em comparação com o polígono no dataset2. Somente retornado se ambos os conjuntos de dados contiverem polígonos. Há uma penalidade de desempenho para solicitar este campo.
• Todas as colunas, exceto a coluna chave do conjunto de dados dataset1 de entrada, prefixadas com o nome do conjunto de dados.
• Todas as colunas, exceto a coluna chave do conjunto de dados dataset2 de entrada, prefixadas com o nome do conjunto de dados.

É compatível com:

• ScriptEval em scripts de carregamento.

Este exemplo calcula com quais estados algumas linhas fazem interseção:

Retorna informações de localização e geometrias de ponto para endereços IP em uma tabela. Isso é útil quando você está analisando dados de acesso a serviços da Web. A tabela retornada contém os seguintes campos:

• Campo chave - o mesmo que o campo chave para a tabela de nomes.
• <Campo IP da tabela de endereços> - o mesmo que o campo IP que foi pesquisado. Disponível somente se não for o mesmo que o campo chave.
• IpPoint - o ponto para o item encontrado.
• CountryIso2 - o código do país para o item encontrado.
• Adm1Code: o código da área administrativa de primeira ordem do item encontrado. Observe que esse código nem sempre é compatível com o código retornado pelo serviço de localização.
• City - a cidade do item encontrado.
• Todas as colunas, exceto a coluna de chave do conjunto de dados de entrada, prefixadas com o nome do conjunto de dados.

A geolocalização por IP é inerentemente imprecisa. Para muitos endereços IP, é possível localizar uma cidade, mas, para outros, apenas o país pode ser resolvido.

A melhor prática é enviar apenas a coluna IP para a operação IpLookup. Exemplo que procura alguns endereços IP:

É comum que o mesmo IP seja repetido em várias linhas. Em seguida, melhora o desempenho para filtrar primeiro apenas os IPs exclusivos, como neste exemplo:

Este produto inclui dados GeoLite2 criados pela MaxMind, disponíveis em MaxMind.

Carrega o conjunto de dados sem nenhuma operação aplicada. Isso possibilita carregar todos os formatos compatíveis com o GeoOperations. Observe que Simplify pode ser uma boa alternativa para Load se as geometrias forem detalhadas e de exibição lenta.

Retorna as seguintes colunas:

• Todas as colunas do conjunto de dados.

É compatível com:

• ScriptEval em scripts de carregamento.

Exemplo que carrega códigos postais da Suécia:

Como o WKT tem suporte como formato de geometria para dados em INTABLE, a operação Load é excelente para converter geometrias geográficas carregadas de um banco de dados para o formato de geometria do Sense para que ele possa ser exibido. O exemplo a seguir mostra como converter dados WKT, neste caso a partir da tabela MyWKTData:

Retorna o endereço mais próximo para pontos na lista, também conhecido como geocodificação reversa. Esta operação requer uma licença especial. Os pontos que estão próximos às ruas obterão endereços no nível da rua, caso contrário, voltarão para retornar acertos na área postal ou no nível da cidade. Para pontos muito distantes, nenhum dado é retornado.

Retorna as seguintes colunas:

• <coluna chave do conjunto de dados> - a coluna chave do conjunto de dados de entrada.
• Address - o endereço encontrado, formatado para os padrões de endereço do país.
• Geometry - o ponto para o item encontrado.
• HouseNumber - o número da casa do item encontrado.
• Street - a rua do item encontrado.
• PostalCode - o código postal do item encontrado.
• City - o nome da divisão administrativa no nível da cidade para o item encontrado.
• Adm1 - o nome ou nome abreviado para a divisão administrativa de primeira ordem (estado) do item encontrado.
• CountryIso2 - o código do país para o item encontrado.
• Distance: distância em metros até o endereço encontrado.
• Todas as colunas, exceto a coluna chave do conjunto de dados, prefixadas com o nome do conjunto de dados.

Observe que os campos retornados podem estar vazios onde não se aplicam ou onde os dados não estão disponíveis.

Exemplo que obtém os endereços de alguns pontos:

Calcula rotas, incluindo comprimento e duração, entre dois locais em uma tabela.

Observe que a origem é a coluna de geometria no conjunto de dados. A coluna de destino é especificada nos parâmetros de operação, uma vez que os conjuntos de dados só conhecem uma coluna geométrica.

Se você usar bird como meio de transporte, isso gerará grandes arcos de círculo entre origens e destinos.

Retorna as seguintes colunas:

• <coluna chave do conjunto de dados> - a coluna chave do conjunto de dados de entrada.
• Distance - a distância da rota em metros.
• Duration - o tempo estimado de viagem da rota em segundos.
• Status - o status retornado é "ok" ou "failed:" seguido por uma mensagem de erro.
• LowResLine - uma versão de baixa resolução da linha de rota.
• Todas as colunas, exceto a coluna de chave do conjunto de dados de entrada, prefixadas com o nome do conjunto de dados.

É compatível com:

• ScriptEval em scripts de carregamento.
• ScriptEvalStr em scripts de gráficos para obter a rota.
• ScriptEval em scripts de gráficos para obter a distância ou a duração.

Este é um exemplo que calcula rotas entre pontos em um conjunto de dados:

Este é um exemplo que calcula rotas diretamente em uma camada de linha. A operação é chamada para a seleção sempre que a seleção muda. Normalmente deve haver uma condição de cálculo que seja verdadeira se apenas alguns pontos forem selecionados (caso contrário, é melhor calcular as rotas no script de carregamento). Isso deve ser colocado no script de carregamento para carregar os dados. Por exemplo:

Use a seguinte dimensão na Camada de Linha:

Use uma condição de cálculo na Camada de Linha:

Na propriedade Location, que deve ser definida como Geometria de linha, coloque isso para calcular as rotas de uma posição fixa para os pontos selecionados:

Simplifica as geometrias de linha e área em um conjunto de dados. Frequentemente, é útil carregar dados geográficos com a operação Simplify em vez da operação Load para obter geometrias mais eficientes e de exibição mais rápida.

O grau de simplificação é calculado automaticamente com base na área, no número de objetos e no tamanho dos objetos. Em seguida, é possível ajustar isso para uma resolução maior ou menor com o parâmetro de resolução.

A simplificação da área é feita com um algoritmo que lida com topologias e pode remover lacunas e juntar ilhas.

A simplificação da linha é feita com um algoritmo de redução do ponto de interrupção.

Observe que as sobreposições de polígonos são removidas. Não haverá polígonos sobrepostos na saída.

Retorna as seguintes colunas:

• <coluna chave do conjunto de dados> - a coluna chave do dataset1 de entrada.
• Simplified_<nome da coluna de geometria> - versões simplificadas das geometrias originais.
• Todas as colunas, exceto a coluna chave do conjunto de dados, prefixadas com o nome do conjunto de dados.

É compatível com:

• ScriptEval em scripts de carregamento.

Exemplo que carrega versões simplificadas dos estados dos EUA:

Calcula as áreas ISO de tempo de viagem. Todos os locais dentro da área devolvida podem ser alcançados dentro de um certo tempo ou estão a menos de uma certa distância ao longo das estradas. Retorna uma tabela com id, geometria da área de viagem, ponto central, custo, unidade de custo e status (OK ou falha).

Se você usar "bird" como tipo de transporte, isso gerará círculos geograficamente corretos em torno das origens.

Retorna as seguintes colunas:

• <coluna chave do conjunto de dados> - a coluna chave do conjunto de dados de entrada.
• TravelArea - a geometria do polígono que define a área de viagem.
• Cost - o custo conforme especificado no campo costValue ou costField.
• CostUnit - a unidade de custo conforme especificado em costUnit.
• Status - o status retornado é "OK" ou "failed:" seguido por uma mensagem de erro.
• Todas as colunas, exceto a coluna de chave do conjunto de dados de entrada, prefixadas com o nome do conjunto de dados.

É compatível com:

• ScriptEval em scripts de carregamento.
• ScriptEvalStr em scripts de gráficos para obter a geometria da área de viagem.
• ScriptEval em scripts de gráficos para obter custos.

Este exemplo de script de carregamento gera áreas de viagem de 10 minutos em Miami e Orlando a partir de coordenadas:

Este exemplo de script de carregamento gera áreas de viagem de 10 minutos em Miami e Orlando usando pontos nomeados:

Este é um exemplo que calcula Áreas de Viagem em torno de pontos diretamente em uma camada de área. A operação é chamada para a seleção sempre que a seleção muda. Isso deve ser colocado no script de carregamento para carregar os dados para o exemplo:

Use a seguinte dimensão na camada de área:

Use uma condição de cálculo na camada de área:

Na propriedade Location, coloque isto:

Retorna as relações entre dois conjuntos de dados onde uma geometria em um conjunto de dados (incluída) está completamente dentro da área no outro conjunto de dados (delimitada). Retorna uma tabela que mapeia entre a chave em incluída e a chave em incluindo para todas as relações encontradas.

Use normalmente para descobrir em quais áreas os dados estão; por exemplo, para testar a posição do GPS para qual área administrativa eles estão. Esse é um tipo de geocodificação reversa.

Retorna as seguintes colunas:

• <nome delimitado>_<nome delimitador>_RelationId - uma chave gerada para a relação entre as duas geometrias.
• <coluna de chave fechada> - a coluna de chave do dataset1 de entrada.
• <coluna de chave delimitadora> - a coluna de chave do dataset2 de entrada.
• Todas as colunas, exceto a coluna chave do conjunto de dados delimitado, prefixadas com o nome do conjunto de dados.
• Todas as colunas, exceto a coluna chave do conjunto de dados delimitador, prefixadas com o nome do conjunto de dados.

É compatível com:

• ScriptEval em scripts de carregamento.

Para compensar imprecisões nos dados, às vezes é melhor usar Closest em vez de Within. Por exemplo, se você tiver dados de pontos em áreas costeiras que deseja relacionar a áreas administrativas, pequenas imprecisões podem fazer com que os pontos fiquem um pouco fora das áreas.

Este é um exemplo de script de carregamento que calcula quais pontos estão dentro de quais estados: