Présentation des fonctions de nombre de lieux

Les fonctions de nombre de lieux sont un autre moyen d'interroger les données Places disponibles dans Places Insights. Ces fonctions sont des requêtes SQL prédéfinies qui s'exécutent dans BigQuery et qui sont complémentaires aux requêtes sur les données des lieux. La principale différence 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 à 5, mais n'imposent aucune limite à la taille de la zone de recherche.

  • Les fonctions de dénombrement 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).

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. Par exemple, la possibilité de renvoyer des nombres faibles est importante pour les cas d'utilisation de sélection de sites.

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.

Comme pour les ensembles de données sur les lieux, les fonctions de comptage des lieux sont disponibles pour une ville principale de chacun des pays acceptés. Par exemple, pour l'Australie, vous pouvez accéder aux fonctions de décompte des lieux pour Sydney, en Australie.

Pour obtenir la liste complète des villes et pays acceptés, consultez Fonctions de décompte des lieux de référence dans BigQuery.

Exemple de fonction de nombre de 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 `maps-platform-analytics-hub.sample_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.

Dans cet exemple, l'instruction SELECT fait référence à la fonction PLACES_COUNT pour les États-Unis à l'aide de la syntaxe suivante :

maps-platform-analytics-hub.sample_places_insights_us.PLACES_COUNT

Pour obtenir la liste complète des villes et pays acceptés, consultez Fonctions de décompte des lieux de référence dans BigQuery.

Utilisez un JSON_OBJECT pour transmettre des arguments à la fonction. 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 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 `maps-platform-analytics-hub.sample_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.

Appliquer des filtres à la fonction

Appliquez des filtres pour affiner vos critères de recherche. Les fonctions de dénombrement de lieux sont compatibles avec de nombreux filtres pour affiner votre recherche. 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 `maps-platform-analytics-hub.sample_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;

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 présentent les 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 ou par composant d'adresse n'est pas disponible.

Comparer les fonctions de dénombrement de lieux et les requêtes sur les ensembles de données de lieux

Le tableau suivant présente les principales différences :

Fonctions de comptage des lieux Placer des requêtes d'ensemble de données
Interface Quatre fonctions SQL prédéfinies qui génèrent des insights COUNT : nombre unique, nombre par type, nombre par zone géographique et nombre par cellule H3. Utilise SQL pour exécuter des fonctions d'agrégation telles que COUNT, COUNT_IF, SUM et AVG.. Des insights supplémentaires peuvent être générés à l'aide de JOIN, GROUP BY, WHERE, entre autres.
Restrictions Applique une zone de recherche minimale de 40 mètres sur 40 mètres (1 600 m2). Une fonction renvoie un résultat même si le nombre d'agrégations est inférieur à 5, à condition que la zone de recherche minimale soit respectée. Applique un seuil de nombre de 5, mais aucune zone de recherche minimale.
Filtres d'attributs acceptés Le schéma complet est accepté, à l'exception des éléments suivants :
  • Lieu : id
  • Composants d'adresse
 Schéma complet accepté
Avantages
  • Peut renvoyer n'importe quel nombre.
  • Optimisé pour les performances et les faibles coûts de traitement.
  • Simple à utiliser. Vous n'avez pas besoin de rédiger des requêtes complexes.
  • Valide les paramètres d'entrée et renvoie une erreur, ce qui facilite l'utilisation et le débogage.
  • Permet d'effectuer des requêtes complexes, comme des jointures et des filtrages avancés.
  • Aucune zone de recherche minimale n'est imposée.
  • Prend en charge des fonctions d'agrégation supplémentaires au-delà de COUNT, telles que AVG, SUM et GROUP BY.

Fonctions de décompte des lieux de référence dans BigQuery

Les fonctions de nombre de lieux sont compatibles avec les villes et pays suivants. Vous devez vous abonner à chaque ville et à chaque pays séparément.

Ville, pays Noms de table
Sydney, Australie maps-platform-analytics-hub.sample_places_insights_au.FUNCTION_NAME
São Paulo, Brésil maps-platform-analytics-hub.sample_places_insights_br.FUNCTION_NAME
Toronto, Canada maps-platform-analytics-hub.sample_places_insights_ca.FUNCTION_NAME
Paris, France maps-platform-analytics-hub.sample_places_insights_fr.FUNCTION_NAME
Berlin, Allemagne maps-platform-analytics-hub.sample_places_insights_de.FUNCTION_NAME
Londres, Grande-Bretagne maps-platform-analytics-hub.sample_places_insights_gb.FUNCTION_NAME
Mumbai, Inde maps-platform-analytics-hub.sample_places_insights_in.FUNCTION_NAME
Jakarta, Indonésie maps-platform-analytics-hub.sample_places_insights_id.FUNCTION_NAME
Rome, Italie maps-platform-analytics-hub.sample_places_insights_it.FUNCTION_NAME
Tokyo, Japon maps-platform-analytics-hub.sample_places_insights_jp.FUNCTION_NAME
Mexico, Mexique maps-platform-analytics-hub.sample_places_insights_mx.FUNCTION_NAME
Madrid, Espagne maps-platform-analytics-hub.sample_places_insights_es.FUNCTION_NAME
Zurich, Suisse maps-platform-analytics-hub.sample_places_insights_ch.FUNCTION_NAME
New York, États-Unis maps-platform-analytics-hub.sample_places_insights_us.FUNCTION_NAME