YMaps.TileDataSource

Класс для создания источника данных для тайлов определенного типа.

Для задания URL тайла используется шаблон, в котором можно использовать следующие специальные конструкции:

• %d - заменяется на число от 1 до 4, в зависимости от номера тайла. Используется для распределения нагрузки между несколькими доменами.
• %c - заменяется на x=<номер тайла по горизонтали>&y=<номер тайла по вертикали>&z=<коэффициент масштабирования>.
• %g - приписывает к URL строковый параметр переменной длины; эту конструкцию следует использовать в том случае, если URL'ы соседних тайлов имеют одинаковую длину и могут получаться друг из друга перестановкой одного символа; несовершенство кэширующего механизма Firefox в таком случае может приводить к ошибкам, когда один тайл может быть показан вместо другого или вообще отсутствовать.

КонструкторКонструктор

ПоляПоля

Имя	Статическое	Описание
ERROR_TILE_URL		URL изображения-заглушки для непрозрачных тайлов. Используется в качестве errorTileUrl.
TRANSPARENT_TILE_URL		URL полностью прозрачного тайла. Используется в качестве errorTileUrl.

В отличие от непрозрачных тайлов, где при ошибке показывается изображение-заглушка, для прозрачных тайлов, в случае ошибки, показывается полностью прозрачное изображение.

МетодыМетоды

Подробное описание конструктораПодробное описание конструктора

YMaps.TileDataSource(tileUrlTemplate, isTransparent, smoothZoomEnabled)

Создает источник данных для тайлов определенного типа.

Параметры:

Имя	Тип	Необязательный	По умолчанию	Описание
tileUrlTemplate	String			Шаблон, по которому строится URL тайла.
isTransparent	Boolean		false	true - загружаемые тайлы прозрачны, false - непрозрачны.
smoothZoomEnabled	Boolean		true	true - загружаемые тайлы поддерживают плавное масштабирование, false - нет.

Подробное описание полейПодробное описание полей

ERROR_TILE_URLERROR_TILE_URL

ERROR_TILE_URL

URL изображения-заглушки для непрозрачных тайлов. Используется в качестве errorTileUrl. Если для какого-либо участка местности отсутствует непрозрачный тайл, по умолчанию показывается изображение-заглушка "Для данного участка местности нет данных".

TRANSPARENT_TILE_URLTRANSPARENT_TILE_URL

TRANSPARENT_TILE_URL

URL полностью прозрачного тайла. Используется в качестве errorTileUrl.

В отличие от непрозрачных тайлов, где при ошибке показывается изображение-заглушка, для прозрачных тайлов, в случае ошибки, показывается полностью прозрачное изображение.

Подробное описание методовПодробное описание методов

getErrorTileUrlgetErrorTileUrl

{String} getErrorTileUrl()

Возвращает URL картинки для несуществующих или незагрузившихся тайлов.

Возвращает:

getTilegetTile

{YMaps.ITile} getTile()

Создает и возвращает экземпляр тайла.

Возвращает:

getTileSizegetTileSize

{Integer} getTileSize()

Возвращает размер стороны тайла. По умолчанию возвращает 256.

Возвращает:

getTileUrlgetTileUrl

{String} getTileUrl(tile, zoom)

Возвращает URL изображения тайла по заданному номеру тайла и коэффициенту масштабирования.

URL тайла формируется, используя шаблон, установленный в конструкторе или через метод setTileUrlTemplate.

Параметры:

Возвращает:

getTileUrlTemplategetTileUrlTemplate

{String} getTileUrlTemplate()

Возвращает текущий шаблон URL тайла.

Возвращает:

isTransparentisTransparent

{Boolean} isTransparent()

Возвращает состояние прозрачности тайлов: true - загружаемые изображения тайлов прозрачны, false - нет (по умолчанию).

Возвращает:

setTileUrlTemplatesetTileUrlTemplate

setTileUrlTemplate(template)

Устанавливает новый шаблон URL тайла.

Параметры:

smoothZoomEnabledsmoothZoomEnabled

{Boolean} smoothZoomEnabled()

Возвращает состояние возможности плавного масштабирования для тайлов: true - тайлы поддерживают плавное масштабирование (по умолчанию), false - нет.

Если тайлы не умеют растягиваться (false), то соответствующий слой будет скрыт на время плавного масштабирования.

Возвращает: