For the complete documentation index, see llms.txt. This page is also available as Markdown.

Функции зон

Используйте уже имеющиеся в Navixy геозоны в потоках IoT Logic, чтобы реагировать, когда устройство входит в область или покидает ее, либо фиксировать, в какой области оно находится.

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

Какая функция вам нужна

Если вы хотите
Используйте

Действовать по отношению к одной конкретной зоне, когда устройство находится в ней, входит в нее или выходит из нее

inGeofence(), enterGeofence(), leaveGeofence(). См. Реакция на одну зону

Узнать, в какой зоне находится устройство, не указывая ее заранее

Реакция на одну зону

Используйте эти три функции, когда вы уже знаете, какая зона важна. Каждая из них для большинства пакетов данных, которые отправляет устройство, отвечает «да» или «нет», поэтому поток может отправить эти данные по одной ветке или по другой. Для некоторых пакетов функция не может ответить и вместо этого возвращает пустое значение. См. Когда функция зоны не дает ответа.

Функция
Отвечает «да», когда

inGeofence(id)

Устройство сейчас находится внутри зоны

enterGeofence(id)

Устройство только что вошло в зону

leaveGeofence(id)

Устройство только что вышло из зоны

Вы добавляете их в условие IF/THEN Логика узла. id — это числовой идентификатор зоны в вашем аккаунте Navixy, а селектор подставляет его за вас, поэтому вам редко приходится вводить его вручную. См. Как добавить условие зоны.

Когда функция зоны не дает ответа

inGeofence(), enterGeofence(), и leaveGeofence() возвращают пустое значение вместо «да» или «нет», когда не могут ответить. Функция не может ответить в таких случаях:

  • Пакет данных не содержит координат. Позиция низкого качества все равно проверяется, поэтому слабый GPS-сигнал дает реальный ответ «да» или «нет».

  • Зона была удалена из вашего аккаунта Navixy или стала недоступна после сохранения потока. Если зоны уже нет к моменту сохранения потока, она вместо этого отклоняется при сохранении.

Пустое значение останавливает условие, частью которого оно является. Когда функция составляет все условие целиком, данные идут по пути ELSE. Обычно именно такое маршрутизирование вам и нужно. Когда функция объединена с чем-то еще, пустое значение может остановить все условие, включая те части, у которых были значения. Чтобы остальная часть условия продолжала работать, сравните функцию с == true:

Полное правило см. Отсутствующие значения в выражениях.

Синтаксис

Это формат, который селектор зон вставляет автоматически. Название зоны отображается в виде комментария для удобства чтения, но не влияет на вычисление.

inGeofence() принимает еще два параметра, поэтому может проверять более раннюю позицию вместо текущей:

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

enterGeofence() и leaveGeofence() принимают ID зоны и ничего больше. Обе сравнивают текущую позицию с предыдущей, поэтому выбирать индекс не нужно. Поток, который передает второй параметр любой из этих функций, нельзя сохранить, а в сообщении об ошибке указывается функция.

Укажите индекс в диапазоне от 0 до 11. inGeofence() принимает более высокий индекс, сохраняется без ошибки, а затем возвращает пустое значение для каждого пакета.

Не оборачивайте функцию зоны в value(). Первый параметр value() является именем атрибута, а не выражением, поэтому такой вызов, как value("inGeofence(35229)", 1, 'valid') ищет атрибут с таким буквальным именем и всегда возвращает пустое значение.

Для value() подробностей о функции см. Выражения и синтаксис IF/THEN Логика.

Как добавить условие зоны

Поле выражения в IF/THEN Логика панели настройки Узла включает отдельный селектор зоны , отдельно от стандартного автодополнения атрибутов. В нем перечислены все зоны, настроенные в вашей учетной записи Navixy, сгруппированные по имени и ID.

Чтобы добавить функцию зоны в выражение:

1

Откройте конфигурацию узла

Откройте IF/THEN Логика узел, щелкнув по нему на холсте.

2

Откройте селектор зон

В поле Условное выражение (JEXL) , нажмите значок селектора зон, чтобы открыть список зон.

Geofence picker list example, with all three options (in, enter, leave geofence)
3

Найдите и выберите зону

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

  • inGeofence — используйте, когда нужно проверить, находится ли устройство сейчас внутри выбранной зоны.

  • enterGeofence — используйте, когда нужно определить, что устройство переместилось снаружи выбранной зоны внутрь нее.

  • leaveGeofence — используйте, когда нужно определить, что устройство переместилось изнутри выбранной зоны наружу.

Селектор вставляет полный вызов функции в позицию курсора в поле выражения.

4

При необходимости объедините с другими условиями

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

5

Сохраните конфигурацию

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

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

Селектор вставляет только три функции, основанные на ID. Чтобы использовать geofenceName(), введите его в поле вручную.

Примеры условий

Условие по одной зоне

Данные маршрута в зависимости от того, находится ли устройство сейчас внутри зоны доставки:

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

  • Ветка ELSE: Данные с устройств вне зоны поступают сюда для стандартной обработки.

Обнаружение въезда

