> ## Documentation Index > Fetch the complete documentation index at: https://docs.querying.ai/llms.txt > Use this file to discover all available pages before exploring further. # API des résultats Google Places (GOOGLE_PLACES) > Obtenez jusqu'à 100 lieux de la liste de lieux de Google pour une recherche locale, recherchés depuis la ville de votre choix. `GOOGLE_PLACES` renvoie les lieux que Google affiche dans son onglet Lieux pour une recherche, la liste qui s'ouvre depuis « Plus de lieux » sous un pack local. Il lit jusqu'à cinq pages de 20 lieux et recherche chaque page depuis la même ville : vous obtenez jusqu'à 100 lieux dans l'ordre où Google les classe à cet endroit. Utilisez-le pour suivre le classement d'une entreprise sur toute la liste locale d'une ville, ou pour rassembler les entreprises que Google affiche pour un service dans une ville. | | | | - | - | | `taskType` | `GOOGLE_PLACES` | | Entrée | `query` (obligatoire) ; `city` ou `uule`, `limit`, `country` | | Crédits | 1 par page de Lieux lue. Une page contient 20 lieux. | | Pays | `US` par défaut. Tout code ISO 3166-1 alpha-2. | | Position | Fixée par `city` ou `uule`. Voir [Régions et position](https://docs.querying.ai/fr/engines/capacity.md). | ## Requête Cette requête demande les 100 premiers lieux que Google affiche pour les soins de longue durée à Manville, Rhode Island : ```bash theme={"theme":"css-variables"} curl -X POST https://api.querying.ai/v1/async/task \ -H "Authorization: Bearer $QUERYING_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "taskType": "GOOGLE_PLACES", "payload": { "query": "long term care near me", "city": "Manville, Rhode Island, United States", "limit": 100 } }' ``` Si votre système stocke déjà le `uule` de Google pour chaque lieu, envoyez-le à la place de `city`. Cette valeur correspond à Reno, Nevada : ```bash theme={"theme":"css-variables"} curl -X POST https://api.querying.ai/v1/async/task \ -H "Authorization: Bearer $QUERYING_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "taskType": "GOOGLE_PLACES", "payload": { "query": "Reno attorney", "uule": "w+CAIQICIbUmVubywgTmV2YWRhLCBVbml0ZWQgU3RhdGVz", "limit": 100 } }' ``` La tâche s'exécute de façon asynchrone. Lisez le résultat comme décrit dans [Tâches asynchrones](https://docs.querying.ai/fr/concepts/async-tasks.md). Une tâche avec `limit: 100` se termine généralement en une à deux minutes. ## Paramètres | Champ | Obligatoire | Description | | - | - | - | | `query` | Oui | La recherche, de 1 à 100 000 caractères. `prompt` est accepté si `query` est absent. | | `city` | Non | Le lieu depuis lequel rechercher, nommé comme Google nomme les lieux : ville, État ou région, et pays, par exemple `"Reno, Nevada, United States"`. 100 caractères au plus. Le résultat le renvoie dans `city`. | | `uule` | Non | Le paramètre de localisation de Google, sous sa forme `w+`, tel que les outils de suivi de positionnement le stockent, transmis à Google tel quel. Envoyez `city` ou `uule`. Le résultat le renvoie dans `uule`. | | `limit` | Non | Le nombre de lieux à renvoyer, un entier de 1 à 100. `20` par défaut, soit une page. Envoyez `100` pour la liste complète. | | `country` | Non | Le marché Google à interroger. `US` par défaut. | Sans `city` ni `uule`, Google choisit le lieu depuis lequel il recherche. ## Réponse Par exemple, la requête de Manville ci-dessus : ```json theme={"theme":"css-variables"} { "places": [ { "position": 1, "page": 1, "name": "...", "placeId": "...", "location": { "address": "...", "...": "..." }, "mapsUrl": "https://maps.google.com/?cid=...", "reviews": [{ "...": "..." }], "category": "..." }, { "position": 21, "page": 2, "...": "..." } ], "pages": 5, "city": "Manville, Rhode Island, United States" } ``` | Champ | Description | | - | - | | `places` | Toujours présent, dans l'ordre de Google. Chaque lieu porte les champs d'un lieu du pack local dans `map` de [Google Search](https://docs.querying.ai/fr/engines/google-serp.md) : `name`, `placeId`, `location` (`address`, `latitude`, `longitude`), `phoneNumber`, `url`, `mapsUrl`, `reviews`, `category`, `price`, `snippet` et `image`, tels que Google les affiche. | | `places[].position` | Le rang du lieu dans toute la liste, à partir de 1. Il se poursuit d'une page à l'autre. | | `places[].page` | La page de Lieux d'où provient le lieu, de 1 à 5. | | `pages` | Le nombre de pages de Lieux lues. La tâche est facturée pour ces pages. | | `googleLocation` | Le lieu depuis lequel Google indique avoir recherché. Présent seulement quand sa page l’affiche. | | `city` | Le `city` envoyé, si vous en avez envoyé un. | | `uule` | Le `uule` envoyé, si vous en avez envoyé un. | Un lieu qu'une page suivante affiche de nouveau n'est compté qu'une fois. Quand la liste de Google s'arrête avant `limit`, `places` contient tous les lieux affichés par Google ; une petite ville en compte souvent moins de 100. Les champs que Google n'affiche pas pour un lieu sont omis. Traitez tous les champs sauf `name`, `position` et `page` comme facultatifs. ## Crédits Chaque page de Lieux lue coûte 1 crédit. À la soumission, la tâche bloque les crédits des pages nécessaires à `limit`, une page par tranche de 20 lieux : 1 par défaut, 5 avec `limit: 100`. À la fin, elle est facturée pour les pages lues : une liste que Google arrête après trois pages coûte 3. Une tâche échouée coûte 0. Voir [Crédits et limites](https://docs.querying.ai/fr/concepts/credits-and-limits.md). ## Limites et erreurs * Un `places` vide dans une tâche terminée signifie que Google n'a affiché aucun lieu pour la recherche depuis cette position. C'est confirmé sur un second navigateur avant d'être renvoyé, et cela coûte 1 crédit. * Un `limit` hors de 1-100, un `city` vide ou de plus de 100 caractères, ou un `city` envoyé avec `uule` ou `location` renvoie `422 VALIDATION_ERROR`. * Un `uule` qui n'est pas un UULE `w+` renvoie `400 VALIDATION_ERROR`. * `location` renvoie `422`. Fixez le lieu avec `city` ou `uule`. * `include.rawResponse` est sans effet, et `include.html` et `include.analysis` renvoient `422`. Voir [Markdown et réponses brutes](https://docs.querying.ai/fr/engines/response-options.md). * Les autres erreurs de requête sont listées dans [Erreurs](https://docs.querying.ai/fr/concepts/errors.md). ## Voir aussi * [Google Search](https://docs.querying.ai/fr/engines/google-serp.md) pour une page de résultats avec son pack local * [Régions et position](https://docs.querying.ai/fr/engines/capacity.md) * [Crédits et limites](https://docs.querying.ai/fr/concepts/credits-and-limits.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.