Функции зон
Используйте уже имеющиеся в Navixy геозоны в потоках IoT Logic, чтобы реагировать, когда устройство входит в область или покидает ее, либо фиксировать, в какой области оно находится.
Функции зон позволяют потоку реагировать на местоположение устройства, используя уже созданные в Navixy зоны. Вы ссылаетесь на зону вместо того, чтобы описывать область координатами, поэтому границы остаются теми же, что вы уже используете для контроля событий и отчетов.
Какая функция вам нужна
Действовать по отношению к одной конкретной зоне, когда устройство находится в ней, входит в нее или выходит из нее
inGeofence(), enterGeofence(), leaveGeofence(). См. Реакция на одну зону
Узнать, в какой зоне находится устройство, не указывая ее заранее
geofenceName(). См. Запись текущей зоны
Реакция на одну зону
Используйте эти три функции, когда вы уже знаете, какая зона важна. Каждая из них для большинства пакетов данных, которые отправляет устройство, отвечает «да» или «нет», поэтому поток может отправить эти данные по одной ветке или по другой. Для некоторых пакетов функция не может ответить и вместо этого возвращает пустое значение. См. Когда функция зоны не дает ответа.
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.
Чтобы добавить функцию зоны в выражение:
Найдите и выберите зону
Введите часть названия зоны, чтобы отфильтровать список. Каждая зона отображается три раза — по одному разу для каждой доступной функции. Выберите запись, в которой нужная зона сочетается с функцией, соответствующей вашему условию:
inGeofence— используйте, когда нужно проверить, находится ли устройство сейчас внутри выбранной зоны.enterGeofence— используйте, когда нужно определить, что устройство переместилось снаружи выбранной зоны внутрь нее.leaveGeofence— используйте, когда нужно определить, что устройство переместилось изнутри выбранной зоны наружу.
Селектор вставляет полный вызов функции в позицию курсора в поле выражения.
При необходимости объедините с другими условиями
Используйте логические операторы, чтобы объединить функцию зоны с другими условиями. См. Примеры условий.
Селектор вставляет только три функции, основанные на ID. Чтобы использовать geofenceName(), введите его в поле вручную.
Примеры условий
Запись текущей зоны
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 не ранжирует перекрывающиеся зоны, и одно и то же название возвращается до тех пор, пока устройство остается в области перекрытия.
Примеры формул
Часто задаваемые вопросы
Где найти 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 всегда пуст?
Проверьте эти причины по порядку:
Эта опция не включена для вашей учётной записи. Ранее сохранённый поток продолжает работать, и функция возвращает пустое значение для каждого пакета. См. Перед началом работы.
Переданный вами тег не назначен ни одной зоне. Имена тегов должны совпадать с тегом, который существует в вашей учётной записи.
Устройство действительно находится вне каждой зоны, которую вы искали.
У вас очень большое количество зон, а формула не передаёт тег. Передайте тег, чтобы искать меньший набор. Точное пороговое значение указано в Функция названия зоны.
Последнее обновление
Это было полезно?
