Данные Places Insights
Places Insights предоставляет полные и выборочные наборы данных в BigQuery.
Примеры наборов данных предназначены для того, чтобы вы могли попробовать Places Insights и оценить удобство использования и ценность продукта, прежде чем принимать решение о покупке полного набора данных. Пример набора данных содержит только данные для самого города. Данные по прилегающим районам не учитываются.
В примере приведены данные для одного из крупнейших городов каждой из поддерживаемых стран:
| Амстердам (NL) | Хельсинки (FI) | Пловдив (BG) |
| Анкара (TR) | Гонконг (HK) | Риффа (BH) |
| Арекипа (PE) | Джакарта (ID) | Рим (IT) |
| Афины (GR) | Джидда (SA) | Сантьяго (CL) |
| Бад-Гаштайн (AT) | Йоханнесбург (ZA) | Сан-Паулу (Бразилия) |
| Берлин (DE) | Куала-Лумпур (MY) | Шарджа (AE) |
| Брно (CZ) | Лиссабон (PT) | Сингапур (SG) |
| Брюссель (Бельгия) | Лондон (Великобритания) | Стокгольм (SE) |
| Бухарест (RO) | Лусаил (QA) | Сидней (Австралия) |
| Буэнос-Айрес (AR) | Мадрид (ES) | Тайбэй (TW) |
| Пусан (KR) | Манила (PH) | Тель-Авив-Яффо (Израиль) |
| Каир (EG) | Медельин (CO) | Токио (Япония) |
| Чиангмай (TH) | Мехико (MX) | Торонто (Канада) |
| Копенгаген (DK) | Мумбаи (IN) | Варшава (PL) |
| Корк (IE) | Нью-Йорк (США) | Веллингтон (Новая Зеландия) |
| Дебрецен (HU) | Осло (NO) | Цюрих (CH) |
| Ханой (VN) | Париж (FR) |
Полные наборы данных включают информацию по каждой поддерживаемой стране и доступны только на платной основе. Если вы хотите зарегистрироваться в Places Insights, заполните форму запроса. Запрашивать доступ к набору данных Places Insights нужно только подписчику данных. После активации подписки в проекте BigQuery любой пользователь, у которого есть доступ к этому проекту, может запрашивать данные Аналитики мест.
Набор данных для каждой страны имеет собственную страницу, на которую нужно подписаться отдельно. Подробнее о том, как подписаться на продукт…
Схемы наборов данных
Схема набора данных о местах для каждой страны состоит из двух частей:
- Основная схема, которая является общей для наборов данных по всем странам.
- Схема для определенной страны, которая определяет компоненты схемы, относящиеся к этой стране.
Например, если вы работаете с набором данных для Испании (ES), используйте как основную схему, так и схему для Испании.
Схема для набора данных о брендах определяет три поля:
id– идентификатор бренда.name– название бренда, например "Hertz" или "Chase".category– категория бренда, например "Заправочная станция", "Еда и напитки" или "Жилье".
Как запрашивать данные Places Insights
Places Insights API позволяет запрашивать наборы данных двумя способами:
- Отправлять запросы к набору данных напрямую с помощью 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 x 40 м (1600 м2). Это означает, что если ваш поисковый запрос больше минимальной области поиска, вы всегда получите результат, даже если ни одно место не соответствует вашему запросу.
Когда запрашивать данные напрямую, а когда использовать функции
Если вам не нужны низкие значения результатов, вы хотите получить не только количество, но и другие данные, например AVG, SUM или COUNTIF, или вам нужно выполнить более сложные запросы, например объединить наборы данных, отправьте запрос напрямую.
Используйте функции, если вам нужно узнать, мало ли результатов или их нет вообще, или если вам нужно получить информацию об отдельном месте, например его название или адрес.
В таблице ниже приведено подробное сравнение прямых запросов и функций Places Count.
| Функции подсчета мест | Прямые запросы к набору данных | |
|---|---|---|
| Преимущества |
|
|
| Интерфейс | Четыре предопределенные функции SQL, которые генерируют статистику COUNT: одно значение, значение по типу, значение по географическому местоположению, значение по ячейке H3. JSON_OBJECT передает аргументы в функцию. |
Напишите собственный SQL-запрос, чтобы запустить агрегатные функции, такие как COUNT, COUNT_IF, SUM и AVG.. Дополнительную статистику можно получить с помощью JOIN, GROUP BY, WHERE и других функций. |
| Ограничения | Минимальная область поиска – 40 х 40 м (1600 м2). Функция возвращает результат, даже если количество агрегированных данных меньше пяти, при условии, что соблюдены требования к минимальной области поиска. | Результаты, в которых количество меньше 5, опускаются (строка исключается). |
| Поддерживаемые фильтры атрибутов | Параметры фильтрации функции Places Count поддерживают те же фильтры атрибутов, что и прямой запрос, за исключением следующих:
|
Поддерживается полная схема. |