Source
Интерфейс Source должен быть реализован каждым типом источника, включая «базовые» типы (vector, raster, video и т. д.) и все пользовательские сторонние типы.
Событие data — генерируется с {dataType: 'source', sourceDataType: 'metadata'}, чтобы указать, что все необходимые метаданные загружены и можно вызывать loadTile; и с {dataType: 'source', sourceDataType: 'content'}, чтобы указать, что данные источника изменились и все текущие кэши должны быть очищены.
Методы
abortTile()?
optionalabortTile(tile:Tile):Promise<void>
Позволяет прервать загрузку тайла.
Параметры
| Параметр | Тип | Описание |
|---|---|---|
tile | Tile | Прерываемый тайл |
Возвращает
Promise<void>
fire()
fire(
event:Event):unknown
Возможность инициировать событие для всех слушателей, см. Evented
Параметры
| Параметр | Тип | Описание |
|---|---|---|
event | Event | Инициируемое событие |
Возвращает
unknown
hasTile()?
optionalhasTile(tileID:OverscaledTileID):boolean
True, если тайл является частью источника, иначе false.
Параметры
| Параметр | Тип | Описание |
|---|---|---|
tileID | OverscaledTileID | Идентификатор тайла |
Возвращает
boolean
hasTransition()
hasTransition():
boolean
True, если у источника есть переход, иначе false.
Возвращает
boolean
loaded()
loaded():
boolean
True, если источник загружен, иначе false.
Возвращает
boolean
loadTile()
loadTile(
tile:Tile):Promise<void|LoadTileResult>
Этот метод выполняет основную работу по загрузке тайла. В большинстве случаев он делегирует работу соответствующему источнику в воркере.
Параметры
| Параметр | Тип | Описание |
|---|---|---|
tile | Tile | Загружаемый тайл |
Возвращает
Promise<void | LoadTileResult>
onAdd()?
optionalonAdd(map:Map):void
Этот метод вызывается при добавлении источника на карту.
Параметры
| Параметр | Тип | Описание |
|---|---|---|
map | Map | Экземпляр карты |
Возвращает
void
onRemove()?
optionalonRemove(map:Map):void
Этот метод вызывается при удалении источника с карты.
Параметры
| Параметр | Тип | Описание |
|---|---|---|
map | Map | Экземпляр карты |
Возвращает
void
prepare()?
optionalprepare():void
Позволяет выполнить этап подготовки перед использованием источника.
Возвращает
void
serialize()
serialize():
any
Возвращает
any
Простой (сериализуемый в строку) JS-объект, представляющий текущее состояние источника. Создание источника с использованием возвращенного объекта в качестве options должно приводить к созданию Source, эквивалентного данному.
unloadTile()?
optionalunloadTile(tile:Tile):Promise<void>
Позволяет выгрузить тайл.
Параметры
| Параметр | Тип | Описание |
|---|---|---|
tile | Tile | Выгружаемый тайл |
Возвращает
Promise<void>
Свойства
attribution?
optionalattribution?:string
Атрибуция источника.
calculateTileZoom?
optionalcalculateTileZoom?:CalculateTileZoomFunction
Необязательная функция для переопределения способа загрузки тайлов при больших углах наклона.
id
id:
string
Идентификатор источника. Не должен использоваться ни одним из существующих источников.
isTileClipped?
optionalisTileClipped?:boolean
false, если тайлы могут быть отрисованы за пределами их границ, true, если нет.
maxzoom
maxzoom:
number
Максимальный уровень масштабирования для источника.
minzoom
minzoom:
number
Минимальный уровень масштабирования для источника.
reparseOverscaled?
optionalreparseOverscaled?:boolean
true, если тайлы должны отправляться обратно в воркер для каждого превышенного уровня масштабирования, false, если нет.
roundZoom?
optionalroundZoom?:boolean
true, если уровни масштабирования округляются до ближайшего целого числа в данных источника, false, если они округляются в меньшую сторону до ближайшего целого числа.
tileSize
tileSize:
number
Размер тайла для источника.
© MapLibre contributors
Licensed under the 3-Clause BSD License.
https://maplibre.org/maplibre-gl-js/docs/API/interfaces/Source/