← Руководство пользователя
Импортируйте сразу много зон, загрузив CSV-файл. Каждая строка становится зоной вашей компании, а её граница задаётся полигоном в формате WKT. Это самый быстрый способ загрузить границы, которые уже есть в ГИС-инструменте (QGIS, ArcGIS, PostGIS, Google Earth).
⚠️ Сначала долгота! В WKT каждая точка записывается как долгота широта (X, затем Y) — это противоположно порядку «широта, долгота», который показывает Google Maps. Файл с перепутанными координатами импортируется успешно, но помещает все зоны не в ту часть мира. Всегда указывайте долготу первой.
ℹ️ Подписка: импорт зон доступен на тарифах Silver или Gold (уровень 2+). На тарифе Basic действие видно, но предлагает перейти на более высокий тариф. Также нужна роль Менеджер или Администратор.
Как импортировать
- Откройте список Зоны и нажмите меню (⋮) → Импорт из CSV.
- Нажмите Скачать шаблон, чтобы получить готовый файл
geozone-import-template.csv с правильными заголовками и примерами строк.
- Заполните строки в табличном редакторе и сохраните/экспортируйте как CSV.
- Нажмите Загрузить CSV-файл и выберите файл.
- Импорт выполняется в фоне. По завершении вы увидите, сколько зон создано, а также список пропущенных строк с причинами.
💡 Совет: экспортируйте столбец геометрии прямо из ГИС-инструмента в формате WKT — QGIS, ArcGIS и PostGIS выдают WKT с долготой первой, поэтому его можно вставить без правок.
Требования к файлу
- Кодировка: UTF-8 (с BOM или без)
- Разделитель: запятая (
,)
- Кавычки: заключайте поля с запятыми (например, ячейку геометрии) в двойные кавычки (RFC 4180)
- Максимальный размер файла: 2 МБ
- Максимум строк: 500 строк данных (без учёта заголовка)
- Обязательные заголовки: файл должен содержать столбцы
Title и Geometry
Столбцы
Имена столбцов сопоставляются без учёта регистра, начальные и конечные пробелы обрезаются, нераспознанные столбцы игнорируются. Оставляйте имена столбцов на английском точно как ниже.
| Столбец |
Обязателен |
Макс. длина |
Допустимые значения |
Title | Да | 500 | Обычный текст |
Description | Нет | 5000 | Обычный текст |
Color | Нет | — | HEX-цвет, напр. #4CAF50 (или #RRGGBBAA) |
Icon | Нет | 50 | Ключ значка (для неизвестных ключей показывается значок по умолчанию) |
Owner | Нет | — | Имя пользователя активного участника компании |
BufferMeters | Нет | — | Целое число 0–300 (буфер присутствия GPS) |
Geometry | Да | — | WKT POLYGON((lng lat, lng lat, ...)), долгота первой, замкнутое кольцо |
Столбец геометрии
- Используйте форму WKT
POLYGON((lng lat, lng lat, ...)) — каждая точка это долгота, затем широта через пробел; точки разделяются запятыми.
- Кольцо должно быть замкнутым: последняя точка должна совпадать с первой. Незамкнутое кольцо отклоняется.
- Требуется не менее 3 различных точек.
- Долгота должна быть в диапазоне от -180 до 180, широта — от -90 до 90.
- Полигон должен быть корректным — без самопересечений и с ненулевой площадью.
- Поддерживается только
POLYGON (не POINT, LINESTRING или MULTIPOLYGON).
Значения по умолчанию
- Color: цвет зоны по умолчанию (если не указан или пуст)
- Icon: отсутствует (если не указан или пуст)
- Owner: импортирующий пользователь (если не указан)
- BufferMeters: 100 (если не указан или пуст)
Импортированные зоны размещаются в центре полигона; адрес остаётся пустым (его можно указать позже). Новые зоны создаются без привязки к проектам и без вложений.
Владелец
- Имя в столбце Owner сопоставляется без учёта регистра с активными участниками компании (люди и ИИ-агенты).
- Если имя не найдено, эта строка пропускается, а причина сообщается.
- Оставьте поле пустым, чтобы владельцем стали вы.
Проверка и частичный успех
- Каждая строка проверяется отдельно. Корректные строки импортируются, даже если другие содержат ошибки — одна плохая строка не блокирует остальные.
- По завершении вы получаете число созданных зон и список пропущенных строк с номером строки и причиной.
- Импорт полностью не выполняется только если все строки некорректны.
⚠️ Ограничения частоты: не более 3 импортов зон на компанию в час и 10 импортов на компанию в час по всем типам импорта. При превышении импорт отклоняется с указанием времени до следующей попытки.
Пример CSV
Title,Description,Color,Icon,Owner,BufferMeters,Geometry
"North Yard","Staging & storage","#4CAF50",warehouse,john.doe,100,"POLYGON((23.31 42.69, 23.32 42.69, 23.32 42.70, 23.31 42.70, 23.31 42.69))"
"Wellpad 7","","#F44336",,,150,"POLYGON((23.35 42.71, 23.36 42.71, 23.355 42.72, 23.35 42.71))"
В первой строке используются все необязательные столбцы; во второй Description, Icon и Owner оставлены пустыми (используются значения по умолчанию). Обе ячейки геометрии — с долготой первой и замкнутым кольцом.
Вложения
CSV содержит только текст и не может нести файлы или изображения. Чтобы прикрепить файлы к импортированной зоне, откройте её после импорта и добавьте вложения через обычный редактор зоны.
← Назад к руководству