Crea y administra un conjunto de datos

Los conjuntos de datos te permiten subir datos geoespaciales desde un archivo local o desde Google Cloud Storage a Google Maps Platform. Luego, puedes asociar el conjunto de datos a uno o más diseños de mapa en la consola de Cloud. Después de asociar el conjunto de datos a un diseño de mapa, usa la API de diseño basado en datos para definir el diseño de tu aplicación de mapas de forma dinámica.

También puedes usar una API de REST para subir tus datos geoespaciales a un conjunto de datos. Para obtener más información, consulta API de Maps Datasets.

Configura los roles

Para crear y administrar conjuntos de datos en un proyecto de Google Cloud, debes tener el rol de IAM de propietario o editor en el proyecto.

Nota: Si creaste el proyecto, tienes el rol de propietario. En la página IAM de la consola de Google Cloud, se muestran los propietarios y editores del proyecto.

Como alternativa, puedes asignar los siguientes roles de IAM a una cuenta de usuario o de servicio que uses para administrar conjuntos de datos:

• El rol Maps Platform Datasets Admin otorga a la cuenta de usuario o de servicio acceso de lectura/escritura a los conjuntos de datos del proyecto. A su vez, le permite al usuario realizar todas las operaciones en un conjunto de datos.
• El rol Maps Platform Datasets Viewer otorga acceso de solo lectura a los conjuntos de datos del proyecto. A su vez, te permite crear una lista y obtener o descargar las operaciones de un conjunto de datos.

Para obtener más información, consulta Cómo otorgar un rol de IAM mediante la consola de Google Cloud.

Fuente de datos de un conjunto de datos

Crea un conjunto de datos y, luego, sube los datos allí desde Google Cloud Storage o un archivo local.

• Cuando subas datos desde Cloud Storage, especifica la ruta de acceso al archivo correspondiente al recurso que contiene los datos en Cloud Storage. Esa ruta tiene el formato gs://GCS_BUCKET/FILE.

  El usuario que realiza la solicitud debe tener el rol de visualizador de objetos de Storage o cualquier otro rol que incluya el permiso storage.objects.get. Para obtener más información sobre cómo administrar el acceso a Cloud Storage, consulta Descripción general del control de acceso.

• Cuando subas datos de un archivo local, especifica la ruta de acceso al archivo GeoJSON, KML o CSV que contiene los datos que deseas subir.

Requisitos previos

Cuando crees un conjunto de datos, ten en cuenta lo siguiente:

• Los nombres visibles deben ser únicos para tu proyecto de Google Cloud.
• Los nombres visibles deben tener menos de 64 bytes (dado que estos caracteres se representan en UTF-8, cada carácter puede representarse mediante varios bytes en algunos idiomas).
• Las descripciones deben tener menos de 1,000 bytes.

Cuando subas datos, ten en cuenta lo siguiente:

• Los tipos de archivo admitidos son CSV, GeoJSON y KML.
• El tamaño de archivo máximo que se admite es 350 MB.
• Los nombres de las columnas de atributos no pueden comenzar con la cadena "?_".
• No se admiten las geometrías tridimensionales. Esto incluye el sufijo "Z" en el formato WKT y la coordenada de altitud en el formato GeoJSON.

Nota: La carga puede tardar minutos o incluso horas en completarse, según el tamaño del archivo de datos. Si la carga falla, recibirás un mensaje de error. No intentes borrar el conjunto de datos hasta que se haya mostrado una respuesta de la operación de carga.

Nota: Los mosaicos de mapa creados con datos subidos mediante la API de Maps Datasets pueden disminuir o simplificar los datos densos o complejos a bajos niveles de zoom. Por ejemplo, cuando un usuario aleja el mapa a un estado o país (por ejemplo, en el nivel de zoom 5 a 12), los datos en mosaico pueden verse diferentes a cuando se acerca una ciudad o un vecindario (por ejemplo, en los niveles de zoom 13 a 18). Esto sirve para que los mosaicos se mantengan delgados y tengan un buen rendimiento cuando los usas con un procesador de mapas.

Sugerencia: Si tu archivo de datos es grande y tiene muchos atributos que no son necesarios para definir el diseño, y deseas optimizar el rendimiento de la renderización, edita el archivo para quitar los atributos innecesarios. Si reduces la cantidad de atributos, se reducirá el tamaño de los mosaicos del mapa y, por lo tanto, mejorará el rendimiento de la renderización.

Prácticas recomendadas para la preparación de datos

