Функция PLACES_COUNT_PER_GEO

Функция 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 идентификаторов мест для каждого географического региона.

Пример: подсчитайте количество ресторанов в каждом округе Нью-Йорка.

В этом примере создается таблица количества действующих ресторанов по округам Нью-Йорка.

В этом примере используется общедоступный набор данных BigQuery Бюро переписи населения США для получения границ трёх округов Нью-Йорка: «Куинс», «Кингс» и «Нью-Йорк». Границы каждого округа содержатся в столбце county_geom .

В этом примере функция ST_SIMPLIFY из BigQuery возвращает упрощённую версию county_geom . Функция ST_SIMPLIFY заменяет почти прямые цепочки рёбер одним длинным ребром.

DECLARE geos ARRAY<GEOGRAPHY>;

SET geos = (SELECT ARRAY_AGG(ST_SIMPLIFY(county_geom, 100))
            FROM `bigquery-public-data.geo_us_boundaries.counties`
            WHERE county_name IN ("Queens","Kings", "New York") AND state_fips_code = "36");

SELECT * FROM `maps-platform-analytics-hub.sample_places_insights_us.PLACES_COUNT_PER_GEO`(
  JSON_OBJECT(
      'geographies', geos,
      'types', ["restaurant"],
      'business_status', ["OPERATIONAL"]
      )
);

Ответ для функции:

Результаты фильтрации по округам Нью-Йорка.

Визуализация результатов

На следующих изображениях эти данные отображаются в Looker Studio в виде заполненной карты, включая контур каждого округа:

Заполненная карта для фильтрации магазинов повседневного спроса и продуктовых магазинов, доступных для людей с ограниченными возможностями, в Нью-Йорке.

Чтобы импортировать данные в Looker Studio:

  1. Запустите функцию выше, чтобы получить результаты.

  2. В результатах BigQuery нажмите «Открыть в» -> «Looker Studio» . Результаты будут автоматически импортированы в Looker Studio.

  3. Looker Studio создает страницу отчета по умолчанию и инициализирует ее заголовком, таблицей и гистограммой результатов.

    Отчет по умолчанию в Looker Studio.

  4. Выделите все на странице и удалите.

  5. Нажмите Вставка -> Заполненная карта , чтобы добавить заполненную карту в свой отчет.

  6. В разделе Типы диаграмм -> Настройка настройте поля, как показано ниже:

    Настройка тепловой карты в Looker Studio.

  7. Заполненная карта выглядит так, как показано выше. При желании вы можете выбрать «Типы диаграмм» -> «Стили» для дальнейшей настройки внешнего вида карты.

Дополнительную информацию и примеры визуализации результатов Places Insights см. в разделе Визуализация результатов запроса .