Criar e gerenciar um conjunto de dados

Este produto ou recurso está em pré-lançamento (pré-GA). Os produtos e recursos em pré-GA têm suporte limitado, e é possível que as mudanças neles não sejam compatíveis com versões anteriores. Todos os itens em pré-GA são cobertos pelos Termos de Serviço da Plataforma Google Maps. Para mais detalhes, consulte as descrições da fase de lançamento.

Com os conjuntos de dados, você pode fazer o upload de dados geoespaciais de um arquivo local ou do Google Cloud Storage para a Plataforma Google Maps. Em seguida, é possível associar um conjunto a um ou mais estilos de mapa no console do Cloud. Depois de associar o conjunto de dados a um estilo de mapa, use a API de estilo orientado a dados para aprimorar dinamicamente o aplicativo de mapas.

Também é possível usar uma API REST se quiser fazer o upload dos dados geoespaciais para um conjunto. Confira mais detalhes em API Maps Datasets.

Configurar papéis

Para criar e gerenciar conjuntos de dados em um projeto do Google Cloud, você precisa ter papel de proprietário ou editor do IAM nele.

Observação: se você criou o projeto, então terá o papel de proprietário. A página IAM do console do Google Cloud mostra os proprietários e editores do projeto.

Também é possível atribuir os seguintes papéis do IAM a uma conta de usuário ou de serviço usada para gerenciar conjuntos de dados:

• O papel Maps Platform Datasets Admin dá à conta de usuário ou de serviço acesso de leitura/gravação aos conjuntos de dados no projeto e permite que o usuário execute todas as operações neles.
• O papel Maps Platform Datasets Viewer dá acesso somente leitura aos conjuntos de dados no projeto e permite executar operações de listagem, recebimento ou download.

Para mais informações, acesse Conceder um papel do IAM usando o console do Google Cloud.

Origem de dados para um conjunto

Depois de criar um conjunto, faça o upload dos dados do Google Cloud Storage ou de um arquivo local para ele.

Observação: só é possível enviar informações a um conjunto uma única vez, ou seja, depois de atender à solicitação para upload dos dados do Cloud Storage ou de um arquivo local, não será possível repetir o processo no mesmo conjunto. Se houver um erro durante o upload, recrie o conjunto e tente novamente.

• Ao fazer o upload de dados do Cloud Storage, especifique o caminho do arquivo para o elemento que contém as informações no Cloud Storage. Esse caminho está no formato gs://GCS_BUCKET/FILE.

  Para fazer a solicitação, o usuário precisa ter o papel de leitor de objetos do Storage ou outra função que inclua a permissão de storage.objects.get. Para mais informações sobre como gerenciar o acesso ao Cloud Storage, consulte Visão geral do controle de acesso.

• Ao fazer o upload de dados de um arquivo local, especifique o caminho para o arquivo GeoJSON, KML ou CSV que contém os dados para upload.

Pré-requisitos

Ao criar um conjunto de dados:

• Os nomes de exibição precisam ser exclusivos no projeto do Google Cloud.
• Esses nomes devem ter menos de 64 bytes. Como os caracteres são representados em UTF-8, em alguns idiomas, um caractere pode ser representado por vários bytes.
• As descrições precisam ter menos de 1.000 bytes.

Ao fazer o upload de dados:

• Os tipos de arquivos compatíveis são CSV, GeoJSON e KML.
• O tamanho máximo de arquivo permitido é 350 MB.
• Os nomes das colunas de atributos não podem começar com a string "?_".
• Geometrias tridimensionais não são aceitas. Isso inclui o sufixo "Z" no formato WKT e a coordenada de altitude no formato GeoJSON.

Observação: dependendo do tamanho do arquivo de dados, o upload pode levar desde alguns minutos até algumas horas. Se houver um erro, você vai receber um alerta. Não tente excluir o conjunto de dados até que ele tenha retornado uma resposta da operação de upload.

Dica: se o arquivo de dados for grande, tiver muitos atributos não necessários para definir o estilo e você quiser otimizar a renderização, edite o arquivo para remover os atributos desnecessários. Isso reduz o tamanho dos blocos do mapa, melhorando a performance.

Requisitos de GeoJSON

A API Maps JavaScript é compatível com a especificação atual do GeoJSON (link em inglês) e também aceita arquivos GeoJSON que contêm qualquer um destes tipos de objetos:

• Objetos de geometria. Esse tipo de objeto é uma forma espacial, descrita como uma união de pontos, linhas e polígonos com furos opcionais.
• Objetos de elementos. Esse tipo de objeto contém uma geometria e outros pares de nome/valor, com um significado específico do aplicativo.
• Coleções de elementos. Uma coleção desse tipo é um conjunto de objetos de elementos.

A API Maps JavaScript não é compatível com arquivos GeoJSON que têm dados em um sistema de referência de coordenadas (CRS, na sigla em inglês) diferente de WGS84.

Para mais informações sobre o GeoJSON, consulte Compliance com RFC 7946 (ambos os links em inglês).

Requisitos de KML

A API Maps JavaScript tem os seguintes requisitos:

