Primeros pasos con BigQuery GIS

Este instructivo presenta una introducción a BigQuery GIS. Con BigQuery GIS, puedes analizar y visualizar datos geoespaciales en BigQuery de forma sencilla.

Objetivos

En este instructivo, realizarás lo siguiente:

• Usar una función de BigQuery GIS para convertir columnas de latitud y longitud en puntos geográficos
• Ejecutar una consulta que busque todas las estaciones de Citi Bike con más de 30 bicicletas disponibles para alquiler
• Visualizar tus resultados en BigQuery Geo Viz

Costos

En este instructivo, se usan componentes facturables de Google Cloud, que incluyen los siguientes:

• BigQuery

Se te cobrará por lo siguiente:

• Consultar datos en los conjuntos de datos públicos de BigQuery
  • El primer TB de cada mes es gratuito.
  • Si usas el precio de tasa fija, los costos de consultas se incluyen en el precio de tasa fija.

Antes de comenzar

1. Accede a tu Cuenta de Google.

   Si todavía no tienes una cuenta, regístrate para obtener una nueva.

2. En GCP Console, en la página de selección de proyecto, selecciona o crea un proyecto de GCP.

   Nota : Si no planeas conservar los recursos que creas en este procedimiento, crea un proyecto en lugar de seleccionar un proyecto existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

   Ir a la página de selección de proyecto

3. Comprueba que la facturación esté habilitada en tu proyecto.

   Descubre cómo puedes habilitar la facturación

4. BigQuery se habilita de manera automática en proyectos nuevos. Para activar BigQuery en un proyecto existente, ve a Habilita lasBigQueryAPI.

   Habilita lasAPI

Explora los datos de muestra

En este instructivo, se usa un conjunto de datos disponible a través del Programa de conjuntos de datos públicos de Google Cloud. Un conjunto de datos públicos es un conjunto de datos que se almacena en BigQuery y está disponible para el público en general. Se trata de conjuntos de datos que BigQuery aloja de modo que puedas acceder a ellos y también integrarlos en tus aplicaciones. Google cubre los costos de almacenamiento de estos conjuntos de datos y proporciona acceso público a los datos a través de un proyecto. Solo se paga por las consultas que realices en los datos (el primer 1 TB mensual es gratuito, sujeto a los detalles de los precios de las consultas).

Conjunto de datos de viajes con NYC Citi Bike

Viajes con NYC Citi Bike

Citi Bike es el programa de bicicletas compartidas más grande del país, con 10,000 bicicletas y 600 estaciones en Manhattan, Brooklyn, Queens y Jersey City. Este conjunto de datos incluye viajes de Citi Bike desde que este programa se lanzó en septiembre de 2013 y se actualiza diariamente. Los datos han sido procesados por Citi Bike a fin de borrar los viajes tomados por el personal para inspeccionar y reparar el sistema, así como los viajes de menos de 60 segundos de duración, los que se consideran inicios falsos.

Para comenzar a explorar estos datos en la consola de BigQuery, visualiza los detalles de la tabla citibike_stations:

Ir al esquema citibike_stations

Hay tres columnas en esta tabla que son relevantes para este instructivo:

• bike_stations.longitude: la longitud de una estación. Los valores son longitudes WGS 84 válidas en formato de grados decimales.
• bike_stations.latitude: la latitud de una estación. Los valores son latitudes WGS 84 válidas en formato de grados decimales.
• num_bikes_available: La cantidad de bicicletas disponibles para alquiler.

Consulta las estaciones de bicicletas con más de 30 bicicletas disponibles

En esta sección del instructivo, ejecutas una consulta de SQL estándar que encuentra todas las estaciones de Citi Bike en Nueva York con más de 30 bicicletas disponibles para alquiler.

Detalles de la consulta

La siguiente consulta de SQL estándar se usa para encontrar las estaciones de Citi Bike con más de 30 bicicletas.

SELECT
  ST_GeogPoint(longitude, latitude)  AS WKT,
  num_bikes_available
FROM
  `bigquery-public-data.new_york.citibike_stations`
WHERE num_bikes_available > 30

Las cláusulas de la consulta realizan lo siguiente:

• SELECT ST_GeogPoint(longitude, latitude) AS WKT, num_bikes_available

  La cláusula SELECT selecciona la columna num_bikes_available y usa la función ST_GeogPoint para convertir los valores en las columnas latitude y longitude a tipos (puntos) GEOGRAPHY

  .

• FROM `bigquery-public-data.new_york.citibike_stations`

  La cláusula FROM especifica la tabla que se está consultando: citibike_stations.

