Сделайте свой первый запрос

В этом документе рассказывается, как выполнить базовый запрос к API-интерфейсу Places Aggregate и понять ответ, который включает в себя количество совпадающих мест.

Попробуйте!

Чтобы использовать Places Aggregate API, отправьте HTTP-запрос POST в конечную точку computeInsights следующим образом:

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

Уточните свой запрос , указав параметры региона и типа в теле JSON. В этом примере показан запрос на возврат количества действующих ресторанов в Сан-Франциско с умеренными ценами и рейтингом от 4 до 5 звезд.

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
      }
   }
}'

Совокупный ответ API мест

Следующий ответ на приведенный выше пример запроса показывает количество ресторанов, соответствующих критериям.

{
  "count": "850"
}

Попробуйте!

API Explorer позволяет вам создавать примеры запросов, чтобы вы могли ознакомиться с API и опциями API.

1. Выберите значок API, , в правой части страницы.
2. При необходимости разверните Показать стандартные параметры , чтобы установить любые параметры.
3. При желании отредактируйте тело запроса .
4. Нажмите кнопку «Выполнить» . В диалоговом окне выберите учетную запись, которую вы хотите использовать для отправки запроса.

5. На панели API Explorer выберите значок развертывания, , чтобы развернуть окно API Explorer.

Что дальше

• Узнайте больше о том , чего можно достичь с помощью Places Aggregate API.
• Посмотрите параметры запроса подробнее.
• Просмотрите полную документацию по API .