Растровые слои

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

DG.TileLayer

Используется для загрузки и отображения тайловых слоев на карте. Расширяет GridLayer.

Пример использования

DG.tileLayer('http://{s}.tile.osm.org/{z}/{x}/{y}.png?{foo}', {foo: 'bar'}).addTo(map);
Шаблон URL

Строка, представленная в следующем виде:

'http://{s}.somedomain.com/blabla/{z}/{x}/{y}{r}.png'

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

DG.tileLayer('http://{s}.somedomain.com/{foo}/{z}/{x}/{y}.png', {foo: 'bar'});

Создание

Конструктор Описание
DG.tilelayer( <String> urlTemplate, options) Создает экземпляр объекта тайлового слоя с данным шаблоном URL и необязательным объектом опций.

Опции

Опция Тип По умолчанию Описание
minZoom Number 0 Минимальный уровень масштаба.
maxZoom Number 18 Максимальный уровень масштаба.
maxNativeZoom Number null Максимальный уровень масштаба, который есть у тайлов. Если этот параметр установлен, тайлы всех уровней увеличения, выше чем maxNativeZoom, будут загружены из уровня maxNativeZoom и автоматически отмасштабированы.
subdomains String|String[] 'abc' Под-домены тайловой службы. Могут быть переданы в форме строки (где каждая буква, это имя под-домена) или в форме массива строк.
errorTileUrl String '' URL на тайл изображения, который надо показывать, если загрузка тайла не удалась.
zoomOffset Number 0 Уровень масштаба, который используется в URL тайлов, будет скорректирован с учетом данного смещения.
tms Boolean false Если true, инвертирует ось Y нумерации тайлов (включите эту опцию для TMS сервисов).
zoomReverse Boolean false Если true, уровень масштаба используемый в URL тайлов будет инвертировано (maxZoom - zoom вместо zoom)
detectRetina Boolean false Если true и пользователь использует retina дисплей, тогда будет запрошено четыре тайла вместо одного. Эти тайлы будут в два раза меньше стандартного размера и на один уровень масштабирования больше, для того чтобы адаптироваться под более высокую плотность пикселей.
crossOrigin Boolean false Если true, у всех тайлов атрибут crossOrigin будет установлен в ''. Это необходимое условие, если вы хотите получить доступ к исходным тайлам на уровне пикселей.

Опции, унаследованные от GridLayer

События

События, унаследованные от GridLayer

События, унаследованные от Layer

События попапа, унаследованные от Layer

Методы

Метод Возвращает Описание
setUrl( <String> url <Boolean> noRedraw?) this Обновляет URL шаблон слоя и перерисовывает его (если параметр noRedraw не установлен в true).
createTile( <Object> coords, <Function> done?) HTMLElement Вызывается только внутри библиотеки. Перегружает метод createTile() класса GridLayer. Метод возвращает HTML-элемент <img> с соответствующим изображением по переданному аргументу coords. Функция обратного вызова done будет вызван, когда тайл будет загружен.
Методы расширения

Слои, расширяющие TileLayer, могут реализовать следующий метод:

Метод Возвращает Описание
getTileUrl(<Object> coords) String Вызывается только внутри библиотеки, возвращает URL для тайла, расположенного по переданным координатам. Классы, расширяющие TileLayer, могут перегружать эту функцию, для того чтобы предоставить собственные схемы именования URL тайлов.

Методы, унаследованные от GridLayer GridLayer

Методы попапа, унаследованные от Layer

Методы, унаследованные от Layer

Методы, унаследованные от Evented

DG.TileLayer.wms

Используется для отображения WMS сервисов как тайловых слоев на карте. Расширяет TileLayer.

Пример использования

var nexrad = DG.tileLayer.wms("http://mesonet.agron.iastate.edu/cgi-bin/wms/nexrad/n0r.cgi", {
    layers: 'nexrad-n0r-900913',
    format: 'image/png',
    transparent: true,
    attribution: "Погодные данные © 2012 IEM Nexrad"
});

Создание

Конструктор Описание
DG.tileLayer.wms( <String> baseUrl, <TileLayer.WMS options> options) Создает экземпляр объекта WMS тайлового слоя по переданному URL WMS-сервиса и объекту WMS-опций.

Опции

Опция Тип По умолчанию Описание
layers String '' (требуется) Разделенный запятыми список WMS-слоев для отображения.
styles String '' Разделенный запятыми список WMS-стилей.
format String 'image/jpeg' Формат изображений WMS (используйте 'image/png' для слоев с прозрачностью).
transparent Boolean false Если true, WMS-сервис вернет изображения с прозрачностью.
version String '1.1.1' Версия WMS сервиса, которую следует использовать
crs CRS null Система координат (CRS), котрую следует использовать при WMS-запросах, по умолчанию установлена в CRS карты. Не изменяйте эту настройку, если вы не уверены в том, что она означает.
uppercase Boolean false Если true, ключи параетров WMS запросов будут переведены в верхний регистр.

Опции, унаследованные от TileLayer

Опции, унаследованные от GridLayer

События

События, унаследованные от GridLayer

События, унаследованные от Layer

События попапа, унаследованные от Layer

Методы

Метод Возвращает Описание
setParams( <Object> params, <Boolean> noRedraw?) this Расширяет объект новыми параметрами и заново запрашивает тайлы для текущего экрана (если noRedraw не был установлен в true).

Методы, унаследованные от TileLayer TileLayer

Методы, унаследованные от GridLayer GridLayer

Методы попапа, унаследованные от Layer

Методы, унаследованные от Layer

Методы, унаследованные от Evented

DG.ImageOverlay

Используется для загрузки и отображения указанного изображения в определенной области карты. Расширяет Layer.

Пример использования

var imageUrl = 'http://www.lib.utexas.edu/maps/historical/newark_nj_1922.jpg',
    imageBounds = [[40.712216, -74.22655], [40.773941, -74.12544]];
DG.imageOverlay(imageUrl, imageBounds).addTo(map);

Создание

Конструктор Описание
DG.imageOverlay( <String> imageUrl, <LatLngBounds> bounds, <ImageOverlay options> options?) Создает экземпляр слоя с изображением по переданному URL изображения и географическим координатам, к которым оно привязано.

Опции

Опция Тип По умолчанию Описание
opacity Number 1.0 Прозрачность слоя с изображением.
alt String '' Текст для атрибута alt изобаржения.
interactive Boolean false Если true, слой изображения будет генерировать события мыши при кликах или наведении курсора.
crossOrigin Boolean false Если true, атрибут изображения crossOrigin будет установлен в ''. Это необходимое условие, если вы хотите получить доступ к изображению на уровне пикселей.

Оцпии, унаследованные от Layer

События

События, унаследованные от Layer

События попапа, унаследованные от Layer

Методы

Метод Возвращает Описание
setOpacity() this Устанавливает прозрачность слоя.
bringToFront() this Перемещает слой выше других слоев.
bringToBack() this Перемещает слой ниже других слоев.
setUrl(<String> url) this Изменяет URL изображения.

Методы попапа, унаследованные от Layer

Методы, унаследованные от Layer

Методы, унаследованные от Evented