Guide de migration

La version de Places Insights du 4 septembre 2025 inclut les modifications suivantes par rapport à la version initiale :

  • Vous pouvez vous abonner à Places Insights dans la région BigQuery de votre choix.

  • Déplace les ensembles de données Places Insights des data clean room vers les fiches de l'échange de données BigQuery.

  • Les champs d'adresse du schéma de l'ensemble de données séparent les champs id et name en champs de chaîne ou de tableau de chaînes distincts.

Migrer vers les fiches

La version Preview initiale de Places Insights a déployé des données dans les data clean room BigQuery. Avec la version du 4 septembre 2025, nous avons déplacé les ensembles de données vers les fiches BigQuery pour vous permettre de vous abonner à l'ensemble de données dans une région BigQuery spécifique. Ce changement n'a aucune incidence sur les fonctionnalités et l'usabilité de Places Insights.

Pour vous abonner à Places Insights dans une région spécifique, vous devez vous abonner aux nouvelles fiches dans le partage BigQuery. Une fois que vous vous êtes abonné aux nouvelles fiches, vous n'avez pas besoin de modifier vos requêtes SQL. Elles fonctionneront toujours de la même manière.

  • Nouveaux utilisateurs : si vous êtes un nouvel utilisateur de Places Insights, suivez les étapes de Configurer Places Insights pour configurer votre environnement de développement et accéder aux fiches.

  • Utilisateurs existants : suivez les étapes ci-dessous pour migrer vers les fiches.

Étapes de migration

Pour migrer vers les fiches, vous devez :

  1. Abonnez-vous aux fiches de la ville et du pays de votre choix. Pour obtenir des instructions, consultez Configurer Places Insights.

  2. Remplacez le nom de l'ensemble de données dans vos requêtes ou fonctions par celui que vous avez choisi ci-dessus.

  3. Si vous avez déjà utilisé des fonctions, supprimez le nom du projet utilisé avec les data clean rooms (maps-platform-analytics-hub).

  4. Modifiez vos requêtes ou fonctions existantes pour inclure le nom de votre projet (facultatif) et les nouveaux champs d'adresse.

Incluez le nom de votre projet lorsque vous faites référence à la fiche (facultatif).

Avec les fiches, vous pouvez inclure le nom de votre projet dans la requête. Si vous ne spécifiez pas de nom de projet, votre requête sera exécutée par défaut dans le projet actif.

Vous pouvez inclure le nom de votre projet si vous avez associé des ensembles de données portant le même nom dans différents projets ou si vous interrogez une table en dehors du projet actif.

Exemple de requête mise à jour avec le nom du projet et de l'ensemble de données

Cette requête inclut un nom de projet et utilise le nom de l'ensemble de données my_dataset_name :

SELECT WITH AGGREGATION_THRESHOLD
COUNT(*) AS count
FROM `PROJECT_NAME.my_dataset_name.places`

Migrer vers les nouveaux champs d'adresse

Dans la version initiale de Places Insights, le schéma de l'ensemble de données représentait un champ d'adresse sous la forme d'un STRUCT ou d'un RECORD contenant un sous-champ id et name. Cette version aplatit le schéma pour définir des champs de premier niveau distincts pour id et name. Les nouveaux champs sont des champs de chaîne ou de tableau de chaînes.

Par exemple, le schéma du composant d'adresse de la localité pour la version initiale est présenté ci-dessous :

locality STRUCT
  locality.id STRING
  locality.name STRING

Dans cette version, l'ensemble de données contient désormais deux champs de tableau de chaînes de premier niveau. Par exemple, le schéma de données de localité mis à jour est présenté ci-dessous :

locality_ids ARRAY<string>
locality_names ARRAY<string>

Consultez la documentation de référence sur le schéma.

Champs non matriciels

Dans cette version, les champs id et name sont désormais des champs STRING de premier niveau pour les champs d'adresse non matriciels :

administrative_area_level_1_id STRING
administrative_area_level_1_name STRING

Ce nouveau format s'applique à tous les champs du formulaire administrative_area_level_N, où N est compris entre 1 et 7.

Exemple utilisant les nouveaux champs

Dans la version initiale de Places Insights, vous utilisiez le champ administrative_area_level_1.name dans une clause WHERE pour filtrer les résultats :

SELECT WITH AGGREGATION_THRESHOLD
COUNT(*) AS count
FROM `PROJECT_NAME.places_insights___us.places`
WHERE administrative_area_level_1.name = "New York";

Avec les nouveaux champs, vous écrivez la requête à l'aide du champ 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";