Обзор

API Places Aggregate — это сервис, предоставляющий информацию о местах в указанном районе на основе таких критериев, как местоположение, тип, статус работы, уровень цен и оценки пользователей. Этот сервис может помочь проанализировать плотность мест определённых типов в определённом месте и ответить на вопросы, например: «Какие или сколько ресторанов $$$ с рейтингом 5 звёзд находятся в радиусе 5 км от этого места?»

Результаты возвращаются либо в виде агрегированных значений, либо в виде идентификаторов найденных мест в интересующей области поиска. Пользователи могут использовать API Place Details для получения дополнительной информации об этих идентификаторах мест.

Зачем использовать API Places Aggregate

API Places Aggregate позволяет вашим пользователям принимать решения на основе предоставленной вами исчерпывающей информации о различных местах. Он использует точные и актуальные модели мест, что позволяет использовать их в следующих ключевых случаях:

  • Предприятия : проанализируйте конкуренцию и потенциальные места для новых филиалов.
  • Разработчики : создание приложений, предоставляющих персонализированные рекомендации.
  • Исследователи : изучают тенденции и закономерности в конкретных областях.

Что можно сделать с помощью API Places Aggregate

С помощью Places Aggregate API вы можете получить следующую информацию:

  • Количество : получение количества мест, соответствующих вашим критериям.
  • Идентификаторы мест : получение идентификаторов определенных мест, соответствующих вашим критериям.

Вы также можете использовать фильтрацию , чтобы уточнить свой поиск по различным атрибутам, таким как типы мест, часы работы, уровни цен и оценки клиентов.

Примеры

В этом разделе описываются примеры использования API Places Aggregate и приводится рабочий код для каждого примера.

Открытие нового кафе

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

Посмотреть образец

Карта Сан-Франциско и рейтинги развлечений по почтовому индексу.

Инвестиционная фирма в сфере недвижимости

Компания, инвестирующая в недвижимость, хочет улучшить свои финансовые модели и точно оценить рентабельность инвестиций в недвижимость. Используя API Places Aggregate, компания может собирать подробные данные об удобствах рядом с потенциальными инвестиционными объектами, такими как банкоматы, больницы, остановки общественного транспорта и продуктовые магазины, чтобы оценить удобства рядом с потенциальными инвестиционными объектами.

Служба розничной доставки

При выходе на новый город службе доставки розничной торговли необходимо определить количество курьеров для работы в регионе, исходя из плотности популярных мест, таких как рестораны, магазины шаговой доступности и винные магазины. Используя API, служба доставки подсчитывает общее количество таких заведений по всему городу, чтобы эффективно планировать и распределять ресурсы.

Посмотреть образец

Тепловая карта ресторанов по объему в Маунтин-Вью.

Как работает API Places Aggregate

API Places Aggregate позволяет задавать фильтры для сужения критериев поиска. Выбрав тип данных ( INSIGHT_COUNT или INSIGHT_PLACES , вы можете добавить критерии фильтрации, включая следующие:

  • Местоположение : определите интересующую область с помощью кругов, регионов или пользовательских многоугольников.
  • Тип : укажите типы мест, которые вас интересуют.
  • Статус операций : Фильтрация мест по их статусу операций.
  • Уровни цен : Фильтрация мест по уровням цен.
  • Рейтинги : Фильтрация мест на основе оценок пользователей.

Объект ответа API ComputeInsightsResponse содержит результаты запроса. Например, если выбрано значение INSIGHT_COUNT , ответ содержит общее количество мест, а если выбрано значение INSIGHT_PLACES , ответ содержит список идентификаторов мест.

Как использовать API Places Aggregate

1 Приступайте к работе. Начните с настройки проекта Google Cloud и следуйте приведенным ниже инструкциям.
2 Сделайте запрос, чтобы получить количество совпадающих мест. См. раздел Сделайте свой первый запрос .
3 Узнайте о параметрах запроса. См. Параметры запроса .

Что дальше?