science Этот продукт или функция находится в экспериментальном состоянии (pre-GA). Продукты и функции Pre-GA могут иметь ограниченную поддержку, а изменения в продуктах и функциях Pre-GA могут быть несовместимы с другими версиями Pre-GA. Предложения Pre-GA подпадают под действие Особых условий сервиса платформы Google Карт . Для получения дополнительной информации см. описания этапа запуска . Зарегистрируйтесь , чтобы протестировать Places Insights!
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Функция PLACES_COUNT_PER_GEO принимает массив географических областей для поиска и возвращает таблицу количества мест в каждой области. Например, если в качестве области поиска указать массив почтовых индексов, ответ будет содержать таблицу с отдельной строкой для каждого почтового индекса.
Поскольку функция PLACES_COUNT_PER_GEO возвращает таблицу, вызовите ее с помощью предложения FROM .
Входные параметры:
Обязательно : параметр фильтраgeographies , задающий область поиска. Параметр geographies принимает массив значений, определяемых типом данных BigQuery GEOGRAPHY , который поддерживает точки, линии и многоугольники.
Необязательно : дополнительные параметры фильтра для уточнения поиска.
Возврат:
Таблица, содержащая по одной строке на каждый географический регион. Таблица содержит столбцы geography ( GEOGRAPHY ), count ( INT64 ) и sample_place_ids ( ARRAY<STRING> ), где sample_place_ids содержит до 250 идентификаторов мест для каждого географического региона.
Пример: подсчитайте количество ресторанов в каждом округе Нью-Йорка.
В этом примере создается таблица количества действующих ресторанов по округам Нью-Йорка.
В этом примере функция ST_SIMPLIFY из BigQuery возвращает упрощённую версию county_geom . Функция ST_SIMPLIFY заменяет почти прямые цепочки рёбер одним длинным ребром.
На следующих изображениях эти данные отображаются в Looker Studio в виде заполненной карты, включая контур каждого округа:
Чтобы импортировать данные в Looker Studio:
Запустите функцию выше, чтобы получить результаты.
В результатах BigQuery нажмите «Открыть в» -> «Looker Studio» . Результаты будут автоматически импортированы в Looker Studio.
Looker Studio создает страницу отчета по умолчанию и инициализирует ее заголовком, таблицей и гистограммой результатов.
Выделите все на странице и удалите.
Нажмите Вставка -> Заполненная карта , чтобы добавить заполненную карту в свой отчет.
В разделе Типы диаграмм -> Настройка настройте поля, как показано ниже:
Заполненная карта выглядит так, как показано выше. При желании вы можете выбрать «Типы диаграмм» -> «Стили» для дальнейшей настройки внешнего вида карты.
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 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)."]]