L'API Places Aggregate est un service qui fournit des insights sur les lieux dans une zone spécifiée en fonction de critères tels que l'emplacement, le type, l'état de fonctionnement, la tranche de prix et les notes des utilisateurs. Ce service peut vous aider à analyser la densité de types de lieux spécifiques autour d'un lieu donné et à répondre à des questions telles que "Quels sont les restaurants classés $$$ et ayant reçu cinq étoiles qui se trouvent dans un rayon de 5 km autour de ce lieu ?" ou "Combien y en a-t-il ?"
Les résultats sont renvoyés sous forme de nombres agrégés ou d'ID de lieux identifiés dans la zone de recherche d'intérêt. Les utilisateurs peuvent utiliser l'API Place Details pour récupérer plus d'informations sur ces ID de lieu.
Pourquoi utiliser l'API Places Aggregate ?
L'API Places Aggregate permet à vos utilisateurs de prendre des décisions basées sur les données grâce aux informations complètes que vous fournissez sur différents lieux. Il s'appuie sur des modèles de lieux précis et à jour, ce qui permet de prendre en charge les principaux cas d'utilisation suivants :
- Entreprises : analysez la concurrence et les emplacements potentiels pour de nouvelles succursales.
- Développeurs : ils créent des applications qui fournissent des recommandations personnalisées.
- Chercheurs : ils examinent les tendances et les modèles dans des domaines spécifiques.
Fonctionnalités de l'API Places Aggregate
L'API Places Aggregate vous permet d'obtenir les informations suivantes :
- Nombre : récupérez le nombre de lieux correspondant à vos critères.
- ID de lieux : récupérez les ID de lieux spécifiques qui correspondent à vos critères.
Vous pouvez également utiliser le filtrage pour affiner votre recherche en fonction de différents attributs, tels que les types de lieux, les horaires d'ouverture, les gammes de prix et les notes des clients.
Exemples
Cette section décrit des exemples de cas d'utilisation de l'API Places Aggregate et inclut du code fonctionnel pour chaque exemple.
Ouvrir un nouveau café
Le propriétaire d'un restaurant souhaite ouvrir un nouveau café. Pour ce faire, ils souhaitent d'abord visualiser les zones de forte concentration de cafés afin d'identifier les zones de forte et faible concentration pour éclairer leur décision commerciale. L'API Places Aggregate peut aider à analyser le nombre de cafés dans un rayon spécifique en fonction d'attributs tels que l'état de fonctionnement, les niveaux de prix et les notes des clients. Elle permet ainsi de prendre une décision basée sur les données pour choisir où ouvrir le prochain établissement.
Société d'investissement immobilier
Une société d'investissement immobilier souhaite améliorer ses modèles financiers et déterminer précisément le ROI de ses investissements immobiliers prévus. En utilisant l'API Places Aggregate, ils peuvent collecter des données détaillées sur les commodités à proximité des biens immobiliers potentiels, comme les distributeurs automatiques de billets, les hôpitaux, les stations de transport en commun et les épiceries, afin de comprendre les commodités à proximité des biens immobiliers potentiels.
Service de livraison pour les marchands
Lorsqu'un service de livraison de produits de vente au détail s'étend à une nouvelle ville, il doit déterminer le nombre de livreurs à affecter à une région en fonction de la densité des destinations de consommation populaires, telles que les restaurants, les magasins de proximité et les magasins d'alcool. À l'aide de l'API, le service de livraison compte le nombre total de ces établissements dans toute la ville afin de planifier et d'allouer efficacement les ressources.
Fonctionnement de l'API Places Aggregate
L'API Places Aggregate vous permet de spécifier des filtres pour affiner vos critères de recherche.
Après avoir sélectionné un type d'insight INSIGHT_COUNT
ou INSIGHT_PLACES
, vous pouvez ajouter des critères de filtrage, y compris les suivants :
- Zone géographique : définissez la zone d'intérêt à l'aide de cercles, de régions ou de polygones personnalisés.
- Type : spécifiez les types de lieux qui vous intéressent.
- État des opérations : filtrez les lieux en fonction de leur état opérationnel.
- Niveaux de prix : filtrez les lieux en fonction de leur niveau de prix.
- Notes : filtrez les lieux en fonction des notes des utilisateurs.
L'objet ComputeInsightsResponse
de la réponse de l'API contient les résultats de l'insight sur la requête. Par exemple, si vous avez sélectionné INSIGHT_COUNT
, la réponse contient le nombre total de lieux. Si vous avez sélectionné INSIGHT_PLACES
, la réponse contient une liste d'ID de lieux.
Utiliser l'API Places Aggregate
1 | Configurez votre appareil. | Commencez par Configurer votre projet Google Cloud, puis suivez les instructions. |
2 | Envoyez une requête pour obtenir le nombre de lieux correspondants. | Consultez Créer votre première requête. |
3 | En savoir plus sur les paramètres de requête | Consultez Paramètres de requête. |
Étape suivante
- Consulter les tarifs et les limites d'utilisation
- Consulter la documentation de référence sur l'API
- Consulter les questions fréquentes
- Consulter les options d'assistance