Package google.maps.areainsights.v1

Индекс

AreaInsights

Определение службы для Places Aggregate RPC.

ComputeInsights

rpc ComputeInsights( ComputeInsightsRequest ) returns ( ComputeInsightsResponse )

Этот метод позволяет получить информацию о районах, используя различные фильтры, такие как: район, тип места, рабочий статус, уровень цен и рейтинги. В настоящее время поддерживаются данные «подсчет» и «места». С помощью статистики «подсчета» вы можете ответить на такие вопросы, как «Сколько ресторанов расположены в Калифорнии, которые работают, недороги и имеют средний рейтинг не менее 4 звезд» (более подробную информацию см. в перечислении insight ). С помощью статистики мест вы можете определить, какие места соответствуют запрошенному фильтру. Затем клиенты могут использовать эти имена ресурсов мест для получения более подробной информации о каждом отдельном месте с помощью Places API.

Области авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/cloud-platform

ComputeInsightsЗапрос

Запрос на RPC ComputeInsights.

Поля
insights[]

Insight

Необходимый. Информация для вычислений. В настоящее время поддерживаются только INSIGHT_COUNT и INSIGHT_PLACES.

filter

Filter

Необходимый. Фильтр понимания.

ComputeInsightsResponse

Ответ для RPC ComputeInsights.

Поля
place_insights[]

PlaceInsight

Результат для Insights.INSIGHT_PLACES.

count

int64

Результат для Insights.INSIGHT_COUNT.

Фильтр

Фильтры для RPC ComputeInsights.

Поля
location_filter

LocationFilter

Необходимый. Ограничивает результаты местами, расположенными в области, указанной фильтрами местоположений.

type_filter

TypeFilter

Необходимый. Разместите фильтры типов.

operating_status[]

OperatingStatus

Необязательный. Ограничивает результаты местами, рабочий статус которых включен в этот список. Если Operation_status не установлен, по умолчанию используется OPERATING_STATUS_OPERATIONAL.

price_levels[]

PriceLevel

Необязательный. Ограничивает результаты местами, уровень цен которых включен в этот список. Если price_levels не установлен, в результаты включаются все уровни цен.

rating_filter

RatingFilter

Необязательный. Ограничивает результаты местами, средний рейтинг пользователей которых находится в диапазоне, указанном в параметре рейтинг_фильтра. Если рейтинг_фильтра не установлен, в результат включаются все рейтинги.

Понимание

Поддерживаемые идеи.

Перечисления
INSIGHT_UNSPECIFIED Не указан.
INSIGHT_COUNT

Посчитайте проницательность.

Если указана эта информация, ComputeInsights возвращает количество мест, соответствующих указанным критериям фильтра.

Пример запроса:

{
  "insights": ["INSIGHT_COUNT"],
  "filter": {
    "locationFilter": {
      "region": {
        "place": "places/ChIJPV4oX_65j4ARVW8IJ6IJUYs"
      }
    },
    "typeFilter": {
      "includedTypes": ["restaurant"]
    },
    "operatingStatus": ["OPERATING_STATUS_OPERATIONAL"],
    "priceLevels": [
      "PRICE_LEVEL_FREE",
      "PRICE_LEVEL_INEXPENSIVE"
    ],
    "ratingFilter": {
      "minRating": 4.0
    }
  }
}

Пример ответа:

{
  "count": 1234
}
INSIGHT_PLACES

Возвращение мест

Если указана эта информация, ComputeInsights возвращает идентификаторы мест, соответствующие указанным критериям фильтра.

Пример запроса:

{
  "insights": ["INSIGHT_PLACES"],
  "filter": {
    "locationFilter": {
      "region": {
        "place": "places/ChIJPV4oX_65j4ARVW8IJ6IJUYs"
      }
    },
    "typeFilter": {
      "includedTypes": ["restaurant"]
    },
    "operatingStatus": ["OPERATING_STATUS_OPERATIONAL"],
    "priceLevels": [
      "PRICE_LEVEL_FREE",
      "PRICE_LEVEL_INEXPENSIVE"
    ],
    "ratingFilter": {
      "minRating": 4.0
    }
  }
}

Пример ответа:

{
  "placeInsights": [
    {"place": "places/ABC"},
    {"place": "places/PQR"},
    {"place": "places/XYZ"}
  ]
}

Фильтр местоположения

Фильтры местоположения.

Указывает область интереса для анализа.

Поля
area поля Союза. Необходимо указать одно из следующих значений. area может быть только одной из следующих:
circle

Circle

Площадь в виде круга.

region

Region

Район как регион.

custom_area

CustomArea

