Fonction PLACES_COUNT_PER_GEO

La fonction PLACES_COUNT_PER_GEO utilise un tableau de zones géographiques à rechercher et renvoie un tableau du nombre de lieux par zone. Par exemple, si vous spécifiez un tableau de codes postaux comme zone de recherche, la réponse contient un tableau avec une ligne distincte pour chaque code postal.

Étant donné que la fonction PLACES_COUNT_PER_GEO renvoie une table, appelez-la à l'aide d'une clause FROM.

• Paramètres d'entrée :

  • Obligatoire : geographies paramètre de filtre qui spécifie la zone de recherche. Le paramètre geographies accepte un tableau de valeurs définies par le type de données GEOGRAPHY de BigQuery, qui accepte les points, les chaînes de lignes et les polygones.

  • Facultatif : paramètres de filtre supplémentaires pour affiner votre recherche.

• Renvoie :

  • Tableau avec une ligne par zone géographique. La table contient les colonnes geography (GEOGRAPHY), count (INT64) et place_ids (ARRAY<STRING>), où place_ids contient jusqu'à 250 ID de lieu pour chaque zone géographique.

Exemple : Calculer le nombre de restaurants dans chaque comté de New York

Cet exemple génère un tableau du nombre de restaurants en activité par comté dans la ville de New York.

Cet exemple utilise l'ensemble de données public BigQuery United States Census Bureau Data pour obtenir les limites des trois comtés de New York : "Queens", "Kings" et "New York". Les limites de chaque comté sont contenues dans la colonne county_geom.

Cet exemple utilise ensuite la fonction BigQuery ST_SIMPLIFY pour renvoyer une version simplifiée de county_geom. La fonction ST_SIMPLIFY remplace les suites d'arêtes presque rectilignes par une arête longue unique.

DECLARE geos ARRAY<GEOGRAPHY>;

SET geos = (SELECT ARRAY_AGG(ST_SIMPLIFY(county_geom, 100))
            FROM `bigquery-public-data.geo_us_boundaries.counties`
            WHERE county_name IN ("Queens","Kings", "New York") AND state_fips_code = "36");

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_GEO`(
  JSON_OBJECT(
      'geographies', geos,
      'types', ["restaurant"],
      'business_status', ["OPERATIONAL"]
      )
);

Exemple : Calculer les décomptes par comté filtrés par marque

L'exemple suivant utilise le filtre brand_ids pour récupérer le nombre de lieux et des exemples d'ID de lieu pour des marques spécifiques, comme Starbucks "1413758728321880760" :

DECLARE geos ARRAY<GEOGRAPHY>;

SET geos = (SELECT ARRAY_AGG(ST_SIMPLIFY(county_geom, 100))
            FROM `bigquery-public-data.geo_us_boundaries.counties`
            WHERE county_name IN ("Queens","Kings", "New York") AND state_fips_code = "36");

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_GEO`(
  JSON_OBJECT(
      'geographies', geos,
      'brand_ids', ["1413758728321880760"], -- Filter for Starbucks
      'business_status', ["OPERATIONAL"]
      )
);

Visualiser les résultats

Les images suivantes montrent ces données affichées dans Looker Studio sous la forme d'une carte choroplèthe, y compris le contour de chaque comté :

Pour importer vos données dans Looker Studio :

1. Exécutez la fonction ci-dessus pour générer les résultats.

2. Dans les résultats BigQuery, cliquez sur Ouvrir dans -> Looker Studio. Vos résultats sont automatiquement importés dans Looker Studio.

3. Looker Studio crée une page de rapport par défaut et l'initialise avec un titre, un tableau et un graphique à barres des résultats.

   

4. Sélectionnez tout le contenu de la page et supprimez-le.

5. Cliquez sur Insérer -> Carte géographique pour ajouter une carte géographique à votre rapport.

6. Sous Types de graphiques -> Configuration, configurez les champs comme indiqué ci-dessous :

   

7. La carte choroplèthe s'affiche comme ci-dessus. Vous pouvez éventuellement sélectionner Types de graphiques -> Styles pour configurer l'apparence de la carte.

Pour en savoir plus et voir un exemple de visualisation des résultats de Places Insights, consultez Visualiser les résultats de requête.