Запустите действие, когда транспортное средство въезжает на ограниченный объект:

  • Ветка THEN: Подключите к Вебхук узлу, чтобы уведомить охрану объекта, или к Действие устройства узлу, чтобы записать событие въезда.

  • Ветка ELSE: Продолжайте обычную обработку данных для устройств, не въезжающих на объект.

Обнаружение выезда

Определите, когда транспортное средство покидает разрешенную сервисную зону в рабочее время:

  • Ветка THEN: Отправьте оповещение через Вебхук узел в диспетчерскую систему.

  • Ветка ELSE: Продолжайте стандартную обработку.

Комбинирование нескольких зон

Проверьте, находится ли устройство внутри любой из нескольких ограниченных зон:

Каждая функция сравнивается с == true, поэтому пакет, для которого одна из них не может принять решение, не останавливает всё условие. Без сравнения первая функция, которая возвращает пустое значение, останавливает условие, а остальные зоны никогда не проверяются. См. Когда функция зоны не дает ответа.

  • Ветка THEN: Применяйте правила или уведомления, специфичные для зоны.

  • Ветка ELSE: Обрабатывайте данные с устройств вне всех перечисленных зон.

Зона в сочетании с параметром устройства

Выявите превышение скорости в пределах определенной городской зоны:

  • Ветка THEN: Зарегистрируйте контроль скорости, привязанный к этой зоне, или отправьте целевое оповещение.

  • Ветка ELSE: Продолжайте стандартную обработку для данных, соответствующих требованиям, или данных вне зоны.

Сравнение с предыдущей позицией

Определите переход из-за пределов зоны внутрь, сравнив текущую позицию с предыдущей:

Это выражение возвращает true только на первом пакете после того, как устройство входит в зону. enterGeofence() делает то же самое за один вызов, поэтому используйте эту форму только тогда, когда вам нужен другой индекс, чем у предыдущего пакета.

Второй вызов сравнивается с == false, поэтому выражение срабатывает только тогда, когда предыдущая позиция известна и находилась вне зоны. Устройство без предыдущей допустимой позиции не подходит. Не записывайте второй член как !inGeofence(...), что не дает результата вообще, когда отсутствует предыдущая позиция для проверки.

Запись текущей зоны

geofenceName() показывает, в какой зоне находится устройство, вместо проверки одной заранее выбранной зоны. Оно возвращает имя в виде текста, а вы сохраняете этот текст в отдельном атрибуте.

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

Пакет данных

current_zone

08:14

Главный гараж

09:02

(пусто)

09:47

Объект клиента 3

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

Перед началом работы

Эту опцию необходимо включить в вашем аккаунте. geofenceName() продается отдельно и по умолчанию отключена для всех. Свяжитесь со своим поставщиком услуг и попросите его включить функцию названия зоны для вашей учетной записи. При этом полезно указать внутреннее название функции, iot_logic_зона_поиск.

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

Удалите функцию из узла, чтобы сохранить поток, или дождитесь, пока ваш поставщик услуг включит эту опцию.

Для поиска вам также нужны зоны.

  • В вашей учетной записи есть как минимум одна зона. См. Зоны.

  • Чтобы искать только часть ваших зон, присвойте им теги. См. Используйте теги и Теги.

Добавьте атрибут

Создайте вычисляемый атрибут обычным способом, как описано в Управление атрибутами, а затем введите одну из приведенных ниже формул в Формула поле.

Введите имя функции самостоятельно. Автодополнение атрибута не предлагает geofenceName, а селектор зоны доступен только в узле. IF/THEN Логика узле.

Формулы

Первые две формы охватывают большинство случаев. Третья читает предыдущее положение вместо текущего.

Формула
Что возвращает

geofenceName()

Имя любой зоны, в которой устройство находится в данный момент

geofenceName('depots')

Имя зоны с тегом депо в которой в настоящее время находится устройство

geofenceName('', 1, 'valid')

Имя любой зоны, в которой устройство находилось на один пакет данных раньше

Все три параметра необязательны:

  • Тег, во-первых, ограничивает поиск зонами, которым вы присвоили это имя. Регистр не имеет значения, а пустой тег означает все зоны. Использование тегов важно, когда у вас много зон и только некоторые из них имеют значение для этого атрибута, например депо, но не объекты клиентов.

  • Номер пакета, во-вторых, задаёт, насколько далеко назад искать: 0 это обрабатываемый пакет, 1 предыдущий и так далее. Не указывайте его для текущей позиции.

  • Фильтр по позиции, третьим, — 'действительный' чтобы пропускать пакеты, которые не содержали позицию, или 'все' чтобы учитывать их. Если его не указывать, пакеты без позиции будут учтены.

Для точных ограничений каждого параметра см. Функция названия зоны в документации API IoT Logic.

Что вы получите в ответ

Атрибут хранит название зоны в виде текста или пустое значение, когда указать нечего. Оно пустое, когда:

  • Устройство находится вне всех зон, которые были проверены.

  • Пакет данных не содержит координат.

  • Ни одна зона в вашей учетной записи не имеет переданного вами тега.

