Skip To Content

Arquivos CSV, TXT e GPX

Você pode utilizar dados da planilha armazenados em um arquivo de texto de valores separados por vírgula (.csv) ou dados armazenados em um arquivo de texto delimitado (.txt) ou arquivo Formato de Intercâmbio do GPS (.gpx) em seu portal ArcGIS Enterprise. A lista seguinte resume como você pode utilizar estes arquivos e fornece links para instruções. As seções após a lista de funcionalidades fornece informações em formatação e dicas adequadas para utilizar arquivos CSV, TXTe GPX em seu portal do Enterprise .

  • Adicione arquivos CSV, TXT ou GPX no seu mapa. O Map Viewer adiciona as informações de localização, desenha feições no mapa para cada item no arquivo e armazena as informações no mapa como uma camada. Após adicionar o arquivo no mapa, você pode editar as propriedades da camada que é criada. Por exemplo, você pode configurar pop-ups, alterar símbolos, configurar a faixa de visibilidade, habilitar edição e remover pop-ups.
  • Adicione um arquivo de CSV que não contém informações de localização no Map Viewer como uma tabela. Isto é útil quando você desejar ligar dados não espaciais—por exemplo, reivindicações de dano de propriedade relacionados a um tornado recente—para dados espaciais, como uma camada ZIP Codes, utilizando a ferramenta de análise Ligar Feições.
  • Se o arquivo CSV estiver armazenado em um site da web publicamente acessível, você pode referenciá-lo a partir do mapa como uma camada na web. Se o arquivo CSV contém informações de coordenadas, as atualizações feitas no arquivo CSV na web aparecerá no mapa. Se o arquivo CSV contém informações endereço e local, as atualizações feitas no arquivo CSV na web não serão refletidas no mapa.
  • Adicione os arquivos de CSV ao seu portal e compartilhe-os de forma que outros possam baixar os dados.
  • Se você tiver privilégios para publicar camadas de feição hospedadas, você pode publicar os dados em arquivos CSV.

Arquivos CSV e TXT

Os arquivos CSV e TXT armazenam informações em texto. A primeira linha no arquivo define os nomes para todos os campos subsequentes. Os campos podem ser separados com vírgula, ponto-vírgula ou tabulação. Outros separadores não são suportados.

Como nenhum tipo de dado é obrigatório no arquivo, o ArcGIS Enterprise conta com os nomes de campo e formatação específica nos campos para interpretar o tipo de dados que deve ser aplicado.

As seções seguintes contêm informações sobre formatos suportados para dados de localização em arquivos CSV e TXT, formatos e considerações suportadas ao utilizar dados de data e hora em arquivos CSV, e o que você precisa considerar ao adicionar arquivos CSV e TXT files ao Map Viewer.

Campos de localização em arquivos de CSV e TXT

Para adicionar um arquivo CSV ou TXT a partir de uma drive local ou um arquivo CSV na web para seu mapa como uma camada de feição ou publicar um arquivo local CSV como uma camada de feição hospedada, o arquivo deve incluir campos de localização. Os campos de localização podem conter latitude e longitude, endereços ou informações de local. A primeira linha do arquivo deve conter os nomes de campo de localização. Os endereços podem ser armazenados em um ou mais campos; latitude e longitude deve ser armazenado em dois campos.

Se o arquivo tiver campos de latitude e longitude, o Map Viewer utiliza estes campos para localizar as feições no mapa. Se o Map Viewer não pode determinar as informações de latitude e longitude ou se seu arquivo contém endereço ou informações de lugar, você é solicitado para revisar os campos de localização e alterá-los se necessário. Note que as informações de latitude e longitude devem estar em graus decimais.

Os campos de localização seguintes são suportados:

  • Latitude, Longitude
  • Lat, Long
  • Longitude83, Latitude83
  • Longdecdeg, Latdecdeg
  • Long_dd, Latdd
  • Lng
  • Y, X
  • Ycenter, Xcenter
  • Xcenter, Ycenter
  • Ponto y, Ponto x
  • Point-x, Point-y
  • Endereço
  • Cidade
  • Estado
  • CEP

