Операции с наборами данных

После загрузки собственных наборов данных вы можете выполнять с ними различные операции. Доступные операции зависят от способа загрузки данных: в виде файла или по API.

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

Наборы, загруженные как файл

В интерфейсе 2ГИС Про вы можете управлять только наборами данных, которые вы загрузили как файл:

• обновлять наборы данных;
• переименовывать наборы данных;
• добавлять и изменять описания наборов данных;
• создавать фильтры по территории и удалять их;
• добавлять объекты в виде точек в набор данных или удалять их;
• управлять доступом к наборам данных;
• экспортировать данные из наборов;
• удалять наборы данных (доступно также для наборов данных, загруженных по API).

Для работы с набором данных перейдите на вкладку Главная и нажмите Все данные или перейдите на вкладку Данные.

Обновление набора данных

Важно

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

1. Перейдите на вкладку Данные.
2. В карточке нужного набора данных нажмите значок и выберите Обновить набор данных.
3. Перетащите файл в область загрузки или нажмите Выберите файл на компьютере. Формат и структура данных (атрибуты, типы и названия полей) загружаемого файла должны соответствовать исходному файлу.
4. Нажмите Обновить.
5. После завершения загрузки нажмите Далее.
6. (Опционально) Если загруженные данные содержат геометрии в виде полигонов, отметьте чекбокс Создать фильтр по территории, чтобы создать фильтр по территориям.
7. Нажмите Продолжить.

Во всех слоях и виджетах, которые были созданы из этого набора данных, автоматически отразятся изменения.

Переименование набора данных

1. Перейдите на вкладку Данные.
2. В карточке нужного набора данных нажмите значок и выберите Редактировать.
3. Введите новое имя набора данных (не более 100 символов).
4. Нажмите Применить.

Изменение описания набора данных

1. Перейдите на вкладку Данные.
2. В карточке нужного набора данных нажмите значок и выберите Редактировать.
3. В поле Описание введите текст (не более 200 символов).
4. Нажмите Применить.

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

Создание фильтра по территории

Если загруженные данные содержат геометрии в виде полигонов, вы можете использовать их для создания собственного территориального деления. Таким образом вы создадите новые фильтры по территориям (геофильтры) и сможете фильтровать любые данные в 2ГИС Про не только по стандартным видам территорий (области, районы, населённые пункты и другие), но и по вашим уникальным зонам.

1. Перейдите на вкладку Данные.
2. В карточке нужного набора данных нажмите значок и выберите Создать фильтр по территории.

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

Удаление фильтра по территории

1. Перейдите на вкладку Данные.
2. В карточке нужного набора данных нажмите значок и выберите Удалить фильтр по территории.
3. Чтобы подтвердить удаление, нажмите Удалить.

Добавление точечных объектов

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

Важно

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

Вы можете добавить и удалить объекты как при создании слоя, так и после создания.

1. Чтобы изменить набор данных при создании слоя:

   1. Перейдите на вкладку Главная или Данные.
   2. Выберите нужный набор загруженных данных.
   3. В окне Настройки геофильтров выберите до 50 территорий, для которых будет создана выборка данных. Вы можете использовать стандартные и собственные территории, а также строить полигоны, зоны доступности и окружности на карте. Подробнее см. в разделе Геофильтры. После выбора территорий нажмите Готово.

2. Чтобы изменить набор данных после создания слоя:

   1. Перейдите на вкладку Дашборды.

   2. Откройте нужный дашборд.

   3. Откройте сцену с помощью стрелок и . Если в дашборде только одна сцена, она откроется автоматически при открытии дашборда.

   4. В верхнем меню дашборда нажмите значок и выберите нужный слой.

   5. Нажмите Редактировать выборку.

      

3. Чтобы добавить объект:

   1. Перейдите в раздел Результаты и нажмите Добавить объект.

      

   2. Укажите атрибуты данных.

      

      Обязательные поля:

      • Название: укажите, если загруженные данные содержат атрибуты такого типа.
      • Местоположение: укажите координаты вручную или переставьте значок в нужное место на карте.

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

   3. Нажмите Сохранить.

4. Чтобы удалить объект:

   1. Перейдите в раздел Результаты и выберите нужный объект.
   2. Нажмите Удалить и подтвердите удаление.