• Todos os URLs precisam ser locais (ou relativos) ao próprio arquivo.
• Compatível com geometrias de ponto, linha e polígono.
• Todos os atributos de dados são considerados strings.

Os seguintes elementos KML não são compatíveis:

• Ícones ou <styleUrl> definidos fora do arquivo
• Links de rede, como <NetworkLink>
• Sobreposições de solo, por exemplo, <GroundOverlay>
• Geometrias 3D ou qualquer tag relacionada à altitude, como <altitudeMode>
• Especificações da câmera, por exemplo, <LookAt>
• Estilos definidos dentro do arquivo KML

Requisitos de CSV

Para arquivos CSV, os nomes das colunas compatíveis são listados abaixo em ordem de prioridade:

• latitude, longitude
• lat, long
• x, y
• wkt (texto conhecido)
• address, city, state, zip
• address
• Uma única coluna contendo todas as informações de endereço, como 1600 Amphitheatre Parkway Mountain View, CA 94043

Por exemplo, seu arquivo inclui colunas chamadas x, y e wkt. Como x e y têm uma prioridade mais alta, segundo a ordem dos nomes de colunas compatíveis na lista acima, os valores nas colunas x e y são usados, e a coluna wkt é ignorada.

Além disso:

• Cada nome de coluna tem que pertencer a uma única coluna, ou seja, não é possível ter uma coluna chamada xy que inclua dados das coordenadas x e y. Essas coordenadas precisam estar em colunas diferentes.
• Os nomes das colunas não diferenciam maiúsculas de minúsculas.
• A ordem dos nomes não importa. Por exemplo, se o arquivo CSV tiver colunas lat e long, elas poderão estar em qualquer ordem.

Resolver erros de upload de dados

Ao fazer o upload de dados para um conjunto, você pode encontrar um dos erros comuns descritos nesta seção.

Erros de GeoJSON

Exemplo de erro comum de GeoJSON:

• Campo type faltando, ou type não é uma string. O arquivo de dados GeoJSON enviado precisa ter um campo de string chamado type em cada definição de objeto de elemento e de geometria.

Erros de KML

Exemplo de erro comum de KML:

• O arquivo de dados não pode conter nenhum dos elementos KML incompatíveis listados acima. Caso contrário, a importação pode falhar.

Erros de CSV

Exemplos de erros comuns de CSV:

• Algumas linhas não contêm valores para uma coluna de geometria. Em um arquivo CSV, todas as linhas em colunas desse tipo precisam ter valores não vazios. Confira algumas colunas de geometria:
  • latitude, longitude
  • lat, long
  • x, y
  • wkt
  • address, city, state, zip
  • address
  • Uma única coluna contendo todas as informações de endereço, como 1600 Amphitheatre Parkway Mountain View, CA 94043
  Observação: esse erro geralmente é descrito por uma mensagem no formato "Não foi possível converter ' ' em aspas duplas" ou "Não foi possível analisar a entrada na região geográfica: está faltando o valor da geografia".
• Se x e y forem suas colunas de geometria, verifique se as unidades são longitude e latitude. Alguns conjuntos de dados públicos usam sistemas de coordenadas diferentes nos cabeçalhos x e y. Se as unidades incorretas forem usadas, o conjunto poderá ser importado, mas os dados renderizados talvez mostrem os pontos em locais inesperados.

Criar conjunto de dados

Para fazer isso:

1. No console do Google Cloud, acesse a página Conjuntos de dados.
2. Clique em Criar conjunto de dados.
3. Insira um nome, que precisa ser exclusivo.
4. Também é possível inserir uma descrição, o que é opcional.
5. Clique em Continuar. A página Importar dados aparece.
6. Selecione a Origem do upload dos dados usados para preencher o conjunto como Computador, ou seja, um arquivo local no seu sistema, ou Bucket do Google Cloud Storage.
   • Em Computador, clique em Procurar e escolha o arquivo no seletor.
   • Em Bucket do Google Cloud Storage, clique em Procurar e selecione o bucket e o arquivo que contêm os dados.
7. Escolha o Formato do arquivo.
8. Clique em Continuar para revisar as configurações.
9. Clique em Criar. A página Conjuntos de dados aparece com o novo conjunto. O status deve ser Processando.
10. Aguarde até que o conjunto de dados tenha o status Concluído.

Acessar ou modificar um conjunto de dados

Depois que você cria um conjunto, o status dele aparece como Concluído. Em seguida, é possível verificar os detalhes do conjunto de dados:

Para acessar o conjunto:

1. No console do Google Cloud, acesse a página Conjuntos de dados.
2. Clique no nome do conjunto de dados. A página Detalhes do conjunto de dados vai aparecer.
   1. Selecione a guia Detalhes para encontrar informações sobre o conjunto. Nessa guia, também é possível editar o nome e a descrição dele.
   2. Clique na guia Visualizar para conferir seu conjunto em um mapa.
   3. Selecione a guia Dados da tabela para encontrar um subconjunto de dados associados ao conjunto.
   4. Clique no botão Download para armazenar as informações em um arquivo local.
   5. Clique no botão Excluir para remover o conjunto.