Параметры запроса

В этом документе описаны параметры запроса для API Places Insights, а также приведены сведения и рекомендации по использованию этой службы.

API Places Insights позволяет выполнять несколько ключевых функций:

  • Подсчет мест . Определите количество мест, соответствующих определенным критериям, таким как тип местоположения, рабочий статус, уровень цен и рейтинги.
  • Получить сведения о месте . Получите названия мест, соответствующие указанным фильтрам, а затем получите более подробную информацию с помощью API-интерфейса Places.
  • Гибкая фильтрация : применяйте комплексные фильтры для получения точной информации. Доступные фильтры включают следующее:
    • Географическая область (круг, регион или пользовательский многоугольник)
    • Типы мест
    • Рабочее состояние
    • Уровни цен
    • Диапазоны рейтингов

Обязательные параметры

В этом разделе описаны обязательные параметры при отправке запроса к API Places Insights. Каждый запрос должен содержать следующее:

  • Тип прозрения.
  • Фильтр местоположения и фильтр типа.

Тип статистики

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

  • INSIGHT_COUNT : возвращает количество мест, соответствующих критериям фильтра.
  • INSIGHT_PLACES : возвращает идентификаторы мест , соответствующие критериям фильтра.

Фильтры

Определяет критерии фильтрации мест. Как минимум, вы должны указать LocationFilter и TypeFilter .

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

Фильтр местоположения может иметь один из следующих типов:

  • circle : определяет область как круг с центром и радиусом.
  • region : определяет область как регион.
  • customArea : определяет область как пользовательский многоугольник.
Круг

Если вы выберете географическую область в виде круга, вам необходимо указать center и radius . center может быть либо широта и долгота, либо идентификатор места центра круга. Этот метод обеспечивает точную и аккуратную фильтрацию на основе определенной вами круговой области.

  • center :
    • latLng : широта и долгота центра круга. Широта должна быть числом от -90 до 90 включительно. Долгота должна быть числом от -180 до 180 включительно.
    • place : идентификатор места в центре круга. Обратите внимание, что поддерживаются только точечные места. Эта строка должна начинаться с префикса places/ .
  • radius : Радиус круга в метрах. Это число должно быть положительным.
Область

Определите свою область как регион, передав идентификатор места в параметр place . Идентификатор места представляет собой географическую область (например, область, представленную многоугольником). Например, идентификатор места в Тампе, штат Флорида, — places/ChIJ4dG5s4K3wogRY7SWr4kTX6c . Обратите внимание, что не все идентификаторы мест имеют четко определенную геометрию, и в этих случаях API Places Insights возвращает код ошибки 400 с сообщением, указывающим, что регион не поддерживается. Кроме того, для сложных географических регионов внутренняя оптимизация обработки может привести к небольшому завышению площади (до 2–3%), представляющей регион.

Чтобы определить, представляет ли идентификатор места неподдерживаемый тип места, передайте идентификатор места в запросе API геокодирования . Ответ включает в себя массив type , в котором перечислены типы мест, связанные с идентификатором места, например locality , neighborhood или country . Место будет отклонено для региональной фильтрации, если какой-либо из его типов соответствует этому списку.

К неподдерживаемым типам мест относятся:

  • establishment : обычно указывает на место, которое еще не было отнесено к категории.
  • intersection : указывает на крупный перекресток, обычно двух основных дорог.
  • subpremise : указывает адресный объект ниже уровня помещения, например квартиру, блок или люкс.
Пользовательская область

Определяет площадь пользовательского многоугольника с использованием координат широты и долготы.

Вы можете посетить https://geojson.io/, чтобы нарисовать собственный многоугольник и ввести эти координаты в запрос. Многоугольник должен иметь минимум 4 координаты, причем первая и последняя координаты идентичны. Минимум 3 из предоставленных координат должны быть уникальными.

Последовательно одинаковые координаты будут рассматриваться как одна координата. Однако непоследовательные повторяющиеся координаты (кроме требуемых идентичных первой и последней координат) приведут к ошибке.

Кроме того, несмежным ребрам не разрешается пересекаться, а также ребрам длиной 180 градусов (то есть соседние вершины не могут быть антиподальными).

Например:

