Функция PLACES_COUNT_PER_TYPE

Функция PLACES_COUNT_PER_TYPE возвращает таблицу с подсчетом количества посещений для каждого указанного в функции типа места. Например, если вы выполните поиск по типам doctor , hospital и pharmacy в ответе будет таблица с отдельной строкой для каждого типа.

Поскольку функция PLACES_COUNT_PER_TYPE возвращает таблицу, вызывайте её, используя предложение FROM .

  • Входные параметры:

    • Обязательный параметр : параметр geography фильтра , определяющий область поиска. Параметр geography принимает значение, заданное типом данных BigQuery GEOGRAPHY , который поддерживает точки, линейные линии и полигоны.

      Примеры использования различных типов географических областей поиска, таких как области просмотра и линии, см. в функции PLACES_COUNT .

    • Обязательный параметр : параметр фильтра types , указывающий типы мест, для которых следует производить поиск.

    • Дополнительно : Дополнительные параметры фильтра для уточнения поиска.

  • Возвращает:

    • Таблица, содержащая по одной строке для каждого значения types . Таблица включает столбцы type ( STRING ), count ( INT64 ) и place_ids ( ARRAY<STRING> ), где place_ids содержит до 250 идентификаторов мест для каждого type .

Пример: Возвращает количество ресторанов, кафе и баров.

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

Параметр types принимает массив STRING значений, определяющих типы мест для поиска. Полный список возможных значений см. в разделе «Типы мест» .

В этом примере также используется функция BigQuery ST_GEOGFROMTEXT для возврата значения GEOGRAPHY из полигона.

DECLARE geo GEOGRAPHY;
SET geo = ST_GEOGFROMTEXT('''POLYGON((-73.985708 40.75773,-73.993324 40.750298,
                                      -73.9857 40.7484,-73.9785 40.7575,
                                      -73.985708 40.75773))''');  -- NYC viewport

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_TYPE`(
  JSON_OBJECT(
      'types', ["restaurant", "cafe", "bar"],
      'geography', geo,
      'business_status', ['OPERATIONAL']
      )
);

Эта функция возвращает таблицу с тремя строками, по одной для каждого типа:

Результаты поиска по запросу «Количество мест» в Нью-Йорке.