- HTTP-запрос
- Тело запроса
- Тело ответа
- Области авторизации
- Понимание
- Фильтр
- Фильтр местоположения
- Круг
- ШиротаДлительность
- Область
- CustomArea
- Полигон
- ТипФильтр
- Операционный статус
- Уровень цены
- РейтингФильтр
- ПлейсИнсайт
Compute Insights RPC
Этот метод позволяет вам получить информацию о районах, используя различные фильтры, такие как: район, тип места, рабочий статус, уровень цен и рейтинги. В настоящее время поддерживаются данные «подсчет» и «места». С помощью статистики «подсчета» вы можете ответить на такие вопросы, как «Сколько ресторанов расположены в Калифорнии, которые работают, недороги и имеют средний рейтинг не менее 4 звезд» (более подробную информацию см. в перечислении insight
). С помощью статистики мест вы можете определить, какие места соответствуют запрошенному фильтру. Затем клиенты могут использовать эти имена ресурсов мест для получения более подробной информации о каждом отдельном месте с помощью Places API.
HTTP-запрос
POST https://areainsights.googleapis.com/v1:computeInsights
URL-адрес использует синтаксис транскодирования gRPC .
Тело запроса
Тело запроса содержит данные следующей структуры:
JSON-представление |
---|
{ "insights": [ enum ( |
Поля | |
---|---|
insights[] | Необходимый. Информация для вычислений. В настоящее время поддерживаются только INSIGHT_COUNT и INSIGHT_PLACES. |
filter | Необходимый. Фильтр понимания. |
Тело ответа
Ответ для RPC v1.computeInsights.
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{
"placeInsights": [
{
object ( |
Поля | |
---|---|
placeInsights[] | Результат для Insights.INSIGHT_PLACES. |
count | Результат для Insights.INSIGHT_COUNT. |
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/cloud-platform
Понимание
Поддерживаемые идеи.
Перечисления | |
---|---|
INSIGHT_UNSPECIFIED | Не указан. |
INSIGHT_COUNT | Посчитайте проницательность. Если указана эта информация, v1.computeInsights возвращает количество мест, соответствующих указанным критериям фильтра.
|
INSIGHT_PLACES | Возвращение мест Если указана эта информация, v1.computeInsights возвращает места, соответствующие указанным критериям фильтра.
|
Фильтр
Фильтры для RPC v1.computeInsights.
JSON-представление |
---|
{ "locationFilter": { object ( |
Поля | |
---|---|
locationFilter | Необходимый. Ограничивает результаты местами, расположенными в области, указанной фильтрами местоположений. |
typeFilter | Необходимый. Разместите фильтры типов. |
operatingStatus[] | Необязательный. Ограничивает результаты местами, рабочий статус которых включен в этот список. Если OperationStatus не установлен, по умолчанию используется OPERATING_STATUS_OPERATIONAL. |
priceLevels[] | Необязательный. Ограничивает результаты местами, уровень цен которых включен в этот список. Если Price_level не установлен, в результаты включаются все уровни цен. |
ratingFilter | Необязательный. Ограничивает результаты местами, средние оценки пользователей которых находятся в диапазоне, указанном в параметреatingFilter. Если рейтингFilter не установлен, в результат включаются все рейтинги. |
Фильтр местоположения
Фильтры местоположения.
Указывает область интереса для анализа.
JSON-представление |
---|
{ // Union field |
Поля | |
---|---|
area Союзного поля. Необходимо указать одно из следующих значений. area может быть только одной из следующих: | |
circle | Площадь в виде круга. |
region | Район как регион. |
customArea | Пользовательская область, заданная многоугольником. |
Круг
Круг определяется центральной точкой и радиусом в метрах.
JSON-представление |
---|
{ "radius": integer, // Union field |
Поля | |
---|---|
radius | Необязательный. Радиус круга в метрах |
Полевой center Союза. Центр круга. center может быть только одним из следующих: | |
latLng | Широта и долгота центра круга. |
place | Имя ресурса Place центра круга. Поддерживаются только точечные места. |
ШиротаДлительность
Объект, представляющий пару широты и долготы. Это выражается в виде пары двойных чисел, обозначающих градусы широты и градусы долготы. Если не указано иное, этот объект должен соответствовать стандарту WGS84 . Значения должны находиться в пределах нормализованных диапазонов.
JSON-представление |
---|
{ "latitude": number, "longitude": number } |
Поля | |
---|---|
latitude | Широта в градусах. Оно должно находиться в диапазоне [-90,0, +90,0]. |
longitude | Долгота в градусах. Оно должно находиться в диапазоне [-180,0, +180,0]. |
Область
Регион — это географическая граница, например: города, почтовые индексы, округа, штаты и т. д.
JSON-представление |
---|
{ // Union field |
Поля | |
---|---|
region союзного поля. Определяет географический регион. Одновременно можно указать только один тип региона (например, место). region может быть только одним из следующих: | |
place | Уникальный идентификатор определенного географического региона. |
CustomArea
Пользовательская область.
JSON-представление |
---|
{
"polygon": {
object ( |
Поля | |
---|---|
polygon | Необходимый. Пользовательская область, представленная в виде многоугольника |
Полигон
Многоугольник представлен серией связанных координат в упорядоченной последовательности против часовой стрелки. Координаты образуют замкнутый контур и определяют заполненную область. Первая и последняя координаты эквивалентны и должны содержать одинаковые значения. Формат представляет собой упрощенную версию полигонов GeoJSON (мы поддерживаем только одно внешнее кольцо против часовой стрелки).
JSON-представление |
---|
{
"coordinates": [
{
object ( |
Поля | |
---|---|
coordinates[] | Необязательный. Координаты, определяющие многоугольник. |
ТипФильтр
Разместите фильтры типов.
Поддерживаются только типы мест из таблицы a .
С местом может быть связан только один основной тип. Например, основным типом может быть «mexican_restaurant» или «steak_house». Используйте includePrimaryTypes и ExcludedPrimaryTypes, чтобы фильтровать результаты по основному типу места.
С местом также может быть связано несколько значений типа. Например, ресторан может иметь следующие типы: «морепродукты_ресторан», «ресторан», «еда», «точка_интереса», «заведение». Используйте включенныетипы и исключенныетипы, чтобы фильтровать результаты в списке типов, связанных с местом.
Если для поиска заданы ограничения нескольких типов, возвращаются только места, удовлетворяющие всем ограничениям. Например, если вы укажете {"includedTypes": ["restaurant"], "excludedPrimaryTypes": ["steak_house"]}, возвращаемые места предоставляют услуги, связанные с "рестораном", но не работают в основном как "стейк-хаус".
Если есть какие-либо конфликтующие типы, т. е. тип появляется как в типах includeTypes, так и в ExcludedTypes или в типах includePrimaryTypes и ExcludedPrimaryTypes, возвращается ошибка INVALID_ARGUMENT.
Должен быть установлен один из включенных типов или включенных первичных типов.
JSON-представление |
---|
{ "includedTypes": [ string ], "excludedTypes": [ string ], "includedPrimaryTypes": [ string ], "excludedPrimaryTypes": [ string ] } |
Поля | |
---|---|
includedTypes[] | Необязательный. Включенные типы мест. |
excludedTypes[] | Необязательный. Исключенные типы мест. |
includedPrimaryTypes[] | Необязательный. Включены основные типы мест. |
excludedPrimaryTypes[] | Необязательный. Исключены основные типы мест. |
Операционный статус
Рабочее состояние места.
Перечисления | |
---|---|
OPERATING_STATUS_UNSPECIFIED | Не указан. |
OPERATING_STATUS_OPERATIONAL | Место работает и открыто в определенные часы. |
OPERATING_STATUS_PERMANENTLY_CLOSED | The Place больше не занимается бизнесом. |
OPERATING_STATUS_TEMPORARILY_CLOSED | Место временно закрыто и, как ожидается, откроется в будущем. |
Уровень цены
Уровень цен места.
Перечисления | |
---|---|
PRICE_LEVEL_UNSPECIFIED | Уровень цен на место не указан или неизвестен. |
PRICE_LEVEL_FREE | Место предоставляет бесплатные услуги. |
PRICE_LEVEL_INEXPENSIVE | Место предоставляет недорогие услуги. |
PRICE_LEVEL_MODERATE | Место предоставляет услуги по умеренным ценам. |
PRICE_LEVEL_EXPENSIVE | Место предоставляет дорогие услуги. |
PRICE_LEVEL_VERY_EXPENSIVE | Место предоставляет очень дорогие услуги. |
РейтингФильтр
Фильтры среднего рейтинга пользователей.
JSON-представление |
---|
{ "minRating": number, "maxRating": number } |
Поля | |
---|---|
minRating | Необязательный. Ограничивает результаты местами, средний рейтинг пользователей которых больше или равен minRating. Значения должны находиться в диапазоне от 1,0 до 5,0. |
maxRating | Необязательный. Ограничивает результаты местами, средний рейтинг пользователей которых строго меньше или равен maxRating. Значения должны находиться в диапазоне от 1,0 до 5,0. |
ПлейсИнсайт
Содержит информацию о месте
JSON-представление |
---|
{ "place": string } |
Поля | |
---|---|
place | Уникальный идентификатор места. Это имя ресурса можно использовать для получения сведений о месте с помощью Places API . |