Типы слоёв для MapGL JS API
В Редакторе стилей вы можете использовать стилевые слои с разными типами. Каждый тип слоя имеет свой набор настроек и задаёт внешний вид для выбранных групп объектов. В каждом типе доступны разные наборы данных карты, стилем которых вы можете управлять. Например, для слоя с типом Линия доступны разные классы дорог и улиц, а для слоя с типом Полигон — области, кварталы, здания и другие.
Типы слоёв отличаются в зависимости от стиля карты: для MapGL JS API (см. ниже) или мобильного SDK.
В базовом стиле для MapGL JS API есть более 200 готовых слоёв: см. список слоёв. Если вам необходимо добавить на карту объекты, аналогов которых нет в готовых слоях, вы можете создать слой с нужным типом с нуля. В остальных случаях рекомендуется настраивать существующие слои.
Для MapGL JS API доступны следующие типы слоёв:
- Полигон
- Линия
- Полигон с высотой
- Точка
- Подпись линии
- Пунктирная линия
- Линия из стрелок
- 3D-модель
- 3D-модель здания
- Линия со смещением
- Плоское изображение
Полигон
Как выглядит на карте: многоугольник с цветным фоном и обводкой.
Для каких данных можно использовать:
- водоёмы: реки, озёра, моря и т. д.;
- хилшейд;
- страны с границами;
- лес на мировой карте;
- кварталы;
- территории парковок;
- и другие.
Типовые настройки: текстура, размер и прозрачность текстуры, цвет заливки, цвет обводки и ширина обводки.
Пример слоя:

Линия
Как выглядит на карте: широкая линия.
Для каких данных можно использовать:
- дорожный граф: дороги и улицы разных классов и типов, тоннели и т. д.;
- транспортный граф: линии маршрутов автобусов, метро и т. д.;
- мосты;
- туристические маршруты;
- границы стран, областей, районов;
- и другие.
Типовые настройки: цвет заливки, ширина линии и другие параметры.
Пример слоя:

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

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

Точка
Как выглядит на карте: иконки объектов в обычном и выделенном состоянии, а также их подписи; подписи для 3D-объектов и географических объектов на мировой карте.
Для каких данных можно использовать:
- подписи стран, областей, населённых пунктов;
- подписи водоёмов: озёр, морей, океанов;
- подписи номеров домов и зданий, подъездов;
- подписи остановок общественного транспорта, станций и выходов метро;
- точечные 3D-объекты: качели, горки, зонтики, скамейки и т.д.;
- светофоры;
- иконки остановок, станций метро, парковок, фирм, объектов городской инфраструктуры и т. д.;
- и другие.
Типовые настройки: настройки иконки (иконка, размер иконки, прозрачность и другие), настройки подписи (шрифт, размер шрифта, цвет подписи, межбуквенный интервал и другие), настройки расположения (смещение иконки, расположение подписи, отступ текста от иконки и другие).
Пример слоя:

Подпись линии
Как выглядит на карте: текстовая подпись вдоль линии.
Для каких данных можно использовать:
- подписи дорог и улиц разных классов;
- подписи рек, каналов;
- и другие.
Типовые настройки: шрифт, размер шрифта, цвет подписи, межбуквенный интервал и другие параметры.
Пример слоя:

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

Линия из стрелок
Как выглядит на карте: стрелки, расположенные вдоль линии.
Для каких данных можно использовать: стрелки направления движения на дорогах разных классов.
Типовые настройки: цвет заливки, ширина линии, длина линии стрелок и другие параметры.
Пример слоя:

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

3D-модель здания
Как выглядит на карте: сложная трёхмерная модель, привязанная к конкретному зданию и подменяющая его в карте.
Для каких данных можно использовать: собственные трёхмерные модели зданий. Подробнее о добавлении собственных моделей на карту см. в инструкции 3D-модели.
Типовые настройки: цвет заливки граней, цвет и ширина обводки; расстояние до камеры, при котором у объекта появляется прозрачность.
Линия со смещением
Как выглядит на карте: линия, смещённая относительно дорог на карте. Объекты слоя не отображаются в Редакторе стилей.
Для каких данных можно использовать: пробки.
Типовые настройки: цвет заливки, ширина линии и сдвиг линии.
Плоское изображение
Как выглядит на карте: плоское изображение объектов на карте.
Для каких данных можно использовать: для любых объектов. Вы можете загрузить изображения в формате .svg
и добавить к трёхмерному объекту обозначение в виде плоской иконки: например, добавить стрелки для иммерсивных дорог.
Типовые настройки: иконка, цвет заливки, поворот, ширина и высота.
Пример слоя:
