Interroger les modifications des POI entre les mois (PLACES_COUNT_CHANGE)

Ce produit ou cette fonctionnalité est en Preview (pré-DG). La prise en charge des fonctionnalités et produits pré-DG peut être limitée, et il se peut que les modifications apportées à ces fonctionnalités ou produits ne soient pas compatibles avec d'autres versions pré-DG. Les offres en pré-DG sont couvertes par les Conditions spécifiques du service Google Maps Platform. Pour en savoir plus, consultez les descriptions des étapes de lancement.

La fonction PLACES_COUNT_CHANGE calcule les variations du nombre de lieux d'intérêt et récupère des exemples d'ID de lieux ajoutés et supprimés entre deux mois spécifiques dans plusieurs zones géographiques d'entrée.

Comme PLACES_COUNT_V2, cette fonction est conçue pour un traitement par lot efficace en acceptant un paramètre de table d'entrée de zones géographiques, ce qui vous permet d'évaluer simultanément les tendances de croissance et les changements commerciaux dans de nombreux lieux.

Syntaxe

SELECT *
FROM
  `PROJECT_NAME.LINKED_DATASET_NAME.PLACES_COUNT_CHANGE`(
    TABLE input_geographies,
    filters
  );

Paramètres

• PROJECT_NAME : nom de votre projet Google Cloud
• LINKED_DATASET_NAME: nom de l'ensemble de données BigQuery contenant les fonctions Places Insights (par exemple, places_insights___us)
• input_geographies : table BigQuery contenant les zones géographiques à analyser. Cette table doit inclure les colonnes suivantes :
  • geo_id (STRING) : identifiant unique de chaque zone géographique.
  • geo (GEOGRAPHY) : objet GEOGRAPHY BigQuery représentant la zone. Il peut s'agir d'un point, d'un polygone ou d'un autre type de zone géographique.
• filters (JSON) : objet JSON contenant des paires clé-valeur pour filtrer les lieux. Consultez Paramètres de filtre. Il doit inclure les filtres suivants :
  • month1 (STRING): premier mois pour lequel rechercher des lieux.
  • month2 (STRING): deuxième mois pour lequel rechercher des lieux.

Schéma de la table de sortie

La fonction PLACES_COUNT_CHANGE renvoie une table avec les colonnes suivantes :

Nom de la colonne	Type de données	Description
geo_id	STRING	ID de la zone géographique d'entrée.
start_count	INT64	Nombre de lieux du premier mois.
end_count	INT64	Nombre de lieux du deuxième mois.
net_change	INT64	Différence entre end_count et start_count (end_count - start_count).
percentage_change	FLOAT64	Variation en pourcentage entre month1 et month2.
compound_monthly_growth_rate	FLOAT64	Taux de croissance mensuel composé entre month1 et month2.
added_count	INT64	Nombre d'ID de lieux d'exemple dans sample_added_place_ids.
removed_count	INT64	Nombre d'ID de lieux d'exemple dans sample_removed_place_ids.
sample_added_place_ids	ARRAY<STRING>	Liste d'ID de lieux d'exemple présents dans month2, mais pas dans month1.
sample_removed_place_ids	ARRAY<STRING>	Liste d'ID de lieux d'exemple présents dans month1, mais pas dans month2.

Les résultats sont triés par ordre décroissant en fonction de percentage_change et start_count.

Fonctionnement

La fonction traite chaque ligne de la table input_geographies. Pour chaque geo objet, elle compte le nombre de lieux situés dans la zone géographique (ou dans le geography_radius si le geo est un point et que le rayon est spécifié dans les filters) au cours des deux mois spécifiés dans month1 et month2 dans les filters. À l'aide de ces lieux, elle calcule d'autres statistiques utiles, telles que la variation en pourcentage et le taux de croissance mensuel composé entre le premier et le deuxième mois.

Le nombre inclut uniquement les lieux qui correspondent à toutes les conditions définies dans l'objet JSON filters.

Exemple : Calculer les variations du nombre de lieux d'intérêt entre deux mois

Cet exemple montre comment interroger les variations du nombre de lieux d'intérêt entre deux mois spécifiques à l'aide des paramètres month1 et month2, avec un rayon de 5 000 à partir d'un point de géolocalisation donné.

WITH my_locations AS (
  SELECT
    'loc_1' AS geo_id,
    ST_GEOGFROMTEXT('POINT(-122.4194 37.7749)') AS geo
  -- Add more target locations as needed...
)

SELECT *
FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_CHANGE`(
  TABLE my_locations,
  JSON_OBJECT(
    'geography_radius', 5000,
    'month1', '2026-01', -- Baseline snapshot month (YYYY-MM)
    'month2', '2026-02'  -- Comparison snapshot month (YYYY-MM)
  )
);

Analyser la sortie

La requête renvoie une table avec une ligne pour chaque zone géographique d'entrée.

• Métriques de croissance : la sortie affiche le nombre de référence (start_count : 89 560) et le nombre de comparaison (end_count : 90 923), ce qui donne une net_change de +1 363 lieux (+1,52% de percentage_change).
• Inspection de la vérité terrain : le tableau sample_added_place_ids répertorie les ID de lieux spécifiques qui sont devenus actifs dans month2 (février 2026), tandis que sample_removed_place_ids répertorie les ID de lieux qui ne sont plus présents.
• Passerelle vers l'API Places : vous pouvez transmettre directement ces exemples d'ID de lieux à l'API Place Details (New) pour rechercher les noms, les adresses et les attributs des entreprises nouvellement ouvertes ou fermées.