Cette page a été traduite par l'API Cloud Translation.

À propos des données et des requêtes Places Insights

Données Places Insights

Places Insights fournit des ensembles de données complets et d'échantillons dans BigQuery.

Les exemples d'ensembles de données sont destinés à vous permettre d'essayer Places Insights afin d'évaluer la facilité d'utilisation et la valeur du produit avant de décider d'acheter l'ensemble de données complet. L'exemple d'ensemble de données ne contient que des données pour la ville elle-même. Il ne contient pas de données pour l'agglomération environnante.

L'exemple de fiche inclut les données d'une ville principale pour chacun des pays acceptés : Sydney (AU), São Paulo (BR), Toronto (CA), Zurich (CH), Berlin (DE), Madrid (ES), Paris (FR), Londres (UK), Jakarta (ID), Mumbai (IN), Rome (IT), Tokyo (JP), Mexico (MX) et New York (US).

Les ensembles de données complets incluent des données pour chaque pays accepté et doivent être achetés. Si vous souhaitez acheter l'ensemble de données complet, remplissez le formulaire de demande. Seul l'abonné aux données doit demander l'accès à l'ensemble de données Places Insights. Une fois l'abonnement actif dans un projet BigQuery, tout utilisateur ayant accès à ce projet peut interroger les données Places Insights.

Chaque ensemble de données par pays possède sa propre fiche à laquelle vous devez vous abonner séparément. Pour savoir comment vous abonner à une fiche, consultez Configurer Places Insights.

Schémas d'ensembles de données

Le schéma de l'ensemble de données sur les lieux pour chaque pays se compose de deux parties :

Le schéma principal commun aux ensembles de données de tous les pays.
Un schéma spécifique à un pays qui définit les composants du schéma propres à ce pays.

Par exemple, si vous travaillez avec l'ensemble de données pour l'Espagne (ES), faites référence à la fois au schéma principal et au schéma spécifique à l'Espagne.

Le schéma de l'ensemble de données sur les marques définit trois champs :

id : ID de la marque.
name : nom de la marque, par exemple "Hertz" ou "Chase".
category : catégorie générale de la marque, telle que "Station-service", "Aliments et boissons" ou "Hébergement".

Interroger les données Places Insights

Places Insights propose deux façons d'interroger les ensembles de données :

Interrogez l'ensemble de données directement à l'aide de SQL : exécutez des requêtes SQL BigQuery standards sur les tables de l'ensemble de données. Cela offre la plus grande flexibilité pour le filtrage complexe, la jointure avec vos propres données, l'analyse personnalisée et la prise en charge de fonctions d'agrégation supplémentaires au-delà de COUNT, telles que AVG, SUM et GROUP BY. Consultez la documentation.
Interrogez l'ensemble de données à l'aide des fonctions de dénombrement des lieux : les fonctions de dénombrement des lieux sont des requêtes SQL prédéfinies et optimisées qui s'exécutent directement dans BigQuery et simplifient les tâches courantes de récupération de données. Ils fournissent des insights plus précis, comme le renvoi d'ID de lieu pour rechercher des informations sur des lieux spécifiques. Consulter la documentation

Requêtes directes

L'interrogation directe des données applique un seuil d'agrégation. Un résultat n'est renvoyé que si la requête agrège au moins cinq lieux. Par exemple, si le résultat de vos critères de recherche est un nombre de 0, 1, 2, 3 ou 4, il est omis de la réponse. Par exemple, une requête concernant le nombre total de restaurants dans une zone donnée ne renverra une réponse que si ce nombre est supérieur ou égal à 5. Dans le cas contraire, aucune réponse ne sera renvoyée.

Placer des requêtes de fonction de comptage

Les fonctions de dénombrement de lieux peuvent renvoyer une liste d'ID de lieux, qui peuvent être utilisés pour rechercher des informations sur des lieux individuels à l'aide d'autres produits GMP tels que l'API Places et le kit d'UI Places.

Les fonctions de dénombrement des lieux n'appliquent pas de seuil d'agrégation, mais plutôt une zone de recherche minimale de 40 mètres sur 40 mètres (1 600 m²). Cela signifie que tant que votre requête de recherche est plus grande que la zone de recherche minimale, vous obtiendrez toujours un résultat, même si aucun lieu ne correspond à votre requête.

Quand interroger directement les données et quand utiliser des fonctions

Interrogez directement les données si vous n'avez pas besoin d'un faible nombre de résultats, si vous souhaitez obtenir des insights au-delà des nombres (comme AVG, SUM ou COUNTIF), ou si vous devez effectuer des requêtes plus complexes (comme joindre des ensembles de données).

Utilisez les fonctions pour savoir si le nombre de résultats est faible ou nul, ou si vous devez récupérer des informations sur un lieu spécifique, comme son nom ou son adresse.

Ce tableau compare en détail les différences entre les requêtes directes et les fonctions de nombre de lieux.

	Fonctions de comptage des lieux	Requêtes directes sur les ensembles de données
Avantages	Renvoie les ID de lieux pouvant être utilisés pour interroger d'autres API. 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 filtrages avancés et des jointures. 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`.
Interface	Quatre fonctions SQL prédéfinies qui génèrent des insights `COUNT` : nombre unique, nombre par type, nombre par zone géographique, nombre par cellule H3. Un `JSON_OBJECT` transmet des arguments à la fonction.	Écrivez votre propre code SQL pour exécuter des fonctions d'agrégation telles que `COUNT`, `COUNT_IF`, `SUM` et `AVG.`. Vous pouvez générer des insights supplémentaires à l'aide de `JOIN`, `GROUP BY`, `WHERE` et d'autres.
Restrictions	Applique une zone de recherche minimale de 40 mètres sur 40 mètres (1 600 m²). 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.	Les résultats dont le nombre est inférieur à 5 sont omis (c'est-à-dire que la ligne est exclue).
Filtres d'attributs acceptés	Les paramètres de filtre de la fonction de nombre de lieux sont les mêmes que les filtres d'attributs de requête directe, à l'exception des suivants : Lieu `id` Composants d'adresse Horaires d'ouverture Options de recharge de VE Marques	Le schéma complet est accepté.