Si tus datos de origen son complejos o grandes, como puntos densos, líneas de línea largas o polígonos (a menudo, los tamaños de archivo fuente superiores a 50 MB se incluyen en esta categoría), considera simplificar los datos antes de subirlos para lograr el mejor rendimiento en un mapa visual.

A continuación, te presentamos algunas prácticas recomendadas para preparar tus datos:

1. Minimiza las propiedades de los componentes. Solo conserva las propiedades de componentes necesarias para aplicar diseño al mapa (por ejemplo, "id" y "category"). Puedes unir propiedades adicionales a un componente de una app cliente con diseños basados en datos en una clave de identificador única. Por ejemplo, consulta Visualiza tus datos en tiempo real con un diseño basado en datos.
2. Usa tipos de datos simples para los objetos de propiedad cuando sea posible, como números enteros, para minimizar el tamaño de los mosaicos y mejorar el rendimiento del mapa.
3. Simplifica las geometrías complejas antes de subir un archivo. Puedes hacerlo con la herramienta geoespacial que prefieras, como la utilidad de código abierto Mapshaper.org, o en BigQuery con ST_Simplify en geometrías de polígono complejas.
4. El clúster tiene puntos muy densos antes de subir un archivo. Puedes hacerlo con la herramienta geoespacial que prefieras, como las funciones de clúster de turf.js de código abierto, o en BigQuery con ST_CLUSTERDBSCAN en geometrías de puntos densos.

Consulta la orientación adicional sobre las prácticas recomendadas para conjuntos de datos en Visualiza tus datos con conjuntos de datos y BigQuery.

Requisitos de GeoJSON

El SDK de Maps para iOS admite la especificación GeoJSON actual. El SDK de Maps para iOS también admite archivos GeoJSON que contengan cualquiera de los siguientes tipos de objetos:

• Objetos de geometría. Un objeto de geometría es una forma espacial descrita como una unión de puntos, líneas y polígonos con agujeros opcionales.
• Objetos de componente. Un objeto de componente contiene una geometría y pares de nombre/valor adicionales cuyo significado es específico para cada aplicación.
• Colecciones de componentes: Una colección de componentes es un conjunto de objetos de componente.

El SDK de Maps para iOS no admite archivos GeoJSON que tengan datos en un sistema de referencia de coordenadas (CRS) distinto de WGS84.

Para obtener más información sobre GeoJSON, consulta el artículo sobre el cumplimiento de RFC 7946.

Requisitos de KML

El SDK de Maps para iOS tiene los siguientes requisitos:

• Todas las URLs deben ser locales (o relativas) al archivo.
• Se admiten las geometrías de punto, línea y polígono.
• Todos los atributos de datos se consideran cadenas.

No se admiten los siguientes componentes de KML:

• Los íconos o <styleUrl> que se definan fuera del archivo
• Los vínculos de red, como <NetworkLink>
• Las superposiciones de suelo, como <GroundOverlay>
• Las geometrías 3D o cualquier etiqueta relacionada con la altitud, como <altitudeMode>
• Las especificaciones de cámara, como <LookAt>
• Los diseños definidos dentro del archivo KML

Requisitos de CSV

Para los archivos CSV, los nombres de columnas admitidos se indican a continuación, en orden de prioridad:

• latitude, longitude
• lat, long
• x, y
• wkt (Well-Known Text)
• address, city, state, zip
• address
• Una sola columna que contiene toda la información de la dirección, como 1600 Amphitheatre Parkway Mountain View, CA 94043

Por ejemplo, tu archivo contiene columnas llamadas x, y y wkt. Dado que x e y tienen una prioridad más alta, según el orden de los nombres de columna admitidos en la lista anterior, los valores en las columnas x y y se utilizan, y la columna wkt se ignora.

Además:

• Cada nombre de columna debe pertenecer a una sola columna. Esto significa que no puedes tener una columna llamada xy que contenga datos de coordenadas "x" e "y". Las coordenadas "x" e "y" deben estar en columnas separadas.
• Los nombres de las columnas no distinguen mayúsculas de minúsculas.
• El orden de los nombres de columna no es relevante. Por ejemplo, si tu archivo CSV contiene columnas lat y long, estas pueden mostrarse en cualquier orden.

Maneja errores de carga de datos

Cuando subes datos a un conjunto de datos, es posible que experimentes uno de los errores comunes que se describen en esta sección.

Errores de GeoJSON

Estos son algunos de los errores comunes de GeoJSON:

