science Este producto o función está en fase experimental (previa a la DG). Los productos y las funciones que se encuentran en la fase previa a la DG pueden tener asistencia limitada, y los cambios en estos productos y funciones podrían no ser compatibles con otras versiones de la fase previa a la DG. Las ofertas que se encuentran en la fase previa a la DG se rigen por las Condiciones Específicas del Servicio de Google Maps Platform. Para obtener más información, consulta las descripciones de las etapas de lanzamiento. Regístrate para probar las estadísticas de Places.
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
La función PLACES_COUNT_PER_GEO toma un array de áreas geográficas para buscar y devuelve una tabla de recuentos de lugares por área. Por ejemplo, si especificas un array de códigos postales como el área de búsqueda, la respuesta contendrá una tabla con una fila separada para cada código postal.
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 filtrogeographies que especifica el área de búsqueda. El parámetro geographies toma un array de valores definidos por el tipo de datos GEOGRAPHY de BigQuery, que admite puntos, cadenas de líneas y polígonos.
Opcional: Son parámetros de filtro adicionales para definir mejor tu búsqueda.
Se muestra lo siguiente:
Una tabla con una fila por área geográfica La tabla contiene las columnas geography (GEOGRAPHY), count (INT64) y sample_place_ids (ARRAY<STRING>), en la que sample_place_ids contiene hasta 250 IDs de lugar para cada área geográfica.
Ejemplo: Calcula la cantidad de restaurantes en cada condado de la ciudad de Nueva York
En este ejemplo, se genera una tabla con la cantidad de restaurantes operativos por condado en la ciudad de Nueva York.
En este ejemplo, se usa el conjunto de datos públicos de BigQuery de los datos de la Oficina del Censo de los Estados Unidos para obtener los límites de los tres condados de la ciudad de Nueva York: "Queens", "Kings" y "New York". Los límites de cada condado se encuentran en la columna county_geom.
Luego, este ejemplo usa la función ST_SIMPLIFY de BigQuery para devolver una versión simplificada de county_geom. La función ST_SIMPLIFY reemplaza las cadenas de aristas casi rectas por una sola arista larga.
En las siguientes imágenes, se muestran estos datos en Looker Studio como un mapa completado, que incluye el contorno de cada condado:
Para importar tus datos a Looker Studio, sigue estos pasos:
Ejecuta la función anterior para generar los resultados.
En los resultados de BigQuery, haz clic en Abrir en -> Looker Studio. Tus resultados se importan automáticamente a Looker Studio.
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.
Selecciona todo el contenido de la página y bórralo.
Haz clic en Insertar -> Mapa completado para agregar un mapa completado a tu informe.
En Chart types -> Setup, configura los campos como se muestra a continuación:
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.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-06 (UTC)"],[],[],null,["The `PLACES_COUNT_PER_GEO` function takes an array of geographic areas to search\nand returns a table of places counts per area. For example, if you specify an\narray of zip codes as the search area, the response contains a table with a\nseparate row for each zip code.\n\nBecause the `PLACES_COUNT_PER_GEO` function returns a table, call it using\na `FROM` clause.\n\n- Input parameters:\n\n - **Required** : The `geographies`\n [filter parameter](/maps/documentation/placesinsights/experimental/filter-params) that specifies the search area. The\n `geographies` parameter takes an array of values defined by the BigQuery\n [`GEOGRAPHY`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-types#geography_type)\n data type, which supports points, linestrings, and polygons.\n\n - **Optional** : Additional [filter](/maps/documentation/placesinsights/experimental/filter-params) parameters to refine your\n search.\n\n- Returns:\n\n - A table with one row per geographic area. The table contains the columns `geography` (`GEOGRAPHY`) and `count` (`INT64`).\n\nExample: Calculate the number of restaurants in each county of New York City\n\nThis example generates a table of counts of operational restaurants per county\nin New York City.\n| **Note:** Because the response table contains a `geographies` field, you can visualize it using tools that support BigQuery `GEOGRAPHY` types. For an example of visualizing the results of a function, see [Visualize\n| results](#visualize_results). For more information and example on visualizing Places Insights results, see [Visualize query results](/maps/documentation/placesinsights/visualize-data).\n\nThis example uses the [United States Census Bureau\nData](https://console.cloud.google.com/marketplace/product/united-states-census-bureau/us-geographic-boundaries)\nBigQuery [public dataset](https://cloud.google.com/bigquery/public-data) to get\nthe boundaries for the three counties in New York City: \"Queens\",\"Kings\", \"New\nYork\". The boundaries of each county are contained in the `county_geom` column.\n\nThis example then uses the BigQuery\n[`ST_SIMPLIFY`](https://cloud.google.com/bigquery/docs/reference/standard-sql/geography_functions#st_simplify)\nfunction to return a simplified version of `county_geom`. The `ST_SIMPLIFY`\nfunction replaces nearly straight chains of edges with a single long edge. \n\n```googlesql\nDECLARE geos ARRAY\u003cGEOGRAPHY\u003e;\n\nSET geos = (SELECT ARRAY_AGG(ST_SIMPLIFY(county_geom, 100))\n FROM `bigquery-public-data.geo_us_boundaries.counties`\n WHERE county_name IN (\"Queens\",\"Kings\", \"New York\") AND state_fips_code = \"36\");\n\nSELECT * FROM `maps-platform-analytics-hub.sample_places_insights_us.PLACES_COUNT_PER_GEO`(\n JSON_OBJECT(\n 'geographies', geos,\n 'types', [\"restaurant\"],\n 'business_status', [\"OPERATIONAL\"]\n )\n);\n```\n\nThe response for the function:\n\nVisualize results\n\nThe following images show this data displayed in Looker Studio as a filled map,\nincluding the outline of each county:\n\nTo import your data into Looker Studio:\n\n1. Run the function above to generate the results.\n\n2. In the BigQuery results, click **Open in -\\\u003e Looker Studio**. Your results\n are automatically imported into Looker Studio.\n\n3. Looker Studio creates a default report page and initializes it with a title,\n table, and bar graph of the results.\n\n4. Select everything on the page and delete it.\n\n5. Click **Insert -\\\u003e Filled map** to add a filled map to your report.\n\n6. Under **Chart types -\\\u003e Setup** configure the fields as shown below::\n\n7. The filled map appears as above. You can optionally select **Chart types -\\\u003e\n Styles** to further configure the appearance of the map.\n\nFor more information and example on visualizing Places Insights results, see\n[Visualize query results](/maps/documentation/placesinsights/visualize-data)."]]