YMaps.TileDataSource

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

Если требуется особое поведение какого-либо метода класса, то этот метод следует переопределить.

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

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

Конструктор

Поля

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

Методы

Имя	Возвращает	Описание
getErrorTileUrl()	String	Возвращает URL картинки для несуществующих или незагрузившихся тайлов.
getTile()	YMaps.ITile	Создает и возвращает экземпляр тайла.
getTileSize()	Integer	Возвращает размер стороны тайла. По умолчанию возвращает 256. Размер стороны тайла должен быть степенью 2.
getTileUrl(tile, zoom)	String	Возвращает URL изображения тайла по заданному номеру тайла и коэффициенту масштабирования.
getTileUrlTemplate()	String	Возвращает текущий шаблон URL тайла.
isTransparent()	Boolean	Возвращает состояние прозрачности тайлов: true - загружаемые изображения тайлов прозрачны, false - нет (по умолчанию).
setTileUrlTemplate(template)		Устанавливает новый шаблон URL тайла.
smoothZoomEnabled()	Boolean	Возвращает состояние возможности плавного масштабирования для тайлов: true - тайлы поддерживают плавное масштабирование (по умолчанию), false - нет.

YMaps.TileDataSource(tileUrlTemplate, isTransparent, smoothZoomEnabled)

Параметры:

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

ERROR_TILE_URL

ERROR_TILE_URL

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

TRANSPARENT_TILE_URL

TRANSPARENT_TILE_URL

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

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

getErrorTileUrl

{String} getErrorTileUrl()

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

Возвращает:

getTile

{YMaps.ITile} getTile()

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

Возвращает:

getTileSize

{Integer} getTileSize()

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

Размер стороны тайла должен быть степенью 2.

Возвращает:

getTileUrl

{String} getTileUrl(tile, zoom)

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

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

Параметры:

Возвращает:

getTileUrlTemplate

{String} getTileUrlTemplate()

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

Возвращает:

isTransparent

{Boolean} isTransparent()

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

Возвращает:

setTileUrlTemplate

setTileUrlTemplate(template)

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

Параметры:

smoothZoomEnabled

{Boolean} smoothZoomEnabled()

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

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

Возвращает: