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 n'inclut pas les données de la zone métropolitaine environnante.
L'exemple de fiche inclut des données pour une ville principale de chaque pays accepté :
| Amsterdam (NL) | Helsinki (FI) | Plovdiv (BG) |
| Ankara (TR) | Hong Kong (HK) | Riffa (BH) |
| Arequipa (PE) | Jakarta (ID) | Rome (IT) |
| Athènes (GR) | Djeddah (SA) | Santiago (CL) |
| Bad Gastein (AT) | Johannesburg (ZA) | São Paulo (BR) |
| Berlin (DE) | Kuala Lumpur (MY) | Charjah (AE) |
| Brno (CZ) | Lisbonne (PT) | Singapour (SG) |
| Bruxelles (BE) | Londres (GB) | Stockholm (SE) |
| Bucarest (RO) | Lusail (QA) | Sydney (Australie) |
| Buenos Aires (AR) | Madrid (ES) | Taipei (TW) |
| Busan (KR) | Manille (PH) | Tel Aviv-Yafo (IL) |
| Le Caire (EG) | Medellín (CO) | Tokyo (JP) |
| Chiang Mai (TH) | Mexico (MX) | Toronto (CA) |
| Copenhague (DK) | Mumbai (IN) | Varsovie (PL) |
| Cork (IE) | New York (États-Unis) | Wellington (NZ) |
| Debrecen (HU) | Oslo (NO) | Zurich (CH) |
| Hanoï (VN) | Paris (FR) |
Les ensembles de données complets incluent des données pour chaque pays accepté et doivent être achetés. Si vous souhaitez vous inscrire à Places Insights, 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 en savoir plus sur l'abonnement à une fiche, consultez Configurer Places Insights.
Schémas d'ensemble 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 de base, qui est commun aux ensembles de données de tous les pays.
- Un schéma spécifique au pays qui définit les composants de schéma spécifiques à ce pays.
Par exemple, si vous travaillez avec l'ensemble de données pour l'Espagne (ES), référencez à la fois le schéma principal et le schéma spécifique à l'Espagne.
Le schéma de l'ensemble de données "brands" définit trois champs :
id: ID de la marque.name: nom de la marque, par exemple "Hertz" ou "Chase".category: catégorie de haut niveau de la marque, par exemple "Station-service", "Alimentation et boissons" ou "Hébergement".
Interroger les données Places Insights
Places Insights propose deux façons d'interroger les ensembles de données :
- Interroger 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 une flexibilité maximale 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 queAVG,SUMetGROUP BY. Consultez la documentation. - Interroger l'ensemble de données à l'aide des fonctions Places Count : les fonctions Places Count 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. Elles fournissent des insights plus précis, par exemple en renvoyant des ID de lieu pour rechercher des détails sur des lieux spécifiques. Consultez 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 regroupe 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, le résultat est omis de la réponse. Par exemple, une requête portant sur le nombre total de restaurants dans une zone donnée ne renverra une réponse que si le nombre total est supérieur ou égal à 5. Sinon, aucune réponse ne sera renvoyée.
Requêtes de la fonction Places Count
Les fonctions Places Count peuvent renvoyer une liste d'ID de lieu, qui peut être utilisée pour rechercher des informations sur des lieux individuels à l'aide d'autres produits GMP, comme l'API Places et le Kit UI pour Places.
Les fonctions Places Count n'appliquent pas de seuil d'agrégation, mais une zone de recherche minimale de 40 mètres sur 40 mètres (1 600 m2). 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 les données directement 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, tels que AVG, SUM ou COUNTIF, ou si vous devez effectuer des requêtes plus complexes, comme la jointure d'ensembles de données.
Interrogez à l'aide des fonctions si vous avez besoin de savoir s'il y a peu ou pas de résultats, ou si vous devez récupérer des informations sur un lieu individuel, comme son nom ou son adresse.
Ce tableau compare en détail les différences entre les requêtes directes et les fonctions Places Count.
| Fonctions Places Count | Requêtes d'ensemble de données directes | |
|---|---|---|
| Avantages |
|
|
| 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 fonctions. |
| 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 à cinq, à condition que la zone de recherche minimale soit respectée. | Les résultats dont le nombre est inférieur à 5 sont omis des résultats (c'est-à-dire que la ligne est exclue). |
| Filtres d'attributs compatibles | Les paramètres de filtre de la fonction Places Count sont compatibles avec les mêmes filtres d'attributs de requête directe, à l'exception des suivants :
|
Schéma complet accepté. |