"coordinates":[
   {
      "latitude":37.776,
      "longitude":-122.666
   },
   {
      "latitude":37.130,
      "longitude":-121.898
   },
   {
      "latitude":37.326,
      "longitude":-121.598
   },
   {
      "latitude":37.912,
      "longitude":-122.247
   },
   {
      "latitude":37.776,
      "longitude":-122.666
   }
]

Тип фильтра

Указывает типы мест, которые необходимо включить или исключить. Список основных и дополнительных типов мест, которые поддерживает API Places Insights, см. в таблице A в разделе «Типы мест для API Places (новое)». Необходимо указать хотя бы один тип includedTypes или includedPrimaryTypes типов.

  • includedTypes : список включенных типов мест.
  • excludedTypes : список исключенных типов мест.
  • includedPrimaryTypes : список включенных основных типов мест.
  • excludedPrimaryTypes : список исключенных основных типов мест.

Подробнее о том, как работают фильтры типов и типы мест, читайте в статье «Фильтры типов» .

Дополнительные параметры

Эти фильтры являются дополнительными:

  • operatingStatus : определяет статусы мест, которые нужно включить или исключить. По умолчанию используется фильтрация по operatingStatus: OPERATING_STATUS_OPERATIONAL (одно конкретное значение).
  • priceLevels : определяет уровни цен для мест, которые необходимо включить. По умолчанию фильтрация по уровню цен не применяется, и возвращаются все места (в том числе без информации об уровне цен).
  • ratingFilter : определяет диапазон рейтингов мест. По умолчанию фильтрация отсутствует (все рейтинги включены в результаты).

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

С помощью фильтра operatingStatus вы можете осуществлять фильтрацию на основе рабочего статуса , например OPERATIONAL или TEMPORARILY_CLOSED . Поведение фильтра operatingStatus работает следующим образом:

  • Если фильтры не заданы, в результаты включаются только места с рабочим статусом OPERATING_STATUS_OPERATIONAL .
  • Если предусмотрен один или несколько фильтров, необходимо указать допустимые значения рабочего состояния ( OPERATING_STATUS_OPERATIONAL , OPERATING_STATUS_PERMANENTLY_CLOSED или OPERATING_STATUS_TEMPORARILY_CLOSED ).

Уровень цен

С помощью фильтра priceLevels вы можете фильтровать места по уровню цен . Допустимые значения уровня цен: PRICE_LEVEL_FREE , PRICE_LEVEL_INEXPENSIVE , PRICE_LEVEL_MODERATE , PRICE_LEVEL_EXPENSIVE и PRICE_LEVEL_VERY_EXPENSIVE .

Поведение фильтра priceLevels следующее:

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

Рейтинговый фильтр

Фильтрует места на основе среднего рейтинга пользователей. Оба эти поля являются необязательными, поэтому, если они опущены, по умолчанию в них также будут включены места, у которых нет рейтинга.

  • minRating : Минимальный средний рейтинг пользователя (от 1,0 до 5,0).
  • maxRating : Максимальный средний рейтинг пользователя (от 1,0 до 5,0).

Кроме того, значение minRating всегда должно быть меньше или равно значению maxRating . Если minRating указано больше, чем maxRating , возвращается ошибка INVALID_ARGUMENT .

,

В этом документе описаны параметры запроса для API Places Insights, а также приведены сведения и рекомендации по использованию этой службы.

API Places Insights позволяет выполнять несколько ключевых функций:

  • Подсчет мест . Определите количество мест, соответствующих определенным критериям, таким как тип местоположения, рабочий статус, уровень цен и рейтинги.
  • Получение сведений о месте . Получите названия мест, соответствующие указанным фильтрам, а затем получите более подробную информацию с помощью Places API.
  • Гибкая фильтрация : применяйте комплексные фильтры для получения точной информации. Доступные фильтры включают следующее:
    • Географическая область (круг, регион или пользовательский многоугольник)
    • Типы мест
    • Рабочее состояние
    • Уровни цен
    • Диапазоны рейтингов

Обязательные параметры

В этом разделе описаны обязательные параметры при отправке запроса к API Places Insights. Каждый запрос должен содержать следующее:

  • Тип прозрения.
  • Фильтр местоположения и фильтр типа.

Тип статистики

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

  • INSIGHT_COUNT : возвращает количество мест, соответствующих критериям фильтра.
  • INSIGHT_PLACES : возвращает идентификаторы мест , соответствующие критериям фильтра.