Data e hora em arquivos CSV

Os campos de data em arquivos CSV são assumidos para conter a data e hora do Universal Time Coordinated (UTC). As datas são assumidas para serem UTC, pois o local físico do servidor que hospeda seus dados pode estar em qualquer lugar no mundo. A alternativa de armazenar data e hora em um fuso horário local leva a todos os tipos de problemas, especialmente se você, ou o servidor que hospeda seus dados, mover para outro fuso horário.

Sempre que um campo de data é exibido, a data é convertida do horário UTC para seu horário local. Isto é feito ao consultar seu computador e solicitar por sua configuração de fuso horário. Por exemplo, suponha que seu computador esteja configurado para Pacific Standard Time (PST). PST é oito horas antes de UTC—quando o horário UTC for 10:00 AM, ele será 2:00 AM PST.

Quando você publica uma camada de feição hospedada a partir de um arquivo CSV, é possível especificar o fuso horário dos dados. O fuso horário especificado é utilizado para mitigar o deslocamento, pois o ArcGIS Enterprise assume que os dados de data e hora estão em UTC. Por exemplo, quando um arquivo CSV contendo campos de data é publicado com PST selecionado como o fuso horário, todos os valores de data e hora em seu arquivo CSV terão oito horas adicionadas como parte da conversão para UTC.

Se os campos de data em seu arquivo CSV tiverem uma data, mas não um valor de hora, um valor de hora de meia-noite será atribuído quando você publicar uma camada de feição hospedada. Então, se você não especificar um fuso horário ao publicar, seus dados serão armazenados com um valor de hora da meia-noite (UTC). Quando você visualizar os dados, a hora será convertida para hora local, potencialmente alterando a data. Por exemplo, 7/28/2009 0:00 é meia-noite (UTC) em 28 de Julho de 2009. Se você visualizar os dados de um computador no fuso horário do pacífico padrão, a data e hora serão exibidas como 7/27/2009 16:00. A especificação de fuso horário ao publicar elimina este deslocamento quando visualizada no fuso horário especificado.

As datas seguintes são suportadas se você publicar uma camada de feição hospedada de um arquivo de CSV:

FormatoExemplo

M/DD/YYYY

7/28/2009

MM/DD/YYYY

07/28/2009

M/DD/YY

7/28/09

MM/DD/YY

07/28/09

YYYY/MM/DD

2009/07/28

YYYY-MM-DD

28/07/2009

YYYY/MM/DD hh:mm:ss

2009/07/28 17:23:00

YYYY/M/DD hh:mm:ss

2009/7/28 17:23:00

YYYY-MM-DD hh:mm:ss

28/07/2009 17:23:00 am

YYYY-M-DD hh:mm:ss

28/07/2009 17:23:00 am

Anotação:

Se um campo configurado como um campo de data tiver um formato inválido ou sem suporte, o campo será criado como tipo de dados de string na camada de feição hospedada resultante ainda que você altera o tipo de campo antes de publicar.

Se você adicionar um arquivo CSV diretamente no Map Viewer, os formatos de dados seguintes são carregados como datas, mas os tempos não aparecem na tabela no Map Viewer:

FormatoEntrada de exemploValor da tabela

M/DD/YYYY formato 12 horas

28/07/2009 17:23 am

28 de julho de 2009

MM/DD/YYYY formato 12 horas

28/07/2009 17:23 am

28 de julho de 2009

M/DD/YY formato 12 horas

28/07/2009 17:23 am

28 de julho de 2009

MM/DD/YY formato 12 horas

28/07/2009 17:23 am

28 de julho de 2009

Se você adicionar um arquivo CSV diretamente no Map Viewer, os formatos de datas seguintes são carregados como campos de string exatamente como eles aparecem no arquivo CSV:

FormatoEntrada de exemplo

M/DD/YYYY

7/28/2009

MM/DD/YYYY

07/28/2009

M/DD/YYYY formato 24 horas

