В выпуск 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";