Фильтры

Определяет критерии фильтрации мест. Как минимум, вы должны указать LocationFilter и TypeFilter .

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

Фильтр местоположения может иметь один из следующих типов:

  • circle : определяет область как круг с центром и радиусом.
  • region : определяет область как регион.
  • customArea : определяет область как пользовательский многоугольник.
Круг

Если вы выберете географическую область в виде круга, вам необходимо указать center и radius . center может быть либо широта и долгота, либо идентификатор места центра круга. Этот метод обеспечивает точную и аккуратную фильтрацию на основе определенной вами круговой области.

  • center :
    • latLng : широта и долгота центра круга. Широта должна быть числом от -90 до 90 включительно. Долгота должна быть числом от -180 до 180 включительно.
    • place : идентификатор места в центре круга. Обратите внимание, что поддерживаются только точечные места. Эта строка должна начинаться с префикса places/ .
  • radius : Радиус круга в метрах. Это число должно быть положительным.
Область

Определите свою область как регион, передав идентификатор места в параметр place . Идентификатор места представляет собой географическую область (например, область, представленную многоугольником). Например, идентификатор места в Тампе, штат Флорида, — places/ChIJ4dG5s4K3wogRY7SWr4kTX6c . Обратите внимание, что не все идентификаторы мест имеют четко определенную геометрию, и в этих случаях API Places Insights возвращает код ошибки 400 с сообщением, указывающим, что регион не поддерживается. Кроме того, для сложных географических регионов внутренняя оптимизация обработки может привести к небольшому завышению площади (до 2–3%), представляющей регион.

Чтобы определить, представляет ли идентификатор места неподдерживаемый тип места, передайте идентификатор места в запросе API геокодирования . Ответ включает в себя массив type , в котором перечислены типы мест, связанные с идентификатором места, например locality , neighborhood или country . Место будет отклонено для региональной фильтрации, если какой-либо из его типов соответствует этому списку.

К неподдерживаемым типам мест относятся:

  • establishment : обычно указывает на место, которое еще не было отнесено к категории.
  • intersection : указывает на крупный перекресток, обычно двух основных дорог.
  • subpremise : указывает адресный объект ниже уровня помещения, например квартиру, блок или люкс.
Пользовательская область

Определяет площадь пользовательского многоугольника с использованием координат широты и долготы.

Вы можете посетить https://geojson.io/, чтобы нарисовать собственный многоугольник и ввести эти координаты в запрос. Многоугольник должен иметь минимум 4 координаты, причем первая и последняя координаты идентичны. Минимум 3 из предоставленных координат должны быть уникальными.

Последовательно одинаковые координаты будут рассматриваться как одна координата. Однако непоследовательные повторяющиеся координаты (кроме требуемых идентичных первой и последней координат) приведут к ошибке.

Кроме того, несмежным ребрам не разрешается пересекаться, а также ребрам длиной 180 градусов (то есть соседние вершины не могут быть антиподальными).

Например:

"coordinates":[
   {
      "latitude":37.776,
      "longitude":-122.666
   },
   {
      "latitude":37.130,
      "longitude":-121.898
   },
   {
      "latitude":37.326,
      "longitude":-121.598
   },
   {
      "latitude":37.912,
      "longitude":-122.247
   },
   {
      "latitude":37.776,
      "longitude":-122.666
   }
]

Тип фильтра

Указывает типы мест, которые необходимо включить или исключить. Список основных и дополнительных типов мест, которые поддерживает API Places Insights, см. в таблице A в разделе «Типы мест для API Places (новое)». Необходимо указать хотя бы один тип includedTypes или includedPrimaryTypes типов.

  • includedTypes : список включенных типов мест.
  • excludedTypes : список исключенных типов мест.
  • includedPrimaryTypes : список включенных основных типов мест.
  • excludedPrimaryTypes : список исключенных основных типов мест.

Подробнее о том, как работают фильтры типов и типы мест, читайте в статье «Фильтры типов» .

Дополнительные параметры

