Créer votre première requête

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

Essayer

Pour utiliser Place Insights, 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 Insights

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 et définir des paramètres.
  3. Modifiez éventuellement 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 effectuer la demande.

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

Étape suivante