28/07/2009 17:23 am

MM/DD/YYYY formato 24 horas

28/07/2009 17:23 am

M/DD/YY

7/28/09

MM/DD/YY

07/28/09

M/DD/YY formato 24 horas

28/07/2009 17:23 am

MM/DD/YY formato 24 horas

28/07/2009 17:23 am

Mês DD

28 de Julho

YYYY/MM

2009/07

YYYY-MM

2009-07

YYYY/MM/DD

2009/07/28

YYYY-MM-DD

28/07/2009

YYYY/MM/DD hh:mm:ss

2009/07/28 17:23:00

YYYY-MM-DD hh:mm:ss

28/07/2009 17:23:00 am

YYYY/MM/DD hh:mm:ss.s

2009/07/28 17:23:00.0

YYYY-MM-DD hh:mm:ss.s

2009-07-28 17:23:00.0

Considerações para publicar campos de data em arquivos CSV

  • O menu suspenso Fuso Horário aparece na janela Item do meu computador mesmo que seu arquivo CSV não tenha campos de data.
  • Quando você especifica um fuso-horário ao publicar um arquivo CSV, o fuso-horário selecionado é aplicado para todos os valores de data e hora que existem no arquivo CSV no momento da publicação ou ao substituir a camada de feição.
  • Se você desejar ter o fuso-horário somente para registros individuais, você poderá especificar um deslocamento de UTC para o respectivo registro. Por exemplo, se você tiver um valor de data Terça-Feira, 28 de Julho, 2009 5:23 AM+8, isto refletirá um fuso-horário que está oito horas à frente do UTC. Consulte www.worldtimezone.com para uma lista de fuso-horário mundial. Quando o fuso-horário é especificado por registro no arquivo CSV, um fuso-horário selecionado durante a publicação é aplicado nestes registros que não têm um deslocamento especificado.
  • Se você alterar os campos de data na camada de feição que publicou, inclusive se alterar a camada de feição hospedada para utilizar uma opção Rastrear quem criou e atualizou as feições por último, os campos de data vão capturar os valores na hora local do editor e converter para UTC com o deslocamento de tempo aplicado.
  • Quando você exporta dados de uma camada de feição hospedada para a qual você especificou um fuso-horário quando publicou, nenhum deslocamento é aplicado. Os dados são exportados em formato UTC, que eficazmente mantém o fuso-horário que você selecionou durante a publicação.
  • Somente fuso-horários padrão estarão disponíveis na lista Fuso-Horário durante a publicação. Porém, o horário de verão é automaticamente aplicado se um valor de data em seu CSV cair dentro do horário de verão e o fuso-horário reconhecer o horário de verão.

Campos de data em arquivos TXT

Quando você adicionar um arquivo de TXT ao Map Viewer, os formatos de dados seguintes são reconhecidos como campos de data:

FormatoEntrada de exemploValor da tabela

M/DD/YYYY formato 12 horas

28/07/2009 17:23 am

28 de julho de 2009

MM/DD/YYYY formato 12 horas

28/07/2009 17:23 am

28 de julho de 2009

MM/DD/YY formato 12 horas

28/07/2009 17:23 am

28 de julho de 2009

Dia da semana, Mês DD, YYYY formato 12 horas*

Terça-feira, 28 de julho de 2009 5:23 PM

28 de julho de 2009

Mês DD, YYYY formato 12 horas*

28 de julho de 2009 5:23 PM

28 de julho de 2009

*Estes formatos de dados são somente suportados se você delimitar campos utilizando guias ou ponto-e-vírgula.

