Package google.maps.areainsights.v1

Индекс

AreaInsights

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

ComputeInsights

rpc ComputeInsights( ComputeInsightsRequest ) returns ( ComputeInsightsResponse )

Compute Insights RPC

Этот метод позволяет вам получить информацию о районах, используя различные фильтры, такие как: район, тип места, рабочий статус, уровень цен и рейтинги. В настоящее время поддерживаются данные «подсчет» и «места». С помощью статистики «подсчета» вы можете ответить на такие вопросы, как «Сколько ресторанов расположены в Калифорнии, которые работают, недороги и имеют средний рейтинг не менее 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_level не установлен, в результаты включаются все уровни цен.

rating_filter

RatingFilter

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

Понимание

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

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

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

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

For example if the request is:
ComputeInsightsRequest {
  insights: INSIGHT_COUNT
  filter {
    location_filter {region: <PlaceId of state of CA>}
    type_filter {included_types: "restaurant"}
    operating_status: OPERATING_STATUS_OPERATIONAL
    price_levels: PRICE_LEVEL_FREE
    price_levels: PRICE_LEVEL_INEXPENSIVE
    min_rating: 4.0
  }
}

The method will return the count of restaurants in California that are
operational, with price level free or inexpensive and have an average
rating of at least 4 starts.

Example response:
ComputeInsightsResponse {
  count: <number of places>
}
INSIGHT_PLACES

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

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

For example if the request is:
ComputeInsightsRequest {
  insights: INSIGHT_PLACES
  filter {
    location_filter {region: <PlaceId of state of CA>}
    type_filter {included_types: "restaurant"}
    operating_status: OPERATING_STATUS_OPERATIONAL
    price_levels: PRICE_LEVEL_FREE
    price_levels: PRICE_LEVEL_INEXPENSIVE
    min_rating: 4.0
  }
}

The method will return list of places of restaurants in
California that are operational, with price level free or inexpensive and
have an average rating of at least 4 stars.

Example response:
ComputeInsightsResponse {
  place_insights { place: "places/ABC" }
  place_insights { place: "places/PQR" }
  place_insights { place: "places/XYZ" }
}

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

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

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

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

Circle

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

region

Region

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

custom_area

CustomArea

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

Круг

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

Поля
radius

int32

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

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

LatLng

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

place

string

Имя ресурса Place центра круга. Поддерживаются только точечные места.

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

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