• WHERE num_bikes_available > 30

  La cláusula WHERE filtra los valores en la columna num_bikes_available a solo aquellas estaciones con más de 30 bicicletas

  .

Ejecuta la consulta

Para ejecutar la consulta mediante la IU web de BigQuery en Cloud Console, haz lo siguiente:

1. Ve a Cloud Console.

   Ir a Cloud Console

2. Ingresa la siguiente consulta de SQL estándar en el área de texto del Editor de consultas.

   -- Finds Citi Bike stations with > 30 bikes
   SELECT
     ST_GeogPoint(longitude, latitude)  AS WKT,
     num_bikes_available
   FROM
     `bigquery-public-data.new_york.citibike_stations`
   WHERE num_bikes_available > 30
   

3. Haz clic en Ejecutar.

   La consulta tarda un momento en completarse. Una vez que se ejecuta la consulta, tus resultados aparecerán en el panel Resultados de la consulta.

   

Visualiza los resultados de la consulta en Geo Viz

A continuación, visualizas los resultados con BigQuery Geo Viz, una herramienta web que permite visualizar datos geoespaciales en BigQuery mediante las API de Google Maps.

Inicia Geo Viz y autentícate

Antes de usar Geo Viz, debes autenticarte y otorgar acceso a los datos en BigQuery.

Para configurar Geo Viz, haz lo siguiente:

1. Abre la herramienta web Geo Viz.

   Abrir la herramienta web Geo Viz

2. En el primer paso, Seleccionar datos (Select data), haz clic en Autorizar (Authorize).

   

3. En el diálogo Elige una cuenta (Choose an account), haz clic en tu Cuenta de Google.

   

4. En el diálogo de acceso, haz clic en Permitir (Allow) para que Geo Viz pueda tener acceso a tus datos de BigQuery.

   

Ejecuta una consulta de SQL estándar en los datos de GIS

Después de autenticarte y otorgar acceso, el próximo paso es ejecutar la consulta en Geo Viz.

Para ejecutar la consulta, haz lo siguiente:

1. En el primer paso, Seleccionar datos (Select data), ingresa el ID de tu proyecto en el campo ID del proyecto (Project ID).

2. En la ventana de la consulta, ingresa la siguiente consulta de SQL estándar.

   -- Finds Citi Bike stations with > 30 bikes
   SELECT
     ST_GeogPoint(longitude, latitude)  AS WKT,
     num_bikes_available
   FROM
     `bigquery-public-data.new_york.citibike_stations`
   WHERE num_bikes_available > 30
   

3. Haz clic en Ejecutar (Run).

4. Una vez completada la consulta, haz clic en Ver resultados (See results). También puedes hacer clic en Definir columnas (Define columns) en el paso dos.

   

5. Esto te hace avanzar al paso dos. En el paso dos, en Columna de geometría (Geometry column), elige WKT (WKT). Esto traza los puntos correspondientes a las estaciones de bicicleta en tu mapa.

   

Formatea tu visualización

En la sección Estilo (Style), se proporciona una lista de estilos visuales para personalizar la visualización. Algunas propiedades se aplican solo a algunos tipos de datos. Por ejemplo, circleRadius solo afecta a los puntos.

Las propiedades de estilo admitidas incluyen las siguientes opciones:

• fillColor: el color de relleno de un polígono o un punto. Por ejemplo, las funciones "linear" o "interval" pueden usarse para mapear valores numéricos a un gradiente de color.
• fillOpacity: la opacidad del relleno de un polígono o un punto. Los valores deben encontrarse en el rango entre cero y uno, en el que 0 = transparente y 1 = opaco.
• strokeColor: el color del trazo o contorno de un polígono o una línea.
• strokeOpacity: La opacidad del trazo o el contorno de un polígono o una línea. Los valores deben encontrarse en el rango entre cero y uno, en el que 0 = transparente y 1 = opaco.
• strokeWeight: el ancho del trazo o contorno en píxeles de un polígono o línea.
• circleRadius: el radio del círculo que representa un punto en píxeles. Por ejemplo, una función “lineal” puede usarse a fin de asignar valores numéricos de modo que se indiquen los tamaños para crear un estilo de diagrama de dispersión.

Cada estilo puede recibir un valor global (que se aplique a todos los resultados) o uno basado en los datos (que se aplique de maneras distintas según los datos de cada fila de resultados). En el caso de los valores basados en los datos, se usan las siguientes opciones para determinar el resultado:

