Skip to main content

Aplicativo de geocodificação do Alteryx

O Aplicativo de geocodificação do Alteryx usa várias ferramentas Alteryx diferentes para limpar e atribuir endereços dos EUA à melhor correspondência de localização física possível, conforme designado por latitude e longitude. O aplicativo analítico é uma interface independente que permite especificar certos parâmetros e executar o processo de geocodificação.

Importante

Para executar este aplicativo, você deve ter uma licença de execução do Alteryx e ter instalados o Alteryx, o Alteryx Geocoder e, opcionalmente, os codificadores CASS e ZIP +4.

Configurar o aplicativo analítico

Arquivo de entrada

Selecione o método de entrada.

Geocodificação de múltiplos endereços pela seleção de um arquivo contendo dados de endereços.

Se o arquivo ainda não foi executado com este aplicativo e a caixa estiver marcada, você receberá um erro.

  • Escolha um arquivo a ser geocodificado: navegue até o arquivo que deseja geocodificar.

  • Geocodificar somente registros não codificados: o geocodificador ignora registros que já tenham passado por este processo e somente codifica aqueles registros cujo campo GEO_GeoLevel está definido como "Não codificado".

Geocodificar um único endereço digitando um endereço manualmente.

  • Especificar o endereço para o geocódigo. Todos os campos são obrigatórios: digite as informações no campo apropriado.

Quando as seleções estiverem definidas, selecione Próximo.

Opções do geocodificador

Escolher um geocodificador: use o menu suspenso para Selecionar um geocodificador na lista disponível.

Habilitar pontos de endereço do Multinet da TomTom

  • Corresponder e geocodificar: quando selecionado, os registros de entrada são comparados com o arquivo do banco de dados Calgary de pontos de endereço do Multinet da TomTom. Este arquivo inclui aproximadamente 80 milhões de pontos de endereço localizados pelo terreno ou colocados diretamente na estrutura. Qualquer registro que não corresponda a este arquivo será geocodificado como normal.

    Requisito de instalação da licença

    Esta opção requer uma instalação licenciada do arquivo de banco de dados Calgary de pontos de endereço do Multinet da TomTom, e o codificador CASS deve estar habilitado.

  • Não corresponder ao arquivo, somente geocodificar: quando selecionado, os registros de entrada serão geocodificados da forma habitual.

Habilitar modo interativo

Ao geocodificar no modo interativo, é possível editar interativamente o endereço de entrada e se comunicar diretamente com o geocodificador para atribuir uma correspondência.

A caixa "Mudar a entrada de geocodificação" será iniciada quando o geocodificador não puder atribuir uma correspondência automaticamente. Os incidentes que iniciarão esta caixa podem incluir: uma correspondência múltipla é detectada, o endereço pode ter um alias, a correspondência mais próxima pode produzir uma pontuação menos favorável, ou talvez a única correspondência possível seja um código postal. Se você tiver suficiente familiaridade com os dados de entrada, você pode fazer as edições apropriadas no endereço original para que o geocodificador atribua a correspondência apropriada.

Endereço original exibe o modo como o registro aparece no seu estado nativo no arquivo de entrada.

Editar endereço é a área em que o usuário final pode escrever e editar o endereço.

A qualquer momento, o usuário final pode clicar em Geocodificação para ver o que o geocodificador pode reconhecer como uma possível correspondência. As correspondências possíveis aparecem na caixa Saída de endereço editado.

Selecione uma correspondência e, em seguida, selecione Aceitar. Depois de aceitar uma correspondência, o endereço original será substituído pelo endereço aceito.

Para passar para o endereço seguinte, selecione Próximo registro e repita o processo.

O texto "Registro atual" exibe por quantos registros você já passou e o número total de registros na fila.

Selecione Concluído para encerrar o processo interativo.

  • Permitir modo interativo: o modo interativo permite editar um endereço que o geocodificador não consegue ler nativamente para que o mesmo possa então ser geocodificado.

  • Não permitir modo interativo: se você não permitir o modo interativo, não serão oferecidas opções para identificar correspondências múltiplas ou para editar um endereço.

Campos de geocodificação

Selecionar os campos de saída do geocodificador: as variáveis de saída disponíveis dependem do produto geocodificador utilizado. Marque as caixas ao lado dos campos apropriados para acrescentar à tabela de dados geocodificados. Opções à direita permitem Selecionar tudo, Selecionar padrões ou Limpar tudo. Vá para a ferramenta Geocodificador de Rua.

Você também pode selecionar Campos de saída avançados do geocodificador.

Quando as opções estiverem definidas, selecione Próximo.

Opções do CASS

Habilitar codificação do CASS: por padrão, o CASS está habilitado para permitir que a geocodificação faça a correspondência com os pontos de endereço do Multinet da TomTom e para fornecer a codificação ZIP+4.

Selecionar campos CASS para saída: marque as caixas ao lado dos campos apropriados para acrescentar à tabela de dados geocodificados. As opções à direita permitem Selecionar tudo, Selecionar padrões ou Limpar tudo. Acesse ferramenta CASS para obter mais informações.

Você também pode Selecionar campos CASS avançados.

Quando as opções estiverem definidas, selecione Próximo.

Se o CASS estiver desabilitado, não será possível corresponder ao banco de dados de pontos de endereço ou ao código ZIP 4 do seu arquivo de endereço.

Codificador ZIP+4

Usar ZIP+4 para registros com falhas: por padrão, o ZIP+4 está ativado.

Escolher os campos de codificação ZIP+4: marque as caixas ao lado dos campos apropriados para acrescentar à tabela de dados geocodificados. As opções à direita permitem Selecionar tudo, Selecionar padrões ou Limpar tudo. Acesse ferramenta Codificador ZIP9 dos EUA para obter mais informações.