Эти фильтры являются дополнительными:

  • operatingStatus : определяет статусы мест, которые нужно включить или исключить. По умолчанию используется фильтрация по operatingStatus: OPERATING_STATUS_OPERATIONAL (одно конкретное значение).
  • priceLevels : определяет уровни цен для мест, которые необходимо включить. По умолчанию фильтрация по уровню цен не применяется, и возвращаются все места (в том числе без информации об уровне цен).
  • ratingFilter : определяет диапазон рейтингов мест. По умолчанию фильтрация отсутствует (все рейтинги включены в результаты).

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

С помощью фильтра operatingStatus вы можете осуществлять фильтрацию на основе рабочего статуса , например OPERATIONAL или TEMPORARILY_CLOSED . Поведение фильтра operatingStatus работает следующим образом:

  • Если фильтры не заданы, в результаты включаются только места с рабочим статусом OPERATING_STATUS_OPERATIONAL .
  • Если предусмотрен один или несколько фильтров, необходимо указать допустимые значения рабочего состояния ( OPERATING_STATUS_OPERATIONAL , OPERATING_STATUS_PERMANENTLY_CLOSED или OPERATING_STATUS_TEMPORARILY_CLOSED ).

Уровень цен

С помощью фильтра priceLevels вы можете фильтровать места по уровню цен . Допустимые значения уровня цен: PRICE_LEVEL_FREE , PRICE_LEVEL_INEXPENSIVE , PRICE_LEVEL_MODERATE , PRICE_LEVEL_EXPENSIVE и PRICE_LEVEL_VERY_EXPENSIVE .

Поведение фильтра priceLevels следующее:

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

Рейтинговый фильтр

Фильтрует места на основе среднего рейтинга пользователей. Оба эти поля являются необязательными, поэтому, если они опущены, по умолчанию в них также будут включены места, у которых нет рейтинга.

  • minRating : Минимальный средний рейтинг пользователя (от 1,0 до 5,0).
  • maxRating : Максимальный средний рейтинг пользователя (от 1,0 до 5,0).

Кроме того, значение minRating всегда должно быть меньше или равно значению maxRating . Если minRating указано больше, чем maxRating , возвращается ошибка INVALID_ARGUMENT .

,

В этом документе описаны параметры запроса для API Places Insights, а также приведены сведения и рекомендации по использованию этой службы.

API Places Insights позволяет выполнять несколько ключевых функций:

  • Подсчет мест . Определите количество мест, соответствующих определенным критериям, таким как тип местоположения, рабочий статус, уровень цен и рейтинги.
  • Получить сведения о месте . Получите названия мест, соответствующие указанным фильтрам, а затем получите более подробную информацию с помощью API-интерфейса Places.
  • Гибкая фильтрация : применяйте комплексные фильтры для получения точной информации. Доступные фильтры включают следующее:
    • Географическая область (круг, регион или пользовательский многоугольник)
    • Типы мест
    • Рабочее состояние
    • Уровни цен
    • Диапазоны рейтингов

Обязательные параметры

В этом разделе описаны обязательные параметры при отправке запроса к API Places Insights. Каждый запрос должен содержать следующее:

  • Тип прозрения.
  • Фильтр местоположения и фильтр типа.

Тип статистики

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

  • INSIGHT_COUNT : возвращает количество мест, соответствующих критериям фильтра.
  • INSIGHT_PLACES : возвращает идентификаторы мест , соответствующие критериям фильтра.

Фильтры

Определяет критерии фильтрации мест. Как минимум, вы должны указать LocationFilter и TypeFilter .

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

Фильтр местоположения может иметь один из следующих типов:

  • circle : определяет область как круг с центром и радиусом.
  • region : определяет область как регион.
  • customArea : определяет область как пользовательский многоугольник.
Круг

Если вы выберете географическую область в виде круга, вам необходимо указать center и radius . center может быть либо широта и долгота, либо идентификатор места центра круга. Этот метод обеспечивает точную и аккуратную фильтрацию на основе определенной вами круговой области.

  • center :
    • latLng : широта и долгота центра круга. Широта должна быть числом от -90 до 90 включительно. Долгота должна быть числом от -180 до 180 включительно.
    • place : идентификатор места в центре круга. Обратите внимание, что поддерживаются только точечные места. Эта строка должна начинаться с префикса places/ .
  • radius : Радиус круга в метрах. Это число должно быть положительным.
Область

