Qu’est-ce que l’API Google Places
L’API Places est un service qui retourne des informations sur les lieux en utilisant des requêtes HTTP. Les lieux sont généralement définis dans cette API comme des établissements, des emplacements géographiques ou des points d’intérêt remarquables.
Il existe cinq types de requêtes disponibles dans l’API. Ils sont :
- Recherche de lieu qui retourne une liste de lieux en fonction de la localisation de l’utilisateur ou de la chaîne de recherche.
- Détails du lieu qui donne des informations détaillées sur un lieu spécifique, avec des avis d’utilisateurs inclus.
- Photos de lieu donne accès aux millions de photos liées au lieu conservées dans la base de données de lieux de Google.
- Avis de lieu permet d’atteindre et d’intégrer les avis Google depuis la plateforme.
- Autocomplétion de lieu permet de remplir automatiquement le nom ou l’adresse d’un lieu lorsque les utilisateurs tapent.
- Autocomplétion de requête fournit un service de prédiction de requête pour les recherches géographiques basées sur du texte, en retournant des requêtes suggérées au fur et à mesure que les utilisateurs tapent.
Pour travailler avec l’API Places, vous avez besoin d’une clé qui doit être incluse dans chaque demande d’API Places. Découvrons ce que c’est exactement et comment obtenir la clé API pour l’API Google Places.
Comment créer une clé API Google Places
La clé API est un identifiant unique qui sert à authentifier les demandes associées à votre projet à des fins d’utilisation et de facturation. En utilisant une clé API pour authentifier les demandes, vous pouvez :
- Gérer vos API dans Google Cloud Console.
- Accéder aux données d’utilisation en temps réel et à 30 jours de données d’utilisation historiques dans la Console de la plate-forme Google Cloud.
- Observer les rapports d’utilisation avec plus de 30 jours d’informations dans le portail de support Google Cloud.
Vous pouvez trouver plus d’informations sur les rapports disponibles pour les clients du Plan Premium ici. Maintenant, vous pouvez procéder à l’obtention de la clé.
Vous êtes toujours libre d’essayer une autre façon d’ajouter des avis clients à votre site Web. Par exemple, il existe un widget Google Avis par Elfsight – vous n’avez pas besoin de vous soucier d’obtenir des clés API ou d’apprendre à coder.
Obtenez votre clé API Places et ajoutez-la à votre demande
Pour obtenir votre clé API, vous devez effectuer les actions suivantes :
- Ouvrez la Console Google Cloud Platform.
- Cliquez sur la liste déroulante du projet et sélectionnez le projet qui vous a été attribué. Son nom doit commencer par Google Maps APIs for Business ou Google Maps for Work ou Google Maps.
- Ensuite, cliquez sur le bouton de menu et choisissez APIs & Services > Credentials.
- Sur la page Credentials, sélectionnez Create credentials > API key. Vous verrez alors une boîte de dialogue de création de clé API démontrant votre nouvelle clé créée.
- Fermez l’onglet. Votre nouvelle clé API est répertoriée sur la page des credentials dans la section des clés API.
Ensuite, vous devez ajouter la clé API à chaque demande d’API Places. En utilisant l’exemple suivant, remplacez simplement YOUR_API_KEY par votre clé API :
https://maps.googleapis.com/maps/api/place/nearbysearch/json ?location=-33.8670522,151.1957362 &radius=500 &types=food &name=harbour &key=YOUR_API_KEY
N’oubliez pas que Google recommande fortement de restreindre votre clé API. Les restrictions garantissent une sécurité supplémentaire et aident à s’assurer que seules les demandes autorisées sont effectuées avec votre clé API.
Comment restreindre votre clé API Google Places
Il existe deux restrictions et vous devez configurer les deux. Ils sont :
- Restriction d’application. Cette fonctionnalité vous permet de limiter l’utilisation de la clé API à des sites Web, des serveurs Web ou des applications mobiles. Il n’y a qu’une seule restriction de cette catégorie qui peut être choisie.
- Restriction d’API. Ce type de restriction limite l’utilisation de la clé API à une ou plusieurs API ou SDK.
Pour restreindre votre clé API, vous devez :
- Ouvrez la console Google Cloud.
- Cliquez sur la liste déroulante du projet et sélectionnez le projet contenant la clé API que vous souhaitez sécuriser.
- Cliquez sur le bouton de menu et choisissez APIs & Services > Credentials.
- Cliquez sur le nom de la clé API que vous devez sécuriser sur la page Credentials.
- Définissez les restrictions sur la page Restreindre et renommer la clé API.
Après avoir défini les restrictions, il ne vous reste plus qu’à cliquer sur le bouton Enregistrer.
Utilisation de l’API Google Places : exemples
Il existe plusieurs façons d’utiliser l’API Google Places. Voyons-en quelques-unes.
Recherche de lieu
Comme mentionné précédemment, l’API Places vous permet de rechercher des informations sur les lieux en utilisant un grand nombre de catégories. L’exemple suivant de l’API Google Places démontre une demande de recherche de lieu pour le « Museum of Contemporary Art Australia » :
https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=photos,formatted_address,name,rating,opening_hours,geometry&key=YOUR_API_KEY
Détails du lieu
Une fois que vous avez un place_id à partir d’une recherche Google Places, vous êtes libre d’obtenir plus d’informations sur un établissement ou un point d’intérêt particulier en initiant une demande de Détails du lieu. Voici une demande de détails d’un lieu par place_id :
https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJN1t_tDeuEmsRUsoyG83frY4&fields=name,rating,formatted_phone_number&key=YOUR_API_KEY
Photos de lieu
Ce service vous permet d’ajouter du contenu photo à vos applications. Il donne accès à des millions de photos stockées dans la base de données de lieux. Voici un exemple de demande :
https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photoreference=CnRtAAAATLZNl354RwP_9UKbQ_5Psy40texXePv4oAlgP4qNEkdIrkyse7rPXYGd9D_Uj1rVsQdWT4oRz4QrYAJNpFX7rzqqMlZw2h2E2y5IKMUZ7ouD_SlcHxYq1yL4KbKUv3qtWgTK0A6QbGh87GB3sscrHRIQiG2RrmU_jF4tENr9wGS_YxoUSSDrYjWmrNfeEHSGSc3FyhNLlBU&key=YOUR_API_KEY
Autocomplétion de lieu
C’est un service Web qui retourne des prédictions de lieu en réponse à une demande HTTP. Il peut être utilisé pour fournir une fonctionnalité d’autocomplétion pour les recherches géographiques basées sur du texte. Voici un exemple de demande pour les établissements :
https://maps.googleapis.com/maps/api/place/autocomplete/xml?input=Amoeba&types=establishment&location=37.76999,-122.44696&radius=500&key=YOUR_API_KEY
Autocomplétion de requête
Ce type de service est utilisé pour fournir une prédiction de requête pour les recherches géographiques basées sur du texte, en retournant des requêtes suggérées au fur et à mesure que l’utilisateur tape. Une demande d’exemple ressemble à ceci :
https://maps.googleapis.com/maps/api/place/queryautocomplete/json?key=YOUR_API_KEY&input=pizza+near%20par
Tarification et limites de l’API Google Places
Ici, Google utilise un modèle de tarification au fur et à mesure. Cela signifie que les API de la plateforme Google Maps sont facturées par SKU. L’utilisation est suivie pour chaque SKU de produit, et une API peut avoir plus d’un SKU de produit.
Il y a 1 000 recherches gratuites d’API Places par 24 heures, mais vous pouvez les augmenter à 150 000 recherches gratuites par 24 heures en activant la facturation dans la console Google Cloud.
| Plage de volume mensuelle (Prix par APPEL) | 0–100 000 | 100 001–500 000 | 500 000+ | |
| Autocomplétion | 0,00283 USD par chacun (2,83 USD par 1000) | 0,00227 USD par chacun (2,27 USD par 1000) | Contactez les ventes pour des prix en volume | |
| Autocomplétion de requête | 0,00283 USD par chacun(2,83 USD par 1000) | 0,00227 USD par chacun (2,27 USD par 1000) | Contactez les ventes pour des prix en volume | |
| Détails des lieux | 0,017 USD par chacun(17,00 USD par 1000) | 0,0136 USD par chacun (13,60 USD par 1000) | Contactez les ventes pour des prix en volume | |
| Photos des lieux | 0,007 USD par chacun (7,00 USD par 1000) | 0,0056 USD par chacun (5,60 USD par 1000) | Contactez les ventes pour des prix en volume | |
| Recherche | 0,032 USD par chacun (32,00 USD par 1000) | 0,0256 USD par chacun (25,60 USD par 1000) | Contactez les ventes pour des prix en volume |
Vous pouvez vérifier l’API Google Place documentation pour trouver plus de détails sur tous les prix et limites.
FAQ
Le service Google Places API est-il gratuit ?
L’API Places utilise un modèle de tarification au fur et à mesure. Pour obtenir plus de détails sur les prix, consultez le tableau ci-dessus ou consultez la documentation.
Comment puis-je utiliser l'API Google Places ?
Pour le rendre possible, vous devez obtenir une clé API. Vous pouvez le faire via votre Cloud Console en cliquant sur la liste déroulante du projet et en sélectionnant le projet qui vous a été attribué.
Comment puis-je ajouter ou modifier des lieux ?
Si vous êtes propriétaire d’un établissement, vous pouvez ajouter ou modifier les informations de votre entreprise en revendiquant votre établissement sur Google.
Comment puis-je me conformer à la politique de confidentialité de Google pour l'utilisation de l'API Google Places ?
Vous devez respecter les politiques et directives de Google, en veillant à obtenir le consentement approprié de vos utilisateurs avant de collecter, de stocker ou de partager des données avec Google.
Conclusion
L’API Google Places est un outil puissant pour obtenir des informations sur les lieux. Que vous ayez besoin de rechercher des lieux, d’obtenir des détails sur un lieu spécifique, des photos ou des avis, ou même d’ajouter une fonctionnalité d’autocomplétion à votre application, l’API Places a tout pour plaire. En utilisant judicieusement les exemples et les informations fournies dans ce guide, vous serez en mesure d’intégrer facilement cette fonctionnalité dans votre propre application ou service.
