В этом выпуске Places Insights от 4 сентября 2025 года внесены следующие изменения по сравнению с первоначальным релизом:
- Поддерживает возможность подписки на Places Insights в выбранном вами местоположении BigQuery .
Переносит наборы данных Places Insights из комнат для очистки данных в списки обмена данными BigQuery .
В схеме набора данных поля адреса разделяют поля
idиnameна отдельные строковые поля или массивы строк.
Перейти к листингам
В первоначальной предварительной версии Places Insights данные размещались в чистых комнатах BigQuery. С выпуском от 4 сентября 2025 года мы перенесли наборы данных в списки BigQuery, чтобы вы могли подписаться на набор данных в определённом регионе BigQuery . Это изменение не влияет на функции продукта и удобство использования Places Insights.
Чтобы подписаться на Places Insights в определённом регионе, вам необходимо подписаться на новые списки в BigQuery Sharing. После подписки на новые списки вам не нужно изменять SQL-запросы. Они будут работать так же, как и раньше.
Новым пользователям: Если вы являетесь новым пользователем Places Insights, выполните действия, описанные в разделе «Настройка Places Insights» , чтобы настроить среду разработки для доступа к спискам объектов недвижимости.
Существующим пользователям: выполните следующие шаги, чтобы перейти на использование объявлений.
Этапы миграции
Для перехода на листинги вам необходимо:
Подпишитесь на рассылку для выбранного вами города и страны. Инструкции см. в разделе «Настройка Places Insights» .
В запросах или функциях измените имя набора данных на выбранное вами выше.
Если вы ранее использовали функции , удалите название проекта, используемое для очистки данных (
maps-platform-analytics-hub).Измените существующие запросы или функции, добавив название вашего проекта (необязательно) и новые поля адреса .
При указании ссылки на объявление, пожалуйста, укажите название вашего проекта (необязательно).
При работе со списками вы можете указать название своего проекта в запросе. Если вы не укажете название проекта, запрос по умолчанию будет использовать название активного проекта.
Если у вас есть связанные наборы данных с одинаковым именем в разных проектах или если вы запрашиваете данные из таблицы, находящейся за пределами активного проекта, вам может потребоваться указать название вашего проекта.
Пример обновленного запроса с указанием названия проекта и набора данных.
Этот запрос включает название проекта и использует имя набора данных my_dataset_name :
SELECT WITH AGGREGATION_THRESHOLD
COUNT(*) AS count
FROM `PROJECT_NAME.my_dataset_name.places`
Перейти на новые поля адреса
В первой версии Places Insights схема набора данных представляла поле адреса как STRUCT или RECORD содержащую подполя id и name . В этой версии схема преобразована в более плоскую структуру, чтобы определить отдельные поля верхнего уровня для id и name . Новые поля представляют собой строки или массивы строк.
Например, схема компонента локального адреса для первоначальной версии показана ниже:
locality | STRUCT | |
locality.id | STRING | |
locality.name | STRING | |
В этой версии набор данных теперь содержит два поля верхнего уровня в виде строковых массивов. Например, обновленная схема данных о местоположении показана ниже:
locality_ids | ARRAY<string> |
locality_names | ARRAY<string> |
Полную схему см. в справке .
Поля, не являющиеся массивами
В этой версии поля id и name теперь являются STRING полями верхнего уровня для адресных полей, не являющихся массивами:
administrative_area_level_1_id | STRING |
administrative_area_level_1_name | STRING |
Новый формат применяется ко всем полям вида administrative_area_level_N , где N равно 1–7.
Пример использования новых полей
В первоначальной версии Places Insights для фильтрации результатов использовалось поле administrative_area_level_1.name в условии WHERE :
SELECT WITH AGGREGATION_THRESHOLD
COUNT(*) AS count
FROM `PROJECT_NAME.places_insights___us.places`
WHERE administrative_area_level_1.name = "New York";
С учетом новых полей, запрос следует писать, используя поле administrative_area_level_1_name :
SELECT WITH AGGREGATION_THRESHOLD
COUNT(*) AS count
FROM `PROJECT_NAME.places_insights___us.places`
WHERE administrative_area_level_1_name = "New York";