Определите свою область как регион, передав идентификатор места в параметр place . Идентификатор места представляет собой географическую область (например, область, представленную многоугольником). Например, идентификатор места в Тампе, штат Флорида, — places/ChIJ4dG5s4K3wogRY7SWr4kTX6c . Обратите внимание, что не все идентификаторы мест имеют четко определенную геометрию, и в этих случаях API Places Insights возвращает код ошибки 400 с сообщением, указывающим, что регион не поддерживается. Кроме того, для сложных географических регионов внутренняя оптимизация обработки может привести к небольшому завышению площади (до 2–3%), представляющей регион.

Чтобы определить, представляет ли идентификатор места неподдерживаемый тип места, передайте идентификатор места в запросе API геокодирования . Ответ включает в себя массив type , в котором перечислены типы мест, связанные с идентификатором места, например locality , neighborhood или country . Место будет отклонено для региональной фильтрации, если какой-либо из его типов соответствует этому списку.

К неподдерживаемым типам мест относятся:

  • establishment : обычно указывает на место, которое еще не было отнесено к категории.
  • intersection : указывает на крупный перекресток, обычно двух основных дорог.
  • subpremise : указывает адресный объект ниже уровня помещения, например квартиру, блок или люкс.
Пользовательская область

Определяет площадь пользовательского многоугольника с использованием координат широты и долготы.

Вы можете посетить https://geojson.io/, чтобы нарисовать собственный многоугольник и ввести эти координаты в запрос. Многоугольник должен иметь минимум 4 координаты, причем первая и последняя координаты идентичны. Минимум 3 из предоставленных координат должны быть уникальными.

Последовательно одинаковые координаты будут рассматриваться как одна координата. Однако непоследовательные повторяющиеся координаты (кроме требуемых идентичных первой и последней координат) приведут к ошибке.

Кроме того, несмежным ребрам не разрешается пересекаться, а также ребрам длиной 180 градусов (то есть соседние вершины не могут быть антиподальными).

Например:

"coordinates":[
   {
      "latitude":37.776,
      "longitude":-122.666
   },
   {
      "latitude":37.130,
      "longitude":-121.898
   },
   {
      "latitude":37.326,
      "longitude":-121.598
   },
   {
      "latitude":37.912,
      "longitude":-122.247
   },
   {
      "latitude":37.776,
      "longitude":-122.666
   }
]

Тип фильтра

Указывает типы мест, которые необходимо включить или исключить. Список основных и дополнительных типов мест, которые поддерживает API Places Insights, см. в таблице A в разделе «Типы мест для API Places (новое)». Необходимо указать хотя бы один тип includedTypes или includedPrimaryTypes типов.

  • includedTypes : список включенных типов мест.
  • excludedTypes : список исключенных типов мест.
  • includedPrimaryTypes : список включенных основных типов мест.
  • excludedPrimaryTypes : список исключенных основных типов мест.

Подробнее о том, как работают фильтры типов и типы мест, читайте в статье «Фильтры типов» .

Дополнительные параметры

Эти фильтры являются дополнительными:

  • operatingStatus : определяет статусы мест, которые нужно включить или исключить. По умолчанию используется фильтрация по operatingStatus: OPERATING_STATUS_OPERATIONAL (одно конкретное значение).
  • priceLevels : определяет уровни цен для мест, которые необходимо включить. По умолчанию фильтрация по уровню цен не применяется, и возвращаются все места (в том числе без информации об уровне цен).
  • ratingFilter : определяет диапазон рейтингов мест. По умолчанию фильтрация отсутствует (все рейтинги включены в результаты).

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

С помощью фильтра operatingStatus вы можете осуществлять фильтрацию на основе рабочего статуса , например OPERATIONAL или TEMPORARILY_CLOSED . Поведение фильтра operatingStatus работает следующим образом:

  • Если фильтры не заданы, в результаты включаются только места с рабочим статусом OPERATING_STATUS_OPERATIONAL .
  • Если предусмотрен один или несколько фильтров, необходимо указать допустимые значения рабочего состояния ( OPERATING_STATUS_OPERATIONAL , OPERATING_STATUS_PERMANENTLY_CLOSED или OPERATING_STATUS_TEMPORARILY_CLOSED ).

Уровень цен

