Función PLACES_COUNT_PER_H3

La función PLACES_COUNT_PER_H3 toma un área geográfica para buscar y devuelve una tabla de recuentos de lugares por celda de H3 en el área de búsqueda.

Como la función PLACES_COUNT_PER_GEO devuelve una tabla, llámala con una cláusula FROM.

• Parámetros de entrada:

  • Obligatorio: El parámetro de filtro geography que especifica el área de búsqueda. El parámetro geography es un valor definido por el tipo de datos GEOGRAPHY de BigQuery, que admite puntos, cadenas de líneas y polígonos.

    Para ver ejemplos del uso de diferentes tipos de ubicaciones geográficas de búsqueda, como ventanas gráficas y líneas, consulta la función PLACES_COUNT.

  • Obligatorio: Es el parámetro de filtro h3_resolution que especifica la resolución de H3 que se usa para agregar el recuento de lugares en cada celda de H3. Los valores admitidos son del 0 al 8.

  • Opcional: Son parámetros de filtro adicionales para definir mejor tu búsqueda.

• Se muestra lo siguiente:

  • Es una tabla con una fila por celda de H3. La tabla contiene las columnas h3_cell_index (STRING), geography (GEOGRAPHY), que define el polígono que representa la celda de H3, count (INT64) y sample_place_ids (ARRAY<STRING>), en la que sample_place_ids contiene hasta 250 IDs de lugar para cada celda de H3.

Ejemplo: Recuento de tiendas de comestibles y minimercados accesibles para personas en silla de ruedas por celda de H3

En el siguiente ejemplo, se calcula la cantidad de tiendas de conveniencia y supermercados operativos y accesibles para sillas de ruedas por celda H3 en la ciudad de Nueva York. Las celdas H3 usan un nivel de resolución de 8.

En este ejemplo, se usa el conjunto de datos públicos de BigQuery de Overture Maps Data para obtener la geografía de la ciudad de Nueva York.

DECLARE geo GEOGRAPHY;

-- Get the geography for New York City.
SET geo = (SELECT geometry FROM `bigquery-public-data.overture_maps.division_area`
  WHERE country = 'US' AND names.primary = 'City of New York'  LIMIT 1);

SELECT * FROM `places_insights___us___sample.PLACES_COUNT_PER_H3`(
  JSON_OBJECT(
      'geography', geo,
      'types', ["convenience_store","grocery_store"],
      'wheelchair_accessible_entrance', true,
      'business_status', ['OPERATIONAL'],
      'h3_resolution', 8
    )
);

La respuesta de la función:

Visualizar los resultados

En las siguientes imágenes, se muestran estos datos en Looker Studio como un mapa completado. Cuanto más oscura sea la celda H3, mayor será la concentración de resultados:

Para importar tus datos a Looker Studio, sigue estos pasos:

1. Ejecuta la función anterior para generar los resultados.

2. En los resultados de BigQuery, haz clic en Abrir en -> Looker Studio. Tus resultados se importan automáticamente a Looker Studio.

3. Looker Studio crea una página de informe predeterminada y la inicializa con un título, una tabla y un gráfico de barras de los resultados.

   

4. Selecciona todo el contenido de la página y bórralo.

5. Haz clic en Insertar -> Mapa completado para agregar un mapa completado a tu informe.

6. En Chart types -> Setup, configura los campos como se muestra a continuación:

   

7. El mapa completado aparece como se muestra arriba. De manera opcional, puedes seleccionar Tipos de gráficos -> Estilos para configurar aún más la apariencia del mapa.

Para obtener más información y un ejemplo sobre cómo visualizar los resultados de Places Insights, consulta Visualiza los resultados de las consultas.