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 chacun des pays acceptés :
- Amsterdam (NL)
- Ankara (TR)
- Arequipa (PE)
- Athènes (GR)
- Bad Gastein (AT)
- Berlin (DE)
- Brno (CZ)
- Bruxelles (BE)
- Bucarest (RO)
- Buenos Aires (AR)
- Busan (KR)
- Le Caire (EG)
- Chiang Mai (TH)
- Copenhague (DK)
- Cork (IE)
- Debrecen (HU)
- Hanoï (VN)
- Helsinki (FI)
- Hong Kong (HK)
- Jakarta (ID)
- Djeddah (SA)
- Johannesburg (ZA)
- Kuala Lumpur (MY)
- Lisbonne (PT)
- Londres (GB)
- Lusail (QA)
- Madrid (ES)
- Manille (PH)
- Medellín (CO)
- Mexico (MX)
- Mumbai (IN)
- New York (États-Unis)
- Oslo (NO)
- Paris (FR)
- Plovdiv (BG)
- Riffa (BH)
- Rome (IT)
- Santiago (CL)
- São Paulo (BR)
- Charjah (AE)
- Singapour (SG)
- Stockholm (SE)
- Sydney (Australie)
- Taipei (TW)
- Tel Aviv-Yafo (IL)
- Tokyo (JP)
- Toronto (CA)
- Varsovie (PL)
- Wellington (NZ)
- Zurich (CH)
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, telle que "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 de 1. Une ligne de résultat n'est renvoyée que si elle regroupe au moins un lieu. Si vos critères de recherche ne correspondent à aucun lieu, cette ligne est omise de la réponse.
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 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.
Utilisez les fonctions si vous devez renvoyer des ID de lieu pour rechercher des informations sur un lieu spécifique, comme son nom ou son adresse, ou si vous souhaitez que vos requêtes renvoient explicitement un nombre de 0 au lieu de les omettre.
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, y compris un nombre de 0, tant que la zone de recherche minimale est respectée. | Les résultats dont le nombre est égal à 0 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 compatible. |