Quando as opções estiverem definidas, selecione Próximo.

Se o CASS estiver desabilitado, não será possível codificar seu arquivo de endereço com o ZIP+4.

Arquivos de saída

Escolher um arquivo para guardar os resultados de geocodificação: navegue até o local do arquivo a ser gravado com os resultados da geocodificação. O arquivo de sumário inclui os níveis para os quais os registros são geocodificados e a contagem dos registros nesse geonível.

Criar um arquivo de sumário do geocodificador: se você optar por enviar o sumário, use Escolher arquivo para o sumário do geocodificador para navegar até o local do arquivo de destino.

Salvar os registros não codificados interativamente em um arquivo separado: se optar por produzir resultados não codificados, utilize os Registros não codificados interativamente para procurar um local para o arquivo de destino.

Quando as opções estiverem especificadas, selecione Concluir.

Ao selecionar um arquivo de saída para os registros geocodificados resultantes, não é recomendável substituir o arquivo de entrada.

Solução de problemas

Estas são mensagens de erro comuns que um usuário pode encontrar se o aplicativo analítico estiver configurado incorretamente, ou se houver algo de errado no arquivo de entrada.

É necessário especificar um arquivo de entrada: um arquivo de entrada não foi especificado. Além disso, você receberá este erro se o arquivo de entrada especificado não incluir algum dos campos obrigatórios: endereço, cidade, estado ou código postal.

É necessário especificar um arquivo de saída: um arquivo de saída não foi especificado.

O CASS deve ser selecionado para usar o codificador ZIP+4: o codificador ZIP+4 é definido para utilizar os dados gerados pelo ZIP+4 no processo do CASS. Se o processo CASS não estiver habilitado, este erro será exibido. Retorne e habilite o CASS, ou desative o codificador ZIP+4 para continuar.

Há os seguintes erros: Filtrar (244): Erro de análise no caractere (9): Variável desconhecida "GEO_GeoLevel": na guia Arquivo de Entrada, a caixa opcional está marcada E o arquivo de entrada especificado ainda não passou pelo processo do aplicativo analítico de geocodificação.

Outro motivo pelo qual você pode receber este erro é se você tentar inserir um arquivo .dbf como saída resultante de uma execução anterior do geocodificador. Os arquivos .dbf têm limitações de comprimento de campo e, por isso, os campos são automaticamente truncados. Tente usar tipos de arquivos sem limitações, como um arquivo da base de dados do Alteryx (.yxdb)

Fórmula (2): Erro de análise no caractere (0): incompatibilidade de tipos. Número fornecido onde uma cadeia de caracteres (string) é exigida. (Expressão n. 1): verifique o arquivo de entrada. Seu campo de código postal provavelmente está como um número, mas deve ser uma cadeia de caracteres (string). É possível reformatar este campo, salvar o arquivo e tentar novamente. Ou salve seu arquivo como um arquivo *.csv e todos os campos serão lidos como texto.

Compreendendo os códigos retornados

Há uma série de códigos retornados no processo de geocodificação resultante. A seguir, você encontrará uma breve explicação de alguns deles. Mais informações podem ser encontradas no arquivo de "Ajuda do Alteryx" no diretório de execução do Alteryx:

\Arquivos de Programas\Alteryx\bin\RuntimeData\AlteryxHelp.chm

Existem motores diferentes que geram campos diferentes. O "Prefixo de campo" indica qual processo gerou quais campos:

  • GEO: indica que o geocodificador retornou o campo

  • CASS: indica que o codificador CASS retornou o campo

  • ZIP9: indica que o codificador ZIP+4 retornou o campo.

GEO_GeoLevel e GEO_MatchStatus

Estes dois campos são talvez os mais importantes a serem retornados e trabalham em conjunto para descrever o êxito da geocodificação.

O Geonível (Geolevel) é o nível para o qual o seu registro foi geocodificado. Existem oito geoníveis possíveis na ordem do melhor para o pior:

  • Real: o endereço tem correspondência com o arquivo de pontos de endereço do Multinet da TomTom e representa a localização real e física da propriedade.

  • Rua: o endereço está atribuído à sua localização interpolada de rua.

  • Intersecção: o endereço está atribuído à intersecção de várias ruas.

  • Extrapolação: quando um endereço de entrada está fora do intervalo, o geocodificador atribui o endereço ao segmento de rua válido mais próximo conhecido.

  • ZIP9: o endereço está atribuído ao código postal de nove dígitos ou ao ZIP+4.

  • ZIP7: o endereço está atribuído à correspondência de código postal de sete dígitos (não comum, os dois primeiros dígitos do ZIP+4).

  • ZIP5: o endereço está atribuído ao centroide do código postal.

  • Não codificado: não há correspondência.

O Status da correspondência é como o registro correspondeu ao geonível. Os valores possíveis por ordem de preferência são:

  1. Exato

  2. Múltiplo

A melhor combinação possível é GEO_GeoLevel==Street e MatchStatus==Exact

Quando o GEO_MatchStatus==Exact e o GEO_GeoLevel==ZIP5, o registro correspondeu exatamente ao nível ZIP5. Não se trata de uma correspondência a nível de rua.

GEO_FirstLineChanged e GEO_LastLineChanged

Estes campos são booleanos, portanto, os únicos valores retornados são VERDADEIRO (True) ou FALSO (False). Significa que o geocodificador retornou um endereço correspondente em que o formato do endereço de entrada original era diferente. Talvez uma direção tenha sido adicionada, uma abreviatura de rua tenha sido aplicada ou o código postal era diferente. Essas instâncias retornariam valores VERDADEIRO (True).