Interroger l'ensemble de données à l'aide de fonctions de dénombrement des lieux

Les fonctions de dénombrement des lieux sont des requêtes SQL prédéfinies qui s'exécutent dans BigQuery et qui sont complémentaires à l'interrogation directe de l'ensemble de données. La principale différence entre l'interrogation directe des données et l'utilisation d'une fonction est que les fonctions n'appliquent pas de seuil de nombre minimal, mais plutôt une zone de recherche minimale :

  • Les requêtes sur les ensembles de données de lieux ne peuvent renvoyer que des nombres supérieurs ou égaux à 5, mais n'imposent aucune limite à la taille de la zone de recherche.
  • Les fonctions de comptage de lieux peuvent renvoyer n'importe quel nombre, y compris 0, mais imposent une zone de recherche minimale de 40 mètres sur 40 mètres (1 600 m2). Les fonctions peuvent également renvoyer des ID de lieux, qui peuvent être utilisés pour rechercher des informations sur des lieux spécifiques.

Vous pouvez utiliser les fonctions de nombre de lieux si vous avez besoin de savoir quand une requête ne renvoie aucun résultat ou si vous avez besoin de connaître les nombres de lieux inférieurs à 5. Il est également utile si vous avez besoin d'obtenir des informations sur un lieu spécifique pour vérifier vos résultats.

Les fonctions de nombre de lieux ne fournissent que des nombres. Si vous devez effectuer des requêtes plus complexes, comme des jointures de données, ou obtenir des insights supplémentaires, comme la note moyenne d'un groupe de lieux, interrogez directement l'ensemble de données.

Fonctions de comptage de lieux et pays acceptés

Places Insights est compatible avec les fonctions suivantes :

En plus du nombre de lieux, les fonctions PLACES_COUNT_PER_TYPE, PLACES_COUNT_PER_GEO et PLACES_COUNT_PER_H3 renvoient également jusqu'à 250 ID de lieux par élément de la réponse. Afficher tous les paramètres de filtre

Les ID de lieux peuvent être utilisés avec :

Écrire des requêtes avec des fonctions

Utilisez le format suivant pour appeler les fonctions : [project name (optional)].[table name].[function name].

Si vous avez modifié le nom de l'ensemble de données associé lors de la configuration de Places Insights, utilisez votre nom personnalisé au lieu des noms de tables par défaut listés ici. Vous pouvez également inclure le nom de votre projet (facultatif). Si aucun n'est inclus, la requête sera définie par défaut sur le projet actif.

Exemple :

PROJECT_NAME.places_insights___us.PLACES_COUNT

Utilisez JSON_OBJECT pour transmettre des arguments à la fonction.

Filtrer vos résultats

Les fonctions de dénombrement de lieux sont compatibles avec de nombreux filtres pour affiner votre recherche. Ces paramètres (par exemple, price_level ou types) sont sensibles à la casse et doivent correspondre exactement aux noms des paramètres. Consultez la documentation de référence sur les paramètres de filtre pour obtenir la liste complète des options.

Dans l'exemple suivant, vous appliquez des filtres pour limiter la recherche par note minimale des utilisateurs, niveau de prix, état de l'établissement et si le restaurant autorise les chiens :

SELECT `PROJECT_NAME.places_insights___us.PLACES_COUNT`(
  JSON_OBJECT(
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'types', ["restaurant"],
      'min_rating', 1.3,
      'price_level', ['PRICE_LEVEL_INEXPENSIVE', 'PRICE_LEVEL_MODERATE'],
      'allows_dogs', TRUE
      )
) as count;

Exemple de fonction de décompte des lieux

L'exemple suivant utilise la fonction PLACES_COUNT pour renvoyer le nombre de restaurants opérationnels situés à moins de 1 000 mètres de l'Empire State Building à New York :

SELECT `PROJECT_NAME.places_insights___us.PLACES_COUNT`(
  JSON_OBJECT(
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'types', ["restaurant"]
      )
) as count;

La réponse contient un seul décompte :

Résultats de la fonction "Nombre de lieux" à New York.

Cet exemple utilise la fonction BigQuery ST_GEOGPOINT pour renvoyer une valeur GEOGRAPHY à partir d'un point, puis transmet cette valeur au paramètre geography. Il transmet également le rayon de recherche autour du point et le type de lieu, "restaurant", à rechercher.

Exemple de nombre de lieux par type, zone géographique ou H3

En plus du nombre de lieux, les fonctions PLACES_COUNT_PER_TYPE, PLACES_COUNT_PER_GEO et PLACES_COUNT_PER_H3 renvoient également jusqu'à 250 ID de lieux pour les lieux inclus dans la réponse.

Par exemple, la fonction PLACES_COUNT_PER_TYPE renvoie un tableau du nombre de lieux par type de lieu. La réponse inclut un tableau d'ID de lieux pour les lieux correspondant à chaque type. Vous pouvez utiliser les ID de lieu renvoyés pour rechercher des informations sur chaque lieu.

L'appel de fonction suivant renvoie le nombre de lieux avec les types restaurant, cafe et bar :

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_TYPE`(
  JSON_OBJECT(
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'types', ["restaurant", "cafe", "bar"],
      'business_status', ['OPERATIONAL']
      )
);

Cette fonction renvoie un tableau comportant trois colonnes : type, count et sample_place_ids. La colonne count indique le nombre de lieux pour chaque type, et la colonne sample_place_ids affiche jusqu'à 250 ID de lieux pour chaque type.

.

Résultats de la fonction "Type de nombre de lieux" à New York.

Visualiser les résultats

Les outils d'analyse et d'informatique décisionnelle sont essentiels pour vous aider à découvrir des insights à partir de vos données BigQuery. BigQuery est compatible avec plusieurs outils de visualisation des données Google et tiers que vous pouvez utiliser pour analyser les résultats de vos fonctions sur les données Places Insights.

Pour obtenir un exemple de visualisation des résultats d'une fonction, consultez Visualiser les résultats. Pour en savoir plus et obtenir un exemple de visualisation des résultats Places Insights, consultez Visualiser les résultats des requêtes.

Limites et exigences

Les fonctions de nombre de lieux sont soumises aux limites et exigences suivantes :

  • Seuls les insights COUNT sont acceptés.
  • Une zone de recherche minimale de 40 mètres sur 40 mètres (1 600 m2) est requise.
  • La taille d'entrée du paramètre de nombre de fonctions de lieu est limitée à 1 Mo.
  • Le filtrage par ID de lieu, marques, options de recharge de véhicules électriques ou composant d'adresse n'est pas disponible.
  • Vous ne pouvez accéder aux fonctions de décompte des lieux que pour les villes et les pays auxquels vous êtes abonné. Pour accéder aux ensembles de données, consultez Configurer Places Insights.
  • Les paramètres de filtre (par exemple, geography ou types) sont sensibles à la casse et doivent correspondre exactement aux noms des paramètres, sous peine de voir la requête échouer.