Créer votre première requête

Ce document vous explique comment effectuer une requête de base auprès de l'API Places Aggregate et comment comprendre la réponse, qui inclut le 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 permettant de renvoyer le nombre de restaurants opérationnels à San Francisco, dont le prix est modéré et qui ont une note comprise entre 4 et 5 étoiles.

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 à l'exemple de requête ci-dessus indique le nombre de restaurants correspondant aux critères.

{
  "count": "850"
}

Essayer

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

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

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

Étape suivante

• Découvrez d'autres exemples de ce que vous pouvez faire avec l'API Places Aggregate.
• Examinons plus en détail les paramètres de requête.
• Consultez la documentation complète de l'API.