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 à San Francisco qui sont opérationnels, à des prix modérés et notés 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 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 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