Пользовательская область, заданная многоугольником.

Круг

Круг определяется центральной точкой и радиусом в метрах.

Поля
radius

int32

Необязательный. Радиус круга в метрах

Полевой center Союза. Центр круга. center может быть только одним из следующих:
lat_lng

LatLng

Широта и долгота центра круга.

place

string

Формат: должен быть в формате places/PLACE_ID , где PLACE_ID — это уникальный идентификатор места. Например: places/ChIJgUbEo8cfqokR5lP9_Wh_DaM .

CustomArea

Пользовательская область.

Поля
polygon

Polygon

Необходимый. Пользовательская область, представленная в виде многоугольника

Полигон

Многоугольник представлен серией связанных координат в упорядоченной последовательности против часовой стрелки. Координаты образуют замкнутый контур и определяют заполненную область. Первая и последняя координаты эквивалентны и должны содержать одинаковые значения. Формат представляет собой упрощенную версию полигонов GeoJSON (мы поддерживаем только одно внешнее кольцо против часовой стрелки).

Поля
coordinates[]

LatLng

Необязательный. Координаты, определяющие многоугольник.

Область

Регион — это географическая граница, например: города, почтовые индексы, округа, штаты и т. д.

Поля
region союзного поля. Определяет географический регион. Одновременно можно указать только один тип региона (например, место). region может быть только одним из следующих:
place

string

Уникальный идентификатор определенного географического региона.

Операционный статус

Рабочее состояние места.

Перечисления
OPERATING_STATUS_UNSPECIFIED Не указан. Это значение не следует использовать.
OPERATING_STATUS_OPERATIONAL Место работает и открыто в определенные часы.
OPERATING_STATUS_PERMANENTLY_CLOSED The Place больше не занимается бизнесом.
OPERATING_STATUS_TEMPORARILY_CLOSED Заведение временно закрыто и, как ожидается, откроется в будущем.

ПлейсИнсайт

Содержит информацию о месте

Поля
place

string

Уникальный идентификатор места. Это имя ресурса можно использовать для получения сведений о месте с помощью Places API .

Уровень цены

Уровень цен места.

Перечисления
PRICE_LEVEL_UNSPECIFIED Не указан. Это значение не следует использовать.
PRICE_LEVEL_FREE Место предоставляет бесплатные услуги.
PRICE_LEVEL_INEXPENSIVE Место предоставляет недорогие услуги.
PRICE_LEVEL_MODERATE Место предоставляет услуги по умеренным ценам.
PRICE_LEVEL_EXPENSIVE Место предоставляет дорогие услуги.
PRICE_LEVEL_VERY_EXPENSIVE Место предоставляет очень дорогие услуги.

РейтингФильтр

Фильтры среднего рейтинга пользователей.

Поля
min_rating

float

Необязательный. Ограничивает результаты местами, средний рейтинг пользователей которых больше или равен min_rating. Значения должны находиться в диапазоне от 1,0 до 5,0.

max_rating

float

Необязательный. Ограничивает результаты местами, средний рейтинг пользователей которых строго меньше или равен max_rating. Значения должны находиться в диапазоне от 1,0 до 5,0.

ТипФильтр

Разместите фильтры типов.

Поддерживаются только типы мест из таблицы a .

С местом может быть связан только один основной тип. Например, основным типом может быть «mexican_restaurant» или «steak_house». Используйте «included_primary_types» и «excluded_primary_types», чтобы отфильтровать результаты по основному типу места.

С местом также может быть связано несколько значений типа. Например, ресторан может иметь следующие типы: «морепродукты_ресторан», «ресторан», «еда», «точка_интереса», «заведение». Используйте включенные_типы и исключенные_типы, чтобы фильтровать результаты в списке типов, связанных с местом.

Если для поиска заданы ограничения нескольких типов, возвращаются только места, удовлетворяющие всем ограничениям. Например, если вы укажете {"included_types": ["restaurant"], "excluded_primary_types": ["steak_house"]}, возвращаемые места предоставляют услуги, связанные с "рестораном", но не работают в основном как "стейк-хаус".

Если есть какие-либо конфликтующие типы, т. е. тип появляется как в типах include_types, так и в исключениях_types или в включенных_primary_types и Excluded_primary_types, возвращается ошибка INVALID_ARGUMENT.

Должен быть установлен один из включенных_типов или включенных_первичных_типов.

Поля
included_types[]

string

Необязательный. Включенные типы мест.

excluded_types[]

string

Необязательный. Исключенные типы мест.

included_primary_types[]

string

Необязательный. Включены основные типы мест.

excluded_primary_types[]

string

Необязательный. Исключены основные типы мест.