5. Если вы создаёте слой, нажмите Создать слой.

6. Если вы работаете с созданным слоем, нажмите одну из кнопок:

   • Обновить слой: все изменения будут сохранены, и слой будет обновлен.
   • Создать слой: будет создан новый слой, который автоматически добавится на текущую сцену дашборда.
   • Назад к слою: изменения не будут сохранены, откроется текущая сцена дашборда.

Управление доступом к набору данных

Вы можете выдать доступ на просмотр или редактирование набора данных другим зарегистрированным пользователям.

В зависимости от уровня доступа, пользователь сможет выполнять разные операции:

• Просмотр: просматривать набор данных и создавать из него выборки.

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

  Если пользователь удалит набор данных, к которому ему выдан доступ, он потеряет доступ к этому набору и связанным слоям. Исходный набор данных и доступы других пользователей останутся без изменений. См. подробнее в разделе Удаление набора данных.

Чтобы выдать доступ к набору данных:

1. Перейдите на вкладку Данные.
2. В карточке нужного набора данных нажмите значок и выберите Поделиться.
3. Введите адрес электронной почты пользователя, которому нужно выдать доступ, и нажмите Добавить.
4. Рядом с адресом пользователя выберите уровень доступа в списке: Просмотр или Редактирование.
5. Нажмите Сохранить.
6. Если необходимо отозвать доступ у пользователя, рядом с его адресом выберите в списке Удалить.

Наборы данных, к которым выдан доступ, находятся в профиле получателя на вкладке Данные в группе наборов Мои данные. У таких наборов в карточке указан тег В общем доступе и электронная почта пользователя, который выдал доступ. При необходимости вы можете перенести набор в другую группу.

Экспорт данных

Если вы владелец набора данных (вы ранее загрузили файл с данными) или вам выдан доступ на редактирование набора данных, вы можете экспортировать данные из набора в формате .csv. В выгрузку попадают только данные из выборки.

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

Чтобы экспортировать данные:

1. Перейдите на вкладку Главная или Данные.
2. Выберите нужный набор загруженных данных.
3. В окне Настройки геофильтров выберите до 50 территорий, для которых будет создана выборка данных. Вы можете использовать стандартные и собственные территории, а также строить полигоны, зоны доступности и окружности на карте. Подробнее см. в разделе Геофильтры. После выбора территорий нажмите Готово.
4. При необходимости примените к данным фильтры по параметрам или измените результаты фильтрации вручную: см. инструкцию Изменение выборки данных.
5. Нажмите значок .
6. Отметьте чекбоксы напротив нужных строк, чтобы атрибуты попали в итоговую выгрузку.
7. Проверьте результат в режиме предпросмотра. В таблице будет показано только 10 первых строк.
8. Нажмите Экспорт.

Удаление набора данных

Важно

При удалении набора данных все связанные с ним слои и фильтры по территориям удалятся без возможности восстановления.

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

1. Перейдите на вкладку Данные.
2. В карточке нужного набора данных нажмите значок и выберите Удалить.
3. Чтобы подтвердить удаление, нажмите Удалить.

Наборы, загруженные по API

Через API вы можете управлять только наборами данных, которые вы загрузили через API:

• загружать новые порции данных в наборы после их создания;
• получать параметры наборов данных;
• изменять параметры наборов данных;
• управлять доступом к наборам данных;
• экспортировать данные из наборов;
• удалять несколько объектов из набора данных;
• удалять все объекты из набора данных.

Вы можете удалить набор данных, загруженный через API, только в интерфейсе 2ГИС.

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

• ID набора данных (assetId). Также вы можете скопировать его в 2ГИС Про: перейдите на вкладку Данные, в карточке нужного набора данных нажмите значок и выберите Скопировать ID.
• Токен доступа для авторизации (access_token). Также вы можете скопировать его в 2ГИС Про: нажмите значок в левом нижнем углу, перейдите в раздел Токены и скопируйте значение в поле Токен для работы с динамическими наборами данных.

Получение параметров набора данных

Отправьте GET-запрос к /dynamic_asset с указанием ID набора данных (параметр assetId):

https://pro-api.2gis.ru/dynamic_asset/{assetId}

Подробную информацию о структуре тела ответа см. в Справочнике API.

Изменение параметров набора данных

