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

Данные Places Insights

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

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

В список примеров включены данные по самому популярному городу для каждой из поддерживаемых стран: Сидней (AU), Сан-Паулу (BR), Торонто (CA), Цюрих (CH), Берлин (DE), Мадрид (ES), Париж (FR), Лондон (UK), Джакарта (ID), Мумбаи (IN), Рим (IT), Токио (JP), Мехико (MX), Нью-Йорк (US).

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

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

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

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

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

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

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

• id : Идентификатор бренда.
• name : название бренда, например «Hertz» или «Chase».
• category : категория высокого уровня бренда, например, «Автозаправочная станция», «Еда и напитки» или «Жилье».

Запрос данных Places Insights

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

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

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

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

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

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

Функции подсчёта мест не устанавливают порог агрегации, а вместо этого устанавливают минимальную область поиска 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 места Компоненты адреса Часы работы Варианты зарядки электромобилей Бренды	Поддерживается полная схема .