Пустое значение выглядит одинаково во всех трех случаях. В формуле это пустое значение записывается как null, именно так в примере маршрутизации ниже выполняется его проверка.

Чтобы получить читаемый текст вместо пустого значения, добавьте резервное значение с помощью ?: оператора:

Когда точка находится внутри двух перекрывающихся зон, функция возвращает одно из двух названий. Navixy не ранжирует перекрывающиеся зоны, и одно и то же название возвращается до тех пор, пока устройство остается в области перекрытия.

Примеры формул

Текущее название зоны как атрибут

В Вычисление атрибута узле создайте атрибут с именем current_zone с такой формулой:

Каждый пакет данных, записанный внутри зоны, получает название этой зоны. Пакеты, записанные вне всех зон, получают пустое значение.

Только те зоны, которые вы пометили

Пометьте зоны гаражей тегом депо, затем создайте атрибут с такой формулой:

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

Маршрутизация по области в узле IF/THEN Логика

geofenceName() также работает как условие, что полезно, когда многие зоны используют одно правило. Чтобы отправлять данные, записанные внутри любой зоны с тегом restricted в ветку THEN используйте это условие:

  • Ветка THEN: Данные, записанные внутри зоны с ограничением. Подключите его к Вебхук узлу, чтобы оповестить диспетчера.

  • Ветка ELSE: Все остальные данные.

Сравните результат с == или != только. Операторы <, >, <=, и >= не дают пригодного результата, когда значение пустое.

Обнаружение смены зоны

Чтобы срабатывать только на пакете, в котором устройство меняет зону, сравните текущее название с названием в предыдущей точке:

Пустой первый параметр означает все зоны, а 'действительный' позволяет сравнению пропускать пакеты, в которых не было координат. Без 'действительный', пакет без координат интерпретируется как пустое название зоны, и условие сообщает о несуществующей смене.

Часто задаваемые вопросы

Где найти ID зоны?

Селектор зон отображает в списке название каждой зоны и ее числовой ID. Вы также можете найти ID в интерфейсе зон Navixy. Когда вы выбираете зону в селекторе, ID автоматически вставляется в выражение.

Могу ли я сохранить проверку зоны в атрибуте?

Да. Все четыре функции работают как в формуле атрибута, так и в условии маршрутизации. geofenceName() Это естественный выбор, потому что он дает вам читаемый текст. Остальные три возвращают значение «да» или «нет» либо пустое значение, когда местоположение неизвестно. Значение «да» или «нет» обычно полезнее для маршрутизации, чем для хранения.

Выбор зоны доступен только в IF/THEN Логика узле, поэтому в формуле атрибута вы указываете функцию и идентификатор зоны сами.

Почему я не могу сохранить поток, который использует geofenceName?

geofenceName() Это платная опция, и по умолчанию она отключена. Обратитесь к поставщику услуг, чтобы её включили для вашей учётной записи. См. Перед началом работы.

Что произойдёт, если связанная зона будет удалена?

Если зона, на которую ссылается выражение, удалена из вашей учётной записи Navixy, функция больше не сможет вернуть значение и вернёт пустое значение. В IF/THEN Логика узле, который использует функцию сам по себе, данные проходят по соединению ELSE. Узел сохраняет свой атрибут как пустое значение, а не как false. В условии, которое сочетает функцию с другими терминами, пустое значение может остановить всё условие. В Вычисление атрибута узле у атрибута нет значения для этого пакета. См. Отсутствующие значения в выражениях.

Поток продолжает выполняться, но вы больше не можете сохранить его, пока не исправите выражение. При повторном сохранении возникает ошибка: Узел «<node title>» (#<node id>) содержит несуществующие или недоступные геозоны. Обновите или удалите выражение, чтобы восстановить как маршрутизацию, так и возможность сохранения.

Оценивает ли inGeofence текущее GPS-положение устройства?

Да. inGeofence() проверяет координаты, указанные в текущем пакете данных, относительно границ Зоны. Каждый пакет оценивается независимо, поэтому результат отражает положение устройства в момент получения этого пакета. Пакет, который не содержит координат, получает пустое значение вместо true или false.

В чем разница между inGeofence и enterGeofence?

inGeofence() возвращает true для каждого пакета, который сообщает о местоположении внутри зоны. enterGeofence() возвращает true только для пакета, который фиксирует момент, когда устройство пересекло зону. Используйте inGeofence когда нужно применить логику ко всем данным внутри зоны. Используйте enterGeofence когда нужно реагировать именно на событие пересечения границы.

Почему атрибут ЗонаName всегда пуст?

Проверьте эти причины по порядку:

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

  2. Переданный вами тег не назначен ни одной зоне. Имена тегов должны совпадать с тегом, который существует в вашей учётной записи.

  3. Устройство действительно находится вне каждой зоны, которую вы искали.

  4. У вас очень большое количество зон, а формула не передаёт тег. Передайте тег, чтобы искать меньший набор. Точное пороговое значение указано в Функция названия зоны.

Последнее обновление

Это было полезно?