• función (function): una función que se usa para procesar un valor de estilo a partir de los valores de un campo.
• identidad (identity): se usa el valor de los datos de cada campo como el valor de estilo.
• categórico (categorical): se asignan uno a uno los valores de los datos de cada campo enumerado en el dominio hacia los estilos correspondientes en el rango.
• intervalo (interval): los valores de los datos de cada campo se redondean hacia abajo hasta el valor más cercano en el dominio y, luego, se les da el estilo correspondiente en el rango.
• lineal (linear): los valores de los datos de cada campo se interpolan de forma lineal con los valores del dominio y se les da estilo según una combinación de los estilos correspondientes en el rango.
• campo (field): se usa el campo especificado en los datos como los datos de entrada para la función de estilo.
• dominio (domain): una lista ordenada de datos de entrada de muestra provenientes de un campo. Los datos de entrada (dominio) de muestra se asocian con los datos de salida (rango) de muestra basados en la función determinada y se usan con el fin de inferir valores de estilo para todos los datos de entrada (incluso aquellos que no estén enumerados en el dominio). Los valores en el dominio deben tener el mismo tipo (texto, número, etc.) que los valores del campo que estás visualizando.
• rango (range): una lista de valores de datos de salida de muestra para la regla de estilo. Los valores en el rango deben tener el mismo tipo (color o número) que la propiedad de estilo que estás controlando. Por ejemplo, el rango de la propiedad fillColor debería tener solo colores.

Para formatear tu mapa, haz lo siguiente:

1. Haz clic en Agregar estilos (Add styles) en el paso dos o haz clic en el paso 3 Estilo (Style).

2. Cambia el color de tus puntos. Haz clic en fillColor.

3. En el campo Valor (Value), ingresa #0000FF, el código de color HTML para azul.

   

4. Examina tu mapa. Si detienes el cursor sobre uno de tus puntos, se muestra el valor.

   

5. Haz clic en fillOpacity.

6. En el campo Valor (Value), ingresa .5.

   

7. Examina tu mapa. El color de relleno de los puntos ahora es semitransparente.

   

8. Cambia el tamaño de los puntos en función de la cantidad de bicicletas disponibles. Haz clic en circleRadius.

9. En el panel circleRadius, haz lo siguiente:

   1. Haz clic en Basado en los datos (Data driven).
   2. En Función (Function), elige lineal (linear).
   3. En Campo(Field), selecciona num_bikes_available.
   4. En Dominio (Domain), ingresa 30 en el primer cuadro y 60 en el segundo.

   5. En Rango (Range), ingresa 5 en el primer cuadro y 20 en el segundo.

      

10. Examina tu mapa. El radio de cada círculo ahora corresponde a la cantidad de bicicletas disponibles en esa ubicación.

    

11. Cierra Geo Viz.

Limpieza

Sigue estos pasos para evitar que se apliquen cargos a tu cuenta de Google Cloud Platform por los recursos que usaste en este instructivo:

• Puedes borrar el proyecto que creaste.
• También puedes conservar el proyecto y usarlo a futuro.

Para borrar el proyecto, haz lo siguiente:

Precaución: Borrar un proyecto tiene las siguientes consecuencias:

• Se borra todo en el proyecto. Si utilizaste un proyecto existente para este instructivo, cuando lo borres, también borrarás cualquier otro trabajo que hayas realizado en el proyecto.
• Se pierden los ID personalizados de proyectos. Cuando creaste este proyecto, es posible que hayas creado un ID del proyecto personalizado que desees utilizar en el futuro. Para conservar las URL que utilizan el ID del proyecto, como una URL de appspot.com, borra los recursos seleccionados dentro del proyecto en lugar de borrar todo el proyecto.

Si planeas explorar varios instructivos y guías de inicio rápido, la reutilización de proyectos puede ayudarte a evitar exceder los límites de las cuotas del proyecto.

1. En GCP Console, dirígete a la página Administrar recursos.

   Ir a la página Administración de recursos

2. En la lista de proyectos, selecciona el proyecto que deseas borrar y haz clic en Borrar .
3. En el cuadro de diálogo, escribe el ID del proyecto y, luego, haz clic en Cerrar para borrar el proyecto.

Próximos pasos

• A fin de obtener más información sobre las opciones de visualización para BigQuery GIS, consulta Cómo visualizar datos en BigQuery GIS.
• Para obtener más información sobre cómo trabajar con datos de BigQuery GIS, consulta Cómo trabajar con datos de BigQuery GIS.
• Si quieres ver un instructivo sobre cómo usar BigQuery GIS, consulta Cómo usar BigQuery GIS para trazar la ruta de un huracán.
• A fin de ver la documentación sobre las funciones de SQL estándar para BigQuery GIS, consulta las funciones geográficas en SQL estándar.