As considerações para adicionar arquivos CSV e TXT ao Map Viewer

  • Quanto mais campos de endereço você incluir, mais precisos serão os resultados da geocodificação. Por exemplo, endereço e CEP renderão melhores resultados que apenas endereço.
  • O campo de endereço pode conter múltiplas partes de um endereço (algumas vezes denominada de geocodificação de única linha).
  • Quando você adiciona um arquivo CSV diretamente no Map Viewer, os tipos de campo são automaticamente configurados e não podem ser alterados. Se você precisar alterar os tipos de campo, publique seu arquivo CSV como uma camada de feição hospedada e defina os tipos de campo quando você publicar.
  • O Map Viewer não consegue criar uma camada a partir do arquivo se o arquivo tiver mais espaços que separadores em nomes de campo (a primeira linha do arquivo). Remova alguns espaços em nomes de campo e tente adicionar o arquivo novamente.
  • A ordem e local não importam (por exemplo, você pode ter 519 East 86 Street, New York, NY, 10028 ou new york,10028,519 east 86 street,ny). Entretanto, cada linha no arquivo deve seguir a mesma ordem.
  • Quando você adiciona um arquivo CSV ou TXT com informações de coordenadas ou endereços enquanto está conectado, 4.000 linhas podem ser adicionadas diretamente no mapa. Arquivos CSV e TXT com mais de 4,000 linhas devem ser publicados como uma camada de feição hospedada.
  • Quando você adiciona um arquivo CSV ou TXT com endereços como um usuário anônimo ou quando não está registrado, 250 feições podem ser adicionadas diretamente no mapa. Arquivos CSV e TXT com mais endereços que isto devem ser publicados como uma camada de feição hospedada.
  • Se os dados tiverem caracteres diferentes do Inglês, por exemplo, caracteres específicos para Francês, Russo, Grego, Japonês ou alfabetos Árabes, o arquivo que você importar deverá ser codificado como Unicode ou UTF-8, e não ASCII. Se você importar um arquivo ASCII codificado contendo caracteres diferentes do Inglês, ele talvez exiba valores de atributo utilizando caracteres inesperados. Você pode salvar um arquivo de texto como UTF-8 ou Unicode no Windows. Abra o arquivo em um editor de textos como Notepad, clique em Arquivo > Salvar Como e escolha UTF-8 ou Unicode a partir do menu suspenso Codificação exibido na parte inferior da caixa de diálogo Salvar Como.
  • Se você estiver adicionando um arquivo CSV da web que inclui campos de número com decimais, os caracteres decimais no arquivo deverão corresponder ao formato suportado pela linguagem do sistema. Por exemplo, se o sistema estiver configurado para Inglês, o arquivo deverá utilizar pontos como decimais. Se o sistema estiver configurado para Francês, o arquivo deverá utilizar vírgulas como decimais.
  • Quando um arquivo CSV contendo informações de latitude e longitude é adicionado a um mapa, as coordenadas de latitude e longitude são convertidas para a referência espacial do mapa base atual.
  • Você pode compartilhar um arquivo CSV (inclusive um com informações de endereço) como um item para outros baixar, o arquivo não pode ser visualizado com Map Viewer.

Arquivo GPX

Você pode capturar dados com um dispositivo GPS e utilizar uma ferramenta de terceiros ou utilitário de fabricante do GPS para converter os dados para um arquivo em formato GPS. Após você tem um arquivo de GPX, você pode adicioná-lo no Map Viewer para visualizar os dados. Os seguintes tipos de dados são suportados no Map Viewer:

  • Pontos de Rota—São pontos que o usuário de GPS registrou manualmente, geralmente especificando um nome para marcar posições importantes no mapa.
  • Trilhas—São pontos que o dispositivo de GPS registra automaticamente em um intervalo periódico. As trilhas são renderizadas como feições lineares.
  • Rotas—Estes são pontos do dispositivo de GPS utilizados para navegar em uma localização especificada. As rotas são renderizadas como feições lineares.

Considerações para utilizar arquivos GPX

  • Os arquivos GPX podem conter múltiplas camadas mostrando pontos de rota, caminhos e rotas.
  • Se nenhum símbolo for especificado ou se o símbolo não for parte de um conjunto de símbolos incluído no Map Viewer, um símbolo do ponto de rota padrão será utilizado.
  • Você pode adicionar arquivos GPX no Map Viewer, mas você não pode adicioná-los como itens pela guia Meu Conteúdo da página de conteúdo.