Важно

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

1. Отправьте PUT-запрос к /dynamic_asset:

   https://pro-api.2gis.ru/dynamic_asset

2. В теле запроса передайте ID набора данных (параметр assetId), название набора данных, а также параметры, которые необходимо изменить, в формате JSON.

   Полный список параметров см. в Справочнике API.

Управление доступом к набору данных

Вы можете выдать доступ на просмотр или редактирование набора данных другим зарегистрированными пользователям.

В зависимости от уровня доступа, пользователь сможет выполнять разные операции:

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

• Редактирование: просматривать набор данных; создавать из него выборки; получать и изменять параметры набора; удалять объекты из набора (все или несколько); выдавать, редактировать и удалять доступ к набору для других пользователей; экспортировать набор. При редактировании набора изменения будут отображаться как у владельца, так и у всех пользователей, которым выдан доступ.

  Если пользователь удалит набор данных, к которому ему выдан доступ, он потеряет доступ к этому набору и связанным слоям. Исходный набор данных и доступы других пользователей останутся без изменений. См. подробнее в разделе Удаление набора данных.

Чтобы выдать доступ к набору данных:

1. Перейдите на вкладку Данные.
2. В карточке нужного набора данных нажмите значок и выберите Поделиться.
3. Введите адрес электронной почты пользователя, которому нужно выдать доступ, и нажмите Добавить.
4. Рядом с адресом пользователя выберите уровень доступа в списке: Просмотр или Редактирование.
5. Нажмите Сохранить.
6. Если необходимо отозвать доступ у пользователя, рядом с его адресом выберите в списке Удалить.

Наборы данных, к которым выдан доступ, находятся в профиле получателя на вкладке Данные в группе наборов Мои данные. У таких наборов в карточке указан тег В общем доступе и электронная почта пользователя, который выдал доступ. При необходимости вы можете перенести набор в другую группу.

Экспорт данных

Если вы владелец набора данных (вы ранее загрузили данные по API) или вам выдан доступ на редактирование набора данных, вы можете экспортировать данные из набора в формате .csv. В выгрузку попадают только данные выборки.

Если вы загрузили новые порции данных в набор после его создания или удалили из него объекты, экспортируются только данные из последней версии набора.

Чтобы экспортировать данные:

1. Перейдите на вкладку Главная или Данные.
2. Выберите нужный набор загруженных данных.
3. В окне Настройки геофильтров выберите до 50 территорий, для которых будет создана выборка данных. Вы можете использовать стандартные и собственные территории, а также строить полигоны, зоны доступности и окружности на карте. Подробнее см. в разделе Геофильтры. После выбора территорий нажмите Готово.
4. При необходимости примените к данным фильтры по параметрам или измените результаты фильтрации вручную: см. инструкцию Изменение выборки данных.
5. Нажмите значок .
6. Отметьте чекбоксы напротив нужных строк, чтобы атрибуты попали в итоговую выгрузку.
7. Проверьте результат в режиме предпросмотра. В таблице будет показано только 10 первых строк.
8. Нажмите Экспорт.

Удаление нескольких объектов из набора данных

1. Отправьте DELETE-запрос к /dynamic_asset:

   https://pro-api.2gis.ru/dynamic_asset/{assetId}/data

2. В теле запроса передайте ID набора данных (параметр assetId) и список ID объектов для удаления в формате JSON.

   Более подробную информацию см. в Справочнике API.

Удаление всех объектов из набора данных

Отправьте DELETE-запрос к /dynamic_asset с указанием ID набора данных (параметр assetId):

https://pro-api.2gis.ru/dynamic_asset/{assetId}/data/all

Более подробную информацию см. в Справочнике API.

Удаление набора данных

Важно

При удалении набора данных все связанные с ним слои удалятся без возможности восстановления.

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

1. Перейдите на вкладку Данные.
2. В карточке нужного набора данных нажмите значок и выберите Удалить.
3. Чтобы подтвердить удаление, нажмите Удалить.

Что дальше?

• Посмотрите Операции с группами наборов данных.
• Быстрый старт.
• Узнайте, как работать с Визуализацией данных.
• Узнайте о возможностях Слоёв, Дашбордов, Сцен и Виджетов.
• Познакомьтесь с готовыми Сценариями аналитики.