Places Aggregate API – это сервис, который предоставляет статистику о местах в указанной области на основе таких критериев, как местоположение, тип, статус работы, уровень цен и оценки пользователей. Этот сервис помогает анализировать плотность определенных типов мест вокруг заданного местоположения и отвечать на такие вопросы, как "Сколько ресторанов с пятью звездами и тремя знаками доллара находятся в радиусе пяти километров от этого местоположения?"
Результаты возвращаются в виде агрегированных значений или идентификаторов мест в интересующей вас области поиска. Пользователи могут использовать Place Details API, чтобы получить дополнительную информацию об этих идентификаторах мест.
Зачем использовать Places Aggregate API
Places Aggregate API позволяет пользователям принимать решения на основе данных, которые вы предоставляете о различных местах. В нем используются точные и актуальные модели мест, которые поддерживают следующие основные варианты использования:
- Компании. Анализ конкурентов и потенциальных мест для новых филиалов.
- Разработчики могут создавать приложения с персонализированными рекомендациями.
- Исследователи могут изучать тенденции и закономерности в определенных областях.
Что можно делать с помощью Places Aggregate API
Places Aggregate API позволяет получать следующую информацию:
- Количество. Получите количество мест, соответствующих вашим критериям.
- Идентификаторы мест. Получайте идентификаторы мест, соответствующих вашим критериям.
Вы также можете использовать фильтрацию, чтобы уточнить поиск на основе различных атрибутов, таких как типы мест, часы работы, уровни цен и оценки клиентов.
Примеры
В этом разделе приведены примеры использования Places Aggregate API и рабочий код для каждого из них.
Открытие нового кафе
Владелец ресторана хочет открыть новое кафе. Для этого они хотят визуализировать местоположение всех кофеен, чтобы определить районы с высокой и низкой концентрацией и на основе этого принять решение. Places Aggregate API помогает анализировать количество кафе в определенном радиусе на основе таких атрибутов, как статус работы, ценовая категория и оценки клиентов, чтобы принимать решения о том, где открыть следующее заведение, на основе данных.

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

Как работает Places Aggregate API
Places Aggregate API позволяет задавать фильтры, чтобы сузить критерии поиска.
Выбрав тип статистики INSIGHT_COUNT или INSIGHT_PLACES, вы можете добавить критерии фильтрации, в том числе:
- Местоположение. Определите интересующую вас область с помощью кругов, регионов или многоугольников.
- Тип. Укажите типы мест, которые вас интересуют.
- Статус работы. Фильтрация мест по статусу работы.
- Уровень цен. Фильтр по уровню цен.
- Рейтинги: Фильтр мест по средней оценке пользователей.
Объект ComputeInsightsResponse в ответе API содержит результаты запроса статистики. Например, если вы выбрали INSIGHT_COUNT, в ответе будет общее количество мест, а если INSIGHT_PLACES – список идентификаторов мест.
Как использовать Places Aggregate API
| 1 | Настройте устройство. | Начните с раздела Настройка проекта Google Cloud и выполните все инструкции. |
| 2 | Отправьте запрос, чтобы получить количество совпадающих мест. | Подробнее о том, как создать первый запрос… |
| 3 | Подробнее о параметрах запроса… | Подробнее о параметрах запроса… |
Дальнейшие действия
- Цены и лимиты на использование
- Посмотреть документацию по API
- Часто задаваемые вопросы
- Варианты поддержки