• Falta el campo type, o bien type no es una cadena. El archivo de datos GeoJSON subido debe contener un campo de cadena llamado type como parte de la definición de cada objeto de componente y objeto de geometría.

Errores de KML

Estos son algunos de los errores comunes de KML:

• El archivo de datos no debe contener ninguno de los componentes KML no admitidos que se mencionaron en la lista anterior. De lo contrario, la importación de datos podría fallar.

Errores de CSV

Estos son algunos de los errores comunes de CSV:

• A algunas filas les faltan valores para una columna de geometría. Todas las filas de un archivo CSV deben contener valores no vacíos para las columnas de geometría. Entre las columnas de geometría, se incluyen las siguientes:
  • latitude, longitude
  • lat, long
  • x, y
  • wkt
  • address, city, state, zip
  • address
  • Una sola columna que contiene toda la información de la dirección, como 1600 Amphitheatre Parkway Mountain View, CA 94043
  Nota: Este error suele describirse con un mensaje similar al siguiente: "Unable to convert ' ' to a double" o "Could not parse input to geography.: Geography value is missing".
• Si x y y son las columnas de geometría, asegúrate de que las unidades sean de longitud y latitud. Algunos conjuntos de datos públicos usan diferentes sistemas de coordenadas bajo los encabezados x e y. Si se usan unidades incorrectas, el conjunto de datos podría importarse de forma correcta, pero los datos renderizados podrían mostrar puntos del conjunto de datos en ubicaciones inesperadas.

Cómo crear un conjunto de datos

Sigue estos pasos para crear un conjunto de datos:

1. En la consola de Google Cloud, ve a la página Conjuntos de datos.
2. Haz clic en Crear conjunto de datos.
3. Ingresa el nombre del conjunto de datos. El nombre debe ser único para el conjunto de datos.
4. Como alternativa, ingresa una Descripción del conjunto de datos.
5. Haz clic en Continuar. Se abrirá la página Importar datos.
6. Como fuente de carga de los datos que quieres usar para completar el conjunto de datos, selecciona Computadora de escritorio (para hacer referencia a un archivo local en tu sistema) o Bucket de Google Cloud Storage.
   • Si eliges Computadora de escritorio, haz clic en Explorar y, luego, selecciona el archivo en el selector de archivos.
   • Si eliges Bucket de Google Cloud Storage, haz clic en Explorar y selecciona el bucket y el archivo que contienen los datos.
7. Selecciona el Formato de archivo.
8. Haz clic en Continuar para revisar la configuración.
9. Haz clic en Crear. Se abrirá la página Conjuntos de datos, que mostrará tu nuevo conjunto de datos. El estado debe ser Processing.
10. Espera hasta que tu conjunto de datos tenga el estado Completed.

Cómo ver o modificar un conjunto de datos

Después de crear un conjunto de datos correctamente, su estado se mostrará como Completed. Luego, podrás examinar los detalles del conjunto de datos.

Para ver o modificar el conjunto de datos, sigue estos pasos:

1. En la consola de Google Cloud, ve a la página Conjuntos de datos.
2. Haz clic en el nombre del conjunto de datos. Se abrirá la página Detalles del conjunto de datos.
   1. Haz clic en la pestaña Detalles para ver información sobre el conjunto de datos. En esta pestaña, también podrás editar el nombre y la descripción del conjunto de datos.
   2. Para ver tu conjunto de datos en un mapa, haz clic en la pestaña Vista previa.
   3. Haz clic en la pestaña Table Data para ver todos los atributos del conjunto de datos. Estos son los atributos que puedes usar para definir el diseño del conjunto de datos del mapa.
   4. Para descargar los datos en un archivo local, haz clic en el botón Descargar.
   5. Para borrar el conjunto de datos, haz clic en el botón Borrar.

   6. Haz clic en el botón Importar archivo de datos para subir datos nuevos al conjunto de datos.

      Cuando se suben datos nuevos al conjunto de datos, se crea una versión nueva del conjunto de datos. Si los datos nuevos se suben de forma correcta, haz lo siguiente:

      • El estado de la nueva versión del conjunto de datos se establece como COMPLETED.
      • La versión nueva se convierte en la versión "activa" y es la versión que usa tu app.

      Si se produce un error en la carga, haz lo siguiente:

      • El estado de la nueva versión del conjunto de datos se establece en un estado diferente de COMPLETED. Por ejemplo, si hay una versión anterior “activa”, el estado del conjunto de datos se establece en REVERTIDO.
      • La versión del conjunto de datos que estaba “activa” permanece como la versión “activa” y es la versión que usa tu app.