Обзор

The Places Aggregate API is a service that provides insights about places within a specified area based on criteria such as location, type, operating status, price level, and user ratings. This service can help analyze the density of specific Place Types around a given location, and answer questions like "What, or how many, 5-star rated $$$ restaurants are within a 5km radius of this location?"

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

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

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

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

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

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

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

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

Примеры

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

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

A restaurant owner wants to open a new cafe. To do so, they first want to visualize where the hotspots of cafes are so that they can identify areas of high and low concentration to inform their business decision. The Places Aggregate API can help analyze the number of cafes within a specific radius based on attributes like operation status, price levels, and customer ratings to make a data-backed decision on where to open their next location.

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

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

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

A real estate investment firm wants to enhance their financial models and accurately determine the ROI on their planned property investments. By using the Places Aggregate API, they can gather detailed data on the amenities near potential investment properties, such as ATMs, hospitals, transit stations, and grocery stores, so that they can understand the amenities near potential investment properties.

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

When expanding into a new city, a retail delivery service needs to determine the number of delivery drivers to allocate to a region based on the density of popular consumer destinations, such as restaurants, convenience stores and liquor stores. Using the API, the delivery service counts the total number of these establishments throughout the city so that they can plan and allocate resources effectively.

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

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

Как работает API агрегации мест

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

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

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

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

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

Что дальше?