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

Данные Places Insights

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

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

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

  • Амстердам (NL)
  • Анкара (TR)
  • Арекипа (PE)
  • Афины (GR)
  • Бад-Гаштайн (AT)
  • Берлин (DE)
  • Брно (CZ)
  • Брюссель (Бельгия)
  • Бухарест (RO)
  • Буэнос-Айрес (AR)
  • Пусан (KR)
  • Каир (EG)
  • Чиангмай (TH)
  • Копенгаген (DK)
  • Корк (IE)
  • Дебрецен (HU)
  • Ханой (VN)
  • Хельсинки (FI)
  • Гонконг (HK)
  • Джакарта (ID)
  • Джидда (SA)
  • Йоханнесбург (ZA)
  • Куала-Лумпур (Малайзия)
  • Лиссабон (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 API

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

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

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

При прямом запросе данных порог агрегирования равен 1. Строка с результатами возвращается, только если она содержит данные хотя бы об одном месте. Если критериям поиска соответствует 0 мест, эта строка опускается в ответе.

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

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

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

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

Если вам нужны не только количественные показатели, но и другие данные, например 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). Функция возвращает результат, в том числе 0, если минимальная область поиска соответствует условию. Результаты с количеством 0 опускаются (строка исключается).
Поддерживаемые фильтры атрибутов Параметры фильтра функции Places Count поддерживают те же фильтры атрибутов, что и прямой запрос, за исключением следующих:
  • Место "id"
  • Компоненты адреса
Поддерживается полная схема.