Créer votre première requête

Ce document vous explique comment effectuer une requête de base à l'API Places Aggregate et comprendre la réponse, qui inclut un nombre de lieux correspondants.

Essayer

Pour utiliser l'API Places Aggregate, envoyez une requête HTTP POST au point de terminaison computeInsights comme suit:

https://areainsights.googleapis.com/v1:computeInsights

affinez votre requête en fournissant des paramètres de région et de type dans le corps JSON. Cet exemple montre une requête visant à renvoyer le nombre de restaurants opérationnels, à prix modéré et notés entre 4 et 5 étoiles à San Francisco.

curl --location 'https://areainsights.googleapis.com/v1:computeInsights' \
--header 'X-Goog-Api-Key: API_KEY' \
--header 'Content-Type: application/json' \
--data '{
   "insights":[
      "INSIGHT_COUNT"
   ],
   "filter":{
      "locationFilter":{
         "region":{
            "place":"places/ChIJIQBpAG2ahYAR_6128GcTUEo"
         }
      },
      "typeFilter":{
         "includedTypes":[
            "restaurant"
         ]
      },
      "operatingStatus":[
         "OPERATING_STATUS_OPERATIONAL"
      ],
      "priceLevels":[
         "PRICE_LEVEL_INEXPENSIVE"
      ],
      "ratingFilter":{
         "minRating":4.0,
         "maxRating":5.0
      }
   }
}'

Réponse de l'API Places Aggregate

La réponse suivante de l'exemple de requête ci-dessus indique le nombre de restaurants correspondant aux critères.

{
  "count": "850"
}

Essayer

API Explorer vous permet d'envoyer des exemples de requêtes afin de vous familiariser avec l'API et ses options.

  1. Sélectionnez l'icône API Développez l'explorateur d'API. à droite de la page.
  2. Vous pouvez également développer Afficher les paramètres standards pour définir des paramètres.
  3. Modifiez éventuellement le corps de la requête.
  4. Sélectionnez le bouton Execute (Exécuter). Dans la boîte de dialogue, choisissez le compte que vous souhaitez utiliser pour effectuer la demande.

  5. Dans le panneau API Explorer, sélectionnez l'icône de développement, Développez l'explorateur d'API., pour développer la fenêtre API Explorer.

Étape suivante