raster-layers

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

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

DG.TileLayer​

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

Шаблон URL​

Создание​

Опции​

События​

Методы​

Методы расширения​

DG.TileLayer.wms​

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

Создание​

Опции​

События​

Методы​

DG.ImageOverlay​

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

Создание​

Опции​

События​

Методы​

DG.TileLayer

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

Шаблон URL

Создание

Опции

События

Методы

Методы расширения

DG.TileLayer.wms

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

Создание

Опции

События

Методы

DG.ImageOverlay

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

Создание

Опции

События

Методы