MapGL JS API | Редактор стилей | 2GIS Documentation
Редактор стилей

Типы слоёв для MapGL JS API

В Редакторе стилей вы можете использовать стилевые слои с разными типами. Каждый тип слоя имеет свой набор настроек и задаёт внешний вид для выбранных групп объектов. В каждом типе доступны разные наборы данных карты, стилем которых вы можете управлять. Например, для слоя с типом Линия доступны разные классы дорог и улиц, а для слоя с типом Полигон — области, кварталы, здания и другие.

Типы слоёв отличаются в зависимости от стиля карты: для MapGL JS API (см. ниже) или мобильного SDK.

В базовом стиле для MapGL JS API есть более 200 готовых слоёв: см. список слоёв. Если вам необходимо добавить на карту объекты, аналогов которых нет в готовых слоях, вы можете создать слой с нужным типом с нуля. В остальных случаях рекомендуется настраивать существующие слои.

Для MapGL JS API доступны следующие типы слоёв:

Как выглядит на карте: многоугольник с цветным фоном и обводкой.

Для каких данных можно использовать:

  • водоёмы: реки, озёра, моря и т. д.;
  • хилшейд;
  • страны с границами;
  • лес на мировой карте;
  • кварталы;
  • территории парковок;
  • и другие.

Типовые настройки: текстура, размер и прозрачность текстуры, цвет заливки, цвет обводки и ширина обводки.

Пример слоя:

Слой с типом Полигон

Как выглядит на карте: широкая линия.

Для каких данных можно использовать:

  • дорожный граф: дороги и улицы разных классов и типов, тоннели и т. д.;
  • транспортный граф: линии маршрутов автобусов, метро и т. д.;
  • мосты;
  • туристические маршруты;
  • границы стран, областей, районов;
  • и другие.

Типовые настройки: цвет заливки, ширина линии и другие параметры.

Пример слоя:

Слой с типом Линия

Как выглядит на карте: многоугольник с цветным фоном и обводкой, вытянутый вверх.

Для каких данных можно использовать:

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

Типовые настройки: цвет заливки граней; цвет и ширина обводки; высота объекта; расстояние до камеры, при котором у объекта появляется прозрачность.

Пример слоя:

Слой с типом Полигон с высотой

Как выглядит на карте: линия с шириной и обводкой, вытянутая вверх.

Для каких данных можно использовать: заборы.

Типовые настройки: цвет заливки граней; цвет и ширина обводки; высота объекта; расстояние до камеры, при котором у объекта появляется прозрачность.

Пример слоя:

Слой с типом Линия с высотой

Как выглядит на карте: иконки объектов в обычном и выделенном состоянии, а также их подписи; подписи для 3D-объектов и географических объектов на мировой карте.

Для каких данных можно использовать:

  • подписи стран, областей, населённых пунктов;
  • подписи водоёмов: озёр, морей, океанов;
  • подписи номеров домов и зданий, подъездов;
  • подписи остановок общественного транспорта, станций и выходов метро;
  • точечные 3D-объекты: качели, горки, зонтики, скамейки и т.д.;
  • светофоры;
  • иконки остановок, станций метро, парковок, фирм, объектов городской инфраструктуры и т. д.;
  • и другие.

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

Пример слоя:

Слой с типом Точка

Как выглядит на карте: текстовая подпись вдоль линии.

Для каких данных можно использовать:

  • подписи дорог и улиц разных классов;
  • подписи рек, каналов;
  • и другие.

Типовые настройки: шрифт, размер шрифта, цвет подписи, межбуквенный интервал и другие параметры.

Пример слоя:

Слой с типом Подпись линии

Как выглядит на карте: широкая пунктирная линия.

Для каких данных можно использовать:

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

Типовые настройки: цвет заливки, ширина линии, длина штриха, цвет пробела и другие параметры.

Пример слоя:

Слой с типом Пунктирная линия

Как выглядит на карте: стрелки, расположенные вдоль линии.

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

Типовые настройки: цвет заливки, ширина линии, длина линии стрелок и другие параметры.

Пример слоя:

Слой с типом Линия из стрелок

Как выглядит на карте: простая трёхмерная модель.

Для каких данных можно использовать:

  • деревья;
  • скамейки;
  • фонарные столбы;
  • собственные трёхмерные модели. Подробнее о добавлении собственных моделей на карту см. в инструкции 3D-модели;
  • и другие.

Типовые настройки: источник модели; цвет заливки; координаты размера, поворота и смещения объекта; расстояние до камеры, при котором у объекта появляется прозрачность, и другие параметры.

Пример слоя:

Слой с типом 3D-модель

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

Для каких данных можно использовать: собственные трёхмерные модели зданий. Подробнее о добавлении собственных моделей на карту см. в инструкции 3D-модели.

Типовые настройки: цвет заливки граней, цвет и ширина обводки; расстояние до камеры, при котором у объекта появляется прозрачность.

Как выглядит на карте: линия, смещённая относительно дорог на карте. Объекты слоя не отображаются в Редакторе стилей.

Для каких данных можно использовать: пробки.

Типовые настройки: цвет заливки, ширина линии и сдвиг линии.

Как выглядит на карте: плоское изображение объектов на карте.

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

Типовые настройки: иконка, цвет заливки, поворот, ширина и высота.

Пример слоя:

Слой с типом Плоское изображение