Données Places Insights
Places Insights provides ensembles de données complets et des exemples dans BigQuery.
Les exemples d'ensembles de données vous permettent d'essayer Places Insights afin d'évaluer l'utilisabilité 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 les données de la ville elle-même. Il ne contient pas de données pour l'agglomération environnante.
L'exemple de fiche inclut des données pour une ville principale de chacun des pays compatibles :
| 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 (AU) |
| Buenos Aires (AR) | Madrid (ES) | Taipei (TW) |
| Busan (KR) | Manille (PH) | Tel Aviv-Jaffa (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 (US) | 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 compatible 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 activé 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 comporte deux parties :
- Le schéma de base qui est commun aux ensembles de données de tous les pays.
- Un schéma spécifique à un pays qui définit les composants de schéma propres à ce pays.
Par exemple, si vous utilisez l'ensemble de données pour l'Espagne (ES), référencez à la fois le schéma de base et le 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 de haut niveau de la marque, par exemple "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 :
- 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. Cette méthode 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 informations sur des lieux individuels. 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 agrège au moins cinq lieux. Par exemple, si vos critères de recherche renvoient 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 de cinq ou plus. Sinon, aucune réponse n'est renvoyée.
Requêtes de fonction Places Count
Les fonctions Places Count peuvent renvoyer une liste d'ID de lieu, 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'interface utilisateur Places.
Les fonctions Places Count n'appliquent pas de seuil d'agrégation, mais plutôt une zone de recherche minimale de 40,0 mètres sur 40,0 mètres (1 600 m2). Cela signifie que tant que votre requête de recherche est supérieure à la zone de recherche minimale, vous obtiendrez toujours un résultat, y compris s'il n'y a aucun lieu correspondant à votre requête.
Quand interroger les données directement et quand utiliser des fonctions
Interrogez les données directement si vous n'avez pas besoin de faibles nombres 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 joindre des ensembles de données.
Interrogez à l'aide des fonctions si vous avez besoin de savoir s'il y a un faible nombre de résultats ou aucun résultat, ou si vous devez récupérer des informations sur des lieux individuels, telles que le nom ou l'adresse du lieu.
Ce tableau compare en détail les différences entre les requêtes directes et les fonctions Places Count.
| Fonctions Places Count | Requêtes directes sur l'ensemble de données | |
|---|---|---|
| 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,0 mètres sur 40,0 mètres (1 600 m2). Une fonction renvoie un résultat même si le nombre d'agrégation est inférieur à cinq, à condition que la zone de recherche minimale soit respectée. | Les résultats dont le nombre est inférieur à cinq 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 que la requête directe, à l'exception des suivants :
|
Schéma complet compatible. |