С помощью фильтра priceLevels вы можете фильтровать места по уровню цен . Допустимые значения уровня цен: PRICE_LEVEL_FREE , PRICE_LEVEL_INEXPENSIVE , PRICE_LEVEL_MODERATE , PRICE_LEVEL_EXPENSIVE и PRICE_LEVEL_VERY_EXPENSIVE .

Поведение фильтра priceLevels следующее:

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

Рейтинговый фильтр

Фильтрует места на основе среднего рейтинга пользователей. Оба эти поля являются необязательными, поэтому, если они опущены, по умолчанию в них также будут включены места, у которых нет рейтинга.

  • minRating : Минимальный средний рейтинг пользователя (от 1,0 до 5,0).
  • maxRating : Максимальный средний рейтинг пользователя (от 1,0 до 5,0).

Кроме того, значение minRating всегда должно быть меньше или равно значению maxRating . Если minRating указано больше, чем maxRating , возвращается ошибка INVALID_ARGUMENT .

,

В этом документе описаны параметры запроса для API Places Insights, а также приведены сведения и рекомендации по использованию этой службы.

API Places Insights позволяет выполнять несколько ключевых функций:

  • Подсчет мест . Определите количество мест, соответствующих определенным критериям, таким как тип местоположения, рабочий статус, уровень цен и рейтинги.
  • Получить сведения о месте . Получите названия мест, соответствующие указанным фильтрам, а затем получите более подробную информацию с помощью API-интерфейса Places.
  • Гибкая фильтрация : применяйте комплексные фильтры для получения точной информации. Доступные фильтры включают следующее:
    • Географическая область (круг, регион или пользовательский многоугольник)
    • Типы мест
    • Рабочее состояние
    • Уровни цен
    • Диапазоны рейтингов

Обязательные параметры

В этом разделе описаны обязательные параметры при отправке запроса к API Places Insights. Каждый запрос должен содержать следующее:

  • Тип прозрения.
  • Фильтр местоположения и фильтр типа.

Тип статистики

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

  • INSIGHT_COUNT : возвращает количество мест, соответствующих критериям фильтра.
  • INSIGHT_PLACES : возвращает идентификаторы мест , соответствующие критериям фильтра.

Фильтры

Определяет критерии фильтрации мест. Как минимум, вы должны указать LocationFilter и TypeFilter .

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

Фильтр местоположения может иметь один из следующих типов:

  • circle : определяет область как круг с центром и радиусом.
  • region : определяет область как регион.
  • customArea : определяет область как пользовательский многоугольник.
Круг

Если вы выберете географическую область в виде круга, вам необходимо указать center и radius . center может быть либо широта и долгота, либо идентификатор места центра круга. Этот метод обеспечивает точную и аккуратную фильтрацию на основе определенной вами круговой области.

  • center :
    • latLng : широта и долгота центра круга. Широта должна быть числом от -90 до 90 включительно. Долгота должна быть числом от -180 до 180 включительно.
    • place : идентификатор места в центре круга. Обратите внимание, что поддерживаются только точечные места. Эта строка должна начинаться с префикса places/ .
  • radius : Радиус круга в метрах. Это число должно быть положительным.
Область

Определите свою область как регион, передав идентификатор места в параметр place . Идентификатор места представляет собой географическую область (например, область, представленную многоугольником). Например, идентификатор места в Тампе, штат Флорида, — places/ChIJ4dG5s4K3wogRY7SWr4kTX6c . Обратите внимание, что не все идентификаторы мест имеют четко определенную геометрию, и в этих случаях API Places Insights возвращает код ошибки 400 с сообщением, указывающим, что регион не поддерживается. Кроме того, для сложных географических регионов внутренняя оптимизация обработки может привести к небольшому завышению площади (до 2–3%), представляющей регион.

Чтобы определить, представляет ли идентификатор места неподдерживаемого типа места, передайте идентификатор места в запросе API геокодирования . Ответ включает в себя type массив, в которых перечислены типы мест, связанные с идентификатором места, например, locality , neighborhood или country . Место будет отклонено для фильтрации региона, если какой -либо из его типов соответствует этому списку.

Неподдерживаемые типы мест включают:

  • establishment : обычно указывает на место, которое еще не категории классифицировалось.
  • intersection : указывает на основное пересечение, обычно из двух основных дорог.
  • subpremise : указывает адресуемое объект ниже уровня предпосылки, такую ​​как квартира, единица или набор.
