API des résultats Google Places (GOOGLE_PLACES)

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.

Requête

Cette requête demande les 100 premiers lieux que Google affiche pour les soins de longue durée à Manville, Rhode Island :

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 :

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. 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 :

{
  "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 : `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.

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.
Les autres erreurs de requête sont listées dans Erreurs.

Voir aussi

Google Search pour une page de résultats avec son pack local
Régions et position
Crédits et limites

Premiers pas

Concepts clés

Moteurs de réponse

Recherche et données web

Options de requête

Analyses

Suivi GEO

Compte et données

API des résultats Google Places (GOOGLE_PLACES)

Requête

Paramètres

Réponse

Crédits

Limites et erreurs

Voir aussi

​Requête

​Paramètres

​Réponse

​Crédits

​Limites et erreurs

​Voir aussi

Requête

Paramètres

Réponse

Crédits

Limites et erreurs

Voir aussi