Как добавлять наборы данных и управлять ими

С помощью наборов данных вы можете загружать геопространственные данные из локального файла или Google Cloud Storage на платформу Google Карт. После этого набор данных можно связать со стилями карт в Cloud Console и использовать API настройки стилей на основе данных, чтобы динамически задавать стили в Google Картах.

Также вы можете загрузить геопространственные данные в набор данных с помощью REST API. Подробную информацию вы найдете в статье Maps Datasets API.

Роли пользователей

Чтобы создавать наборы данных для проекта Google Cloud и управлять ими, у вас должна быть роль владельца или редактора проекта.

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

  • Роль Maps Platform Datasets Admin дает пользовательским и сервисным аккаунтам доступ для чтения и записи к наборам данных проекта. Пользователи с этой ролью могут выполнять все операции с набором данных.
  • Роль Maps Platform Datasets Viewer дает доступ только для чтения к наборам данных проекта. Пользователи с этой ролью могут выполнять с набором данных операции list, get и download.

Подробную информацию вы найдете в статье о том, как назначить роль IAM в Google Cloud Console.

Источник данных для набора

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

  • Если вы загружаете данные из Cloud Storage, укажите путь к файлу на ресурсе Cloud Storage, в котором хранятся данные. Пример пути: gs://GCS_BUCKET/FILE.

    Пользователь, который отправляет запрос, должен иметь роль Storage Object Viewer или любую другую с разрешением storage.objects.get. Подробную информацию об управлении доступом к Cloud Storage вы найдете в статье Контроль доступа.

  • Если вы загружаете данные из локального файла, укажите путь к файлу GeoJSON, KML или CSV, в котором содержатся нужные данные.

Требования

Когда вы создаете набор данных, должны выполняться следующие условия:

  • Отображаемые названия в рамках одного проекта Google Cloud должны быть уникальными.
  • Отображаемые названия должны быть менее 64 байт. Поскольку символы кодируются в UTF-8, на некоторых языках один символ может занимать несколько байтов.
  • Описания должны быть менее 1000 байтов.

Когда вы загружаете набор данных, должны выполняться следующие условия:

  • Поддерживаемые типы файлов: CSV, GeoJSON и KML.
  • Максимальный размер файла: 350 МБ.
  • Названия столбцов атрибутов не могут начинаться со строки "?_".
  • Трехмерная геометрия не поддерживается, в частности суффикс "Z" в формате WKT и координата высоты в формате GeoJSON.

Требования к файлам GeoJSON

Maps JavaScript API поддерживает текущую спецификацию GeoJSON. Также Maps JavaScript API поддерживает файлы GeoJSON, содержащие объекты следующих типов:

  • Геометрические элементы – пространственные фигуры, описанные как сочетание точек, линий и многоугольников с возможными пустыми участками.
  • Объекты – геометрические объекты с дополнительными парами название/значение, которые задаются на уровне приложения.
  • Коллекции объектов – наборы объектов.

Maps JavaScript API не поддерживает файлы GeoJSON с данными в любой системе координат кроме WGS84.

Подробную информацию о GeoJSON вы найдете в статье о совместимости с RFC 7946.

Требования к файлам KML

Для использования с Maps JavaScript API должны соблюдаться следующие требования:

  • Все URL должны быть локальными (или относительными) для файла.
  • Поддерживаются точки, линии и многоугольники.
  • Все атрибуты данных считаются строками.
Следующие функции KML не поддерживаются:
  • Значки или <styleUrl>, определенные не в самом файле.
  • Сетевые ссылки, например <NetworkLink>.
  • Наземные наложения, например <GroundOverlay>.
  • Трехмерная геометрия или любые теги высоты, например <altitudeMode>.
  • Спецификации камеры, например <LookAt>.
  • Стили, определенные в файле KML.

Требования к файлам CSV

Поддерживаемые названия столбцов для файлов CSV в порядке приоритета:

  • latitude, longitude;
  • lat, long;
  • x, y;
  • wkt (Well-Known Text);
  • address, city, state, zip;
  • address
  • один столбец с полным адресом, например 1600 Amphitheatre Parkway Mountain View, CA 94043.

Вот как это работает. Допустим, в файле есть столбцы с названиями x, y и wkt. Поскольку у x и y более высокий приоритет, как показано в списке выше, используются значения из столбцов x и y, а столбец wkt игнорируется.

Дополнительные замечания:

  • Каждое название должно соответствовать отдельному столбцу. Другими словами, нельзя назвать столбец xy и включить в него данные о координатах x и y. Эти координаты должны быть в разных столбцах.
  • В названиях столбцов регистр не учитывается.
  • Порядок названий столбцов не имеет значения, например lat и long могут стоять в любой последовательности.

Ошибки загрузки данных

При загрузке данных в набор могут возникать ошибки.

Ошибки в файлах GeoJSON

Распространенные ошибки в файлах GeoJSON:

  • Отсутствует поле type, или type не является строкой. Загруженный файл GeoJSON должен содержать поле-строку с названием type в определении каждого объекта и геометрического элемента.

Ошибки в файлах KML

Распространенные ошибки в файлах KML:

  • Файл данных не должен содержать перечисленные выше неподдерживаемые функции KML. В противном случае импорт данных может прерваться.

Ошибки в файлах CSV

Распространенные ошибки в файлах CSV:

  • В некоторых строках нет значений в столбце геометрии. Значения в этом столбце не могут быть пустыми. К столбцам геометрии относятся:
    • latitude, longitude;
    • lat, long;
    • x, y;
    • wkt
    • address, city, state, zip;
    • address
    • один столбец с полным адресом, например 1600 Amphitheatre Parkway Mountain View, CA 94043.
  • Если вы используете столбцы геометрии x и y, убедитесь, что в них заданы единицы долготы и широты. В некоторых общедоступных наборах данных в столбцах x и y задается другая система координат. Если в файле используются другие единицы измерения, набор данных может быть импортирован успешно, но обработанные точки будут показываться в неправильных местах.

Как создать набор данных

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

  1. В Google Cloud Console перейдите на страницу Наборы данных.
  2. Нажмите Создать набор данных.
  3. Введите уникальное название набора.
  4. Можно также ввести описание.
  5. Нажмите Продолжить. Откроется страница Импорт данных.
  6. В разделе Источник загрузки для данных набора выберите Компьютер, если вы загружаете локальный файл, или Сегмент Google Cloud Storage.
    • Если вы указали Компьютер, нажмитеОбзор и выберите файл.
    • Если вы указали Сегмент Google Cloud Storage, нажмите Обзор и выберите сегмент и файл с данными.
  7. Выберите формат файла.
  8. Нажмите Продолжить и проверьте настройки.
  9. Нажмите Создать. Откроется страница Наборы данных, на которой будет показан ваш новый набор со статусом Идет настройка.
  10. Подождите, пока статус набора сменится на Завершено.

Как посмотреть или изменить набор данных

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

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

  1. В Google Cloud Console перейдите на страницу Наборы данных.
  2. Нажмите на название набора данных. Откроется страница Сведения о наборе данных.
    1. Нажмите на вкладку Сведения, где можно посмотреть информацию о наборе и изменить его название и описание.
    2. Чтобы посмотреть набор данных на карте, откройте вкладку Предварительный просмотр.
    3. Чтобы посмотреть поднабор данных, связанный с набором, откройте вкладку Данные таблицы.
    4. Чтобы сохранить данные в локальный файл, нажмите Скачать.
    5. Чтобы удалить набор данных, нажмите Удалить.