Guide de migration

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

  • Vous pouvez vous abonner à Places Insights dans l'emplacement BigQuery de votre choix.

  • Les ensembles de données Places Insights sont déplacés des data clean room vers les fiches BigQuery Data Exchange listings.

  • Les champs d'adresse du schéma d'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 bêta 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 . Cette modification n'a aucun impact sur les fonctionnalités du produit ni sur la facilité d'utilisation de Places Insights.

Pour vous abonner à Places Insights dans une région spécifique, vous devez vous abonner aux nouvelles fiches dans BigQuery Sharing. 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 la procédure décrite dans Configurer Places Insights pour configurer votre environnement de développement afin d’accéder aux fiches.

  • Utilisateurs existants : suivez la procédure ci-dessous pour migrer vers les fiches.

Procédure de migration

Pour migrer vers les fiches, vous devez procéder comme suit :

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

  2. Mettez à jour le nom de l'ensemble de données dans vos requêtes ou fonctions avec le nom d'ensemble de données que vous avez choisi ci-dessus.

  3. Si vous avez déjà utilisé des fonctions, supprimez le nom de projet utilisé avec les data clean room (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.

Inclure 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 utilisera par défaut 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 d'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 d'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 complète sur le schéma.

Champs non de type tableau

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

administrative_area_level_1_id STRING
administrative_area_level_1_name STRING

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

Exemple d'utilisation de nouveaux champs

Dans la version initiale de Places Insights, vous avez utilisé 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";