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

Данные Places Insights

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

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

В примере приведены данные для одного из крупнейших городов каждой из поддерживаемых стран:

• Амстердам (NL)
• Анкара (TR)
• Арекипа (PE)
• Афины (GR)
• Бад-Гаштайн (AT)
• Берлин (Германия)
• Брно (CZ)
• Брюссель (Бельгия)
• Бухарест (RO)
• Буэнос-Айрес (AR)
• Пусан (KR)
• Каир (EG)
• Чиангмай (TH)
• Копенгаген (DK)
• Корк (IE)
• Дебрецен (HU)
• Ханой (VN)
• Хельсинки (FI)
• Гонконг (HK)
• Джакарта (ID)
• Джидда (SA)
• Йоханнесбург (ZA)
• Куала-Лумпур (MY)
• Лиссабон (PT)
• Лондон (Великобритания)
• Лусаил (QA)
• Мадрид (ES)
• Манила (PH)
• Медельин (CO)
• Мехико (MX)
• Мумбаи (IN)
• Нью-Йорк (США)
• Осло (NO)
• Париж (FR)
• Пловдив (BG)
• Риффа (BH)
• Рим (IT)
• Сантьяго (CL)
• Сан-Паулу (BR)
• Шарджа (AE)
• Сингапур (SG)
• Стокгольм (SE)
• Сидней (Австралия)
• Тайбэй (TW)
• Тель-Авив-Яффо (IL)
• Токио (Япония)
• Торонто (Канада)
• Варшава (PL)
• Веллингтон (Новая Зеландия)
• Цюрих (CH)

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

Набор данных для каждой страны имеет собственную страницу, на которую нужно подписаться отдельно. Подробнее о том, как подписаться на продукт…

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

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

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

Например, если вы работаете с набором данных для Испании (ES), используйте как основную схему, так и схему для Испании.

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

• id – идентификатор бренда.
• name – название бренда, например "Hertz" или "Chase".
• category – категория верхнего уровня, к которой относится бренд, например "Автозаправочная станция", "Еда и напитки" или "Жилье".

Примечание. В текущей версии данные о брендах доступны только для Австралии, Великобритании, Канады и США.

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

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

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

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

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

Запросы функции Places Count

Функции Places Count могут возвращать список идентификаторов мест, которые можно использовать для поиска информации об отдельных местах с помощью других продуктов платформы Google Карт, таких как Places API и Places UI Kit.

Для функций подсчета мест не применяется порог агрегирования, но применяется минимальная область поиска 40 на 40 метров (1600 м²). Это означает, что если ваш поисковый запрос больше минимальной области поиска, вы всегда получите результат, даже если ни одно место не соответствует вашему запросу.

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

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

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

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

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