Эта страница переведена с помощью Cloud Translation API.

О данных и запросах Places Insights

Данные Places Insights

Places Insights предоставляет полные и примерные наборы данных в BigQuery.

Представленные примеры данных предназначены для того, чтобы вы могли протестировать Places Insights и оценить удобство использования и ценность продукта, прежде чем принимать решение о приобретении полного набора данных. Примерный набор данных содержит только данные по самому городу. Он не содержит данных по окружающей его агломерации.

В приведенном примере представлены данные по одному из ведущих городов каждой из поддерживаемых стран: Сидней (Австралия), Сан-Паулу (Бразилия), Торонто (Канада), Цюрих (Швейцария), Берлин (Германия), Мадрид (Испания), Париж (Франция), Лондон (Великобритания), Джакарта (Ирландия), Мумбаи (Индия), Рим (Италия), Токио (Япония), Мехико (Мексика), Нью-Йорк (США).

Полные наборы данных включают информацию по каждой поддерживаемой стране и должны быть приобретены. Если вы заинтересованы в приобретении полного набора данных, заполните форму запроса . Доступ к набору данных Places Insights должен запрашивать только подписчик данных. После активации подписки в проекте BigQuery любой пользователь, имеющий доступ к этому проекту, может запрашивать данные Places Insights.

Для каждого набора данных по стране существует свой собственный список, на который необходимо подписаться отдельно. Дополнительную информацию о подписке на список см. в разделе «Настройка Places Insights» .

Схемы наборов данных

Схема набора данных о местах для каждой страны состоит из двух частей:

Основная схема , общая для всех наборов данных по странам.
Схема, специфичная для конкретной страны , определяющая компоненты схемы, характерные именно для этой страны.

Например, если вы работаете с набором данных по Испании (ES), укажите ссылки как на основную схему, так и на схему, специфичную для Испании.

Схема набора данных о брендах определяет три поля:

id : Идентификатор бренда.
name : Название бренда, например, "Hertz" или "Chase".
category : Категория бренда высокого уровня, например, «Автозаправочная станция», «Продукты питания и напитки» или «Проживание».

Данные Query Places Insights

Places Insights предлагает два способа запроса к наборам данных:

Запрос к набору данных напрямую с помощью SQL : выполняйте стандартные SQL-запросы BigQuery к таблицам набора данных. Это обеспечивает максимальную гибкость для сложной фильтрации, объединения с собственными данными, пользовательского анализа и поддержки дополнительных агрегационных функций помимо COUNT , таких как AVG , SUM и GROUP BY . См. документацию .
Запрос к набору данных с помощью функций подсчета мест : Функции подсчета мест — это предопределенные, оптимизированные SQL-запросы, которые выполняются непосредственно в BigQuery и упрощают распространенные задачи извлечения данных. Они предоставляют более детальную информацию, например, возвращают идентификаторы мест для поиска подробностей об отдельных местах. См. документацию .

Прямые запросы

При прямом запросе к данным применяется пороговое значение агрегации. Результат возвращается только в том случае, если запрос агрегирует не менее 5 мест. Например, если в результате поиска отображается количество 0, 1, 2, 3 или 4, то результат исключается из ответа. Например, запрос на общее количество ресторанов в данном районе вернет ответ только в том случае, если общее количество равно 5 или больше, в противном случае ответ не будет возвращен.

Запросы функции подсчета мест

Функции подсчета мест могут возвращать список идентификаторов мест (Place ID), которые можно использовать для поиска информации об отдельных местах с помощью других продуктов GMP, таких как Places API и Places UI Kit .

Функции подсчета мест не устанавливают пороговое значение агрегации, а вместо этого определяют минимальную область поиска в 40,0 на 40,0 метров (1600 ^м² ). Это означает, что пока ваш поисковый запрос превышает минимальную область поиска, вы всегда получите результат, даже если нет мест, соответствующих вашему запросу.

Когда следует запрашивать данные напрямую, а когда использовать функции.

Если вам не требуется малое количество результатов, если вы хотите получить информацию, выходящую за рамки простого подсчета, например, с помощью функций AVG , SUM или COUNTIF , или если вам необходимо выполнять более сложные запросы, такие как объединение наборов данных, вы можете запрашивать данные напрямую.

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

В этой таблице представлено подробное сравнение различий между прямыми запросами и функциями подсчета мест.

	Функции подсчета мест	Прямые запросы к наборам данных
Преимущества	Возвращает идентификаторы мест, которые можно использовать для запросов к другим API. Может возвращать любое количество. Оптимизировано для повышения производительности и снижения затрат на обработку. Простота в использовании. Нет необходимости писать сложные запросы. Проверяет входные параметры и возвращает ошибку, что упрощает использование и отладку.	Позволяет выполнять сложные запросы, такие как расширенная фильтрация и объединения таблиц. Не устанавливает минимальную зону поиска. Поддерживает дополнительные агрегатные функции помимо `COUNT` , такие как `AVG` , `SUM` и `GROUP BY` .
Интерфейс	Четыре предопределенные SQL-функции, которые генерируют данные `COUNT` : подсчет одного события, подсчет по типу, подсчет по географическому признаку, подсчет по ячейке H3. В функцию передаются аргументы в формате `JSON_OBJECT` .	Напишите собственный SQL-запрос для выполнения агрегатных функций, таких как `COUNT` , `COUNT_IF` , `SUM` и `AVG.` Дополнительные аналитические данные можно получить с помощью `JOIN` , `GROUP BY` , `WHERE` и других.
Ограничения	Устанавливает минимальную зону поиска размером 40,0 на 40,0 метров (1600 ^м² ). Функция возвращает результат, даже если количество агрегированных элементов меньше 5, при условии соблюдения минимальной зоны поиска.	Результаты с количеством меньше 5 исключаются из общего числа результатов (т.е. строка исключается).
Поддерживаемые фильтры атрибутов	Параметры фильтра функции подсчета мест поддерживают те же параметры, что и фильтры атрибутов прямого запроса, за исключением следующих моментов: `id` места Адресные компоненты Часы работы варианты зарядки электромобилей Бренды	Поддерживается полная схема .