Пользовательская область

Определяет область пользовательского многоугольника, используя координаты широты и долготы.

Вы можете посетить https://geojson.io/, чтобы нарисовать пользовательский многоугольник и ввести эти координаты в запрос. Полигон должен иметь как минимум 4 координата, где первые и последние координаты идентичны. По крайней мере 3 из предоставленных координат должны быть уникальными.

Последовательно идентичные координаты будут рассматриваться как единая координата. Тем не менее, неспособные дублируемые координаты (кроме необходимых идентичных первых и последних координат) приведут к ошибке.

Кроме того, не примеряющиеся края не разрешаются пересечь, а края длиной 180 градусов не допускаются (то есть соседние вершины не могут быть антиподальными).

Например:

"coordinates":[
   {
      "latitude":37.776,
      "longitude":-122.666
   },
   {
      "latitude":37.130,
      "longitude":-121.898
   },
   {
      "latitude":37.326,
      "longitude":-121.598
   },
   {
      "latitude":37.912,
      "longitude":-122.247
   },
   {
      "latitude":37.776,
      "longitude":-122.666
   }
]

Тип фильтра

Определяет типы мест для включения или исключения. Список как первичных, так и второстепенных типов мест, которые поддерживает API, см. В таблице A в разделе «Типы мест для API» (новый). Вы должны указать хотя бы один includedTypes или тип includedPrimaryTypes .

  • includedTypes : список включенных типов мест.
  • excludedTypes : список исключенных типов мест.
  • includedPrimaryTypes : список включенных первичных типов мест.
  • excludedPrimaryTypes : список исключенных типов первичных мест.

Чтобы узнать больше о том, как работают фильтры типа и типы мест, посмотрите больше о фильтрах типа .

Дополнительные параметры

Эти фильтры необязательны:

  • operatingStatus : указывает статусы мест для включения или исключения. По умолчанию фильтрации с помощью operatingStatus: OPERATING_STATUS_OPERATIONAL (одно конкретное значение).
  • priceLevels : указывает уровни цен на места для включения. По умолчанию фильтрация на уровне цены не применяется, и все места (в том числе без информации о уровне цен) возвращаются.
  • ratingFilter : указывает диапазон рейтинга мест. По умолчанию не фильтрации (все оценки включены в результаты).

Рабочее статус

С помощью фильтра operatingStatus вы можете фильтровать на основе рабочего статуса , такого как OPERATIONAL или TEMPORARILY_CLOSED . Поведение фильтра operatingStatus работает следующим образом:

  • Если фильтры не были предоставлены, в результаты включены только места с рабочим статусом OPERATING_STATUS_OPERATIONAL .
  • Если предоставлены один или несколько фильтров, необходимо указать допустимые значения статуса работы ( OPERATING_STATUS_OPERATIONAL , OPERATING_STATUS_PERMANENTLY_CLOSED или OPERATING_STATUS_TEMPORARILY_CLOSED ).

Уровень цен

С помощью фильтра priceLevels вы можете фильтровать места на основе их уровня цен . Допустимые значения уровня цен являются: PRICE_LEVEL_FREE , PRICE_LEVEL_INEXPENSIVE , PRICE_LEVEL_MODERATE , PRICE_LEVEL_EXPENSIVE и PRICE_LEVEL_VERY_EXPENSIVE .

Поведение фильтра priceLevels заключается в следующем:

  • Если фильтры не предоставляются: все места возвращаются, независимо от того, есть ли у них уровень цены . Это включает в себя места без информации об уровне цен, которая не может быть возвращена при фильтрации по определенным уровням цен.
  • Если предоставляется один или несколько фильтров: возвращаются только места, соответствующие указанному уровню цен.

Рейтинговый фильтр

Фильтры места на основе их средних пользовательских рейтингов. Оба эти поля являются необязательными, и поэтому, если они опущены, они по умолчанию также будут включать места, в которых нет рейтинга.

  • minRating : минимальный средний рейтинг пользователей (от 1,0 до 5,0).
  • maxRating : максимальный средний рейтинг пользователей (от 1,0 до 5,0).

Добавлено, что minRating значение всегда должно быть меньше или равным maxRating значению. Если minRating указывается как больше, чем maxRating , возвращается ошибка INVALID_ARGUMENT .