Class VectorTile

Classdesc

Class for layer sources providing vector data divided into a tile grid, to be used with module:ol/layer/VectorTileVectorTileLayer. Although this source receives tiles with vector features from the server, it is not meant for feature editing. Features are optimized for rendering, their geometries are clipped at or near tile boundaries and simplified for a view resolution. See module:ol/source/VectorVectorSource for vector sources that are suitable for feature editing.

Fires

import("./Tile.js").TileSourceEvent

Api

Hierarchy (view full)

Constructors

constructor

Properties

disposed loading on once projection tileCache tileClass tileGrid tileLoadFunction tileOptions tmpSize un urls viewRejector viewResolver zDirection

Methods

addChangeListener addEventListener applyProperties canExpireCache changed clear dispatchEvent dispose disposeInternal expireCache forEachLoadedTile get getAttributions getAttributionsCollapsible getFeaturesInExtent getGutterForProjection getInterpolate getKey getKeys getListeners getOpaque getOverlaps getProjection getProperties getPropertiesInternal getResolutions getRevision getSourceTiles getState getTile getTileCacheForProjection getTileCoordForTileUrlFunction getTileGrid getTileGridForProjection getTileLoadFunction getTilePixelRatio getTilePixelSize getTileUrlFunction getUrls getView getWrapX handleTileChange hasListener hasProperties notify onInternal onceInternal refresh removeChangeListener removeEventListener set setAttributions setKey setProperties setState setTileLoadFunction setTileUrlFunction setUrl setUrls tileUrlFunction unInternal unset updateCacheSize useTile

Constructors

constructor

Properties

Protected disposed

disposed: boolean

The object has already been disposed.

loading

loading: boolean

This source is currently loading data. Sources that defer loading to the map's tile queue never set this to true.

on

on: TileSourceOnSignature<EventsKey>

once

once: TileSourceOnSignature<EventsKey>

Protected projection

projection: null | Projection

Protected tileCache

tileCache: TileCache

Protected tileClass

tileClass: typeof external.ol.VectorTile

tileGrid

tileGrid: null | TileGrid

Protected tileLoadFunction

tileLoadFunction: LoadFunction

Protected tileOptions

tileOptions: Options

Protected tmpSize

tmpSize: Size

un

un: TileSourceOnSignature<void>

Protected urls

urls: null | string[]

Protected viewRejector

viewRejector: ((arg0) => void)

Type declaration

    • (arg0): void

    • Parameters

      • arg0: Error

      Returns void

Protected viewResolver

viewResolver: ((arg0) => void)

Type declaration

    • (arg0): void

    • Parameters

      • arg0: ViewOptions

      Returns void

zDirection

zDirection: number | NearestDirectionFunction

zDirection hint, read by the renderer. Indicates which resolution should be used by a renderer if the views resolution does not match any resolution of the tile source. If 0, the nearest resolution will be used. If 1, the nearest lower resolution will be used. If -1, the nearest higher resolution will be used.

Methods

addChangeListener

  • addChangeListener(key, listener): void

  • Parameters

    • key: string

      Key name.

    • listener: Listener

      Listener.

    Returns void

addEventListener

  • addEventListener(type, listener): void

  • Parameters

    • type: string

      Type.

    • listener: Listener

      Listener.

    Returns void

Protected applyProperties

  • applyProperties(source): void
  • Protected

    Apply any properties from another object without triggering events.

    Parameters

    • source: Object

      The source object.

    Returns void

canExpireCache

  • canExpireCache(): boolean

  • Returns boolean

    Can expire cache.

changed

  • changed(): void

  • Increases the revision counter and dispatches a 'change' event.

    Returns void

    Api

clear

  • clear(): void

  • Remove all cached tiles from the source. The next render cycle will fetch new tiles.

    Returns void

    Api

dispatchEvent

  • dispatchEvent(event): undefined | boolean

  • Dispatches an event and calls all listeners listening for events of this type. The event parameter can either be a string or an Object with a type property.

    Parameters

    • event: string | BaseEvent

      Event object.

    Returns undefined | boolean

    false if anyone called preventDefault on the event object or if any of the listeners returned false.

    Api

dispose

  • dispose(): void

  • Clean up.

    Returns void

Protected disposeInternal

  • disposeInternal(): void
  • Protected

    Extension point for disposable objects.

    Returns void

expireCache

  • expireCache(projection, usedTiles): void

  • Parameters

    • projection: Projection

      Projection.

    • usedTiles: {
          [x: string]: boolean;
      }

      Used tiles.

      • [x: string]: boolean

    Returns void

forEachLoadedTile

  • forEachLoadedTile(projection, z, tileRange, callback): boolean

  • Parameters

    • projection: Projection

      Projection.

    • z: number

      Zoom level.

    • tileRange: TileRange

      Tile range.

    • callback: ((arg0) => boolean | void)

      Called with each loaded tile. If the callback returns false, the tile will not be considered loaded.

        • (arg0): boolean | void

        • Parameters

          Returns boolean | void

    Returns boolean

    The tile range is fully covered with loaded tiles.

get

  • get(key): any

  • Gets a value.

    Parameters

    • key: string

      Key name.

    Returns any

    Value.

    Api

getAttributions

  • getAttributions(): null | Attribution

  • Get the attribution function for the source.

    Returns null | Attribution

    Attribution function.

    Api

getAttributionsCollapsible

  • getAttributionsCollapsible(): boolean

  • Returns boolean

    Attributions are collapsible.

    Api

getFeaturesInExtent

  • getFeaturesInExtent(extent): FeatureLike[]

  • Get features whose bounding box intersects the provided extent. Only features for cached tiles for the last rendered zoom level are available in the source. So this method is only suitable for requesting tiles for extents that are currently rendered.

    Features are returned in random tile order and as they are included in the tiles. This means they can be clipped, duplicated across tiles, and simplified to the render resolution.

    Parameters

    • extent: Extent

      Extent.

    Returns FeatureLike[]

    Features.

    Api

getGutterForProjection

  • getGutterForProjection(projection): number

  • Parameters

    • projection: Projection

      Projection.

    Returns number

    Gutter.

getInterpolate

  • getInterpolate(): boolean

  • Returns boolean

    Use linear interpolation when resampling.

getKey

  • getKey(): string

  • Return the key to be used for all tiles in the source.

    Returns string

    The key for all tiles.

getKeys

  • getKeys(): string[]

  • Get a list of object property names.

    Returns string[]

    List of property names.

    Api

getListeners

  • getListeners(type): undefined | Listener[]

  • Get the listeners for a specified event type. Listeners are returned in the order that they will be called in.

    Parameters

    • type: string

      Type.

    Returns undefined | Listener[]

    Listeners.

getOpaque

  • getOpaque(projection): boolean

  • Parameters

    • projection: Projection

      Projection.

    Returns boolean

    Opaque.

getOverlaps

  • getOverlaps(): boolean

  • Returns boolean

    The source can have overlapping geometries.

getProjection

  • getProjection(): null | Projection

  • Get the projection of the source.

    Returns null | Projection

    Projection.

    Api

getProperties

  • getProperties(): {
        [x: string]: any;
    }

  • Get an object of all property names and values.

    Returns {
        [x: string]: any;
    }

    Object.

    • [x: string]: any

    Api

getPropertiesInternal

  • getPropertiesInternal(): null | {
        [x: string]: any;
    }

  • Get an object of all property names and values.

    Returns null | {
        [x: string]: any;
    }

    Object.

getResolutions

  • getResolutions(projection?): null | number[]

  • Parameters

    • Optional projection: Projection

      Projection.

    Returns null | number[]

    Resolutions.

getRevision

  • getRevision(): number

  • Get the version number for this object. Each time the object is modified, its version number will be incremented.

    Returns number

    Revision.

    Api

getSourceTiles

  • getSourceTiles(pixelRatio, projection, tile): external.ol.VectorTile[]

  • Parameters

    • pixelRatio: number

      Pixel ratio.

    • projection: Projection

      Projection.

    • tile: VectorRenderTile

      Vector image tile.

    Returns external.ol.VectorTile[]

    Tile keys.

getState

  • getState(): State

  • Get the state of the source, see import("./Source.js").State for possible states.

    Returns State

    State.

    Api

getTile

  • getTile(z, x, y, pixelRatio, projection): VectorRenderTile

  • Parameters

    • z: number

      Tile coordinate z.

    • x: number

      Tile coordinate x.

    • y: number

      Tile coordinate y.

    • pixelRatio: number

      Pixel ratio.

    • projection: Projection

      Projection.

    Returns VectorRenderTile

    Tile.

Protected getTileCacheForProjection

getTileCoordForTileUrlFunction

  • getTileCoordForTileUrlFunction(tileCoord, projection?): TileCoord

  • Returns a tile coordinate wrapped around the x-axis. When the tile coordinate is outside the resolution and extent range of the tile grid, null will be returned.

    Parameters

    • tileCoord: TileCoord

      Tile coordinate.

    • Optional projection: Projection

      Projection.

    Returns TileCoord

    Tile coordinate to be passed to the tileUrlFunction or null if no tile URL should be created for the passed tileCoord.

getTileGrid

  • getTileGrid(): null | TileGrid

  • Return the tile grid of the tile source.

    Returns null | TileGrid

    Tile grid.

    Api

getTileGridForProjection

  • getTileGridForProjection(projection): TileGrid

  • Parameters

    • projection: Projection

      Projection.

    Returns TileGrid

    Tile grid.

getTileLoadFunction

  • getTileLoadFunction(): LoadFunction

  • Return the tile load function of the source.

    Returns LoadFunction

    TileLoadFunction

    Api

getTilePixelRatio

  • getTilePixelRatio(pixelRatio): number

  • Get the tile pixel ratio for this source. Subclasses may override this method, which is meant to return a supported pixel ratio that matches the provided pixelRatio as close as possible.

    Parameters

    • pixelRatio: number

      Pixel ratio.

    Returns number

    Tile pixel ratio.

getTilePixelSize

  • getTilePixelSize(z, pixelRatio, projection): Size

  • Parameters

    • z: number

      Z.

    • pixelRatio: number

      Pixel ratio.

    • projection: Projection

      Projection.

    Returns Size

    Tile size.

getTileUrlFunction

  • getTileUrlFunction(): UrlFunction

  • Return the tile URL function of the source.

    Returns UrlFunction

    TileUrlFunction

    Api

getUrls

  • getUrls(): null | string[]

  • Return the URLs used for this source. When a tileUrlFunction is used instead of url or urls, null will be returned.

    Returns null | string[]

    URLs.

    Api

getView

  • getView(): Promise<ViewOptions>

  • Returns Promise<ViewOptions>

    A promise for view-related properties.

getWrapX

  • getWrapX(): undefined | boolean

  • Returns undefined | boolean

    Wrap X.

Protected handleTileChange

  • handleTileChange(event): void
  • Protected

    Handle tile change events.

    Parameters

    • event: BaseEvent

      Event.

    Returns void

hasListener

  • hasListener(type?): boolean

  • Parameters

    • Optional type: string

      Type. If not provided, true will be returned if this event target has any listeners.

    Returns boolean

    Has listeners.

hasProperties

  • hasProperties(): boolean

  • Returns boolean

    The object has properties.

notify

  • notify(key, oldValue): void

  • Parameters

    • key: string

      Key name.

    • oldValue: any

      Old value.

    Returns void

Protected onInternal

  • onInternal(type, listener): EventsKey | EventsKey[]
  • Protected

    Parameters

    • type: string | string[]

      Type.

    • listener: ((arg0) => unknown)

      Listener.

        • (arg0): unknown

        • Parameters

          • arg0: Event | BaseEvent

          Returns unknown

    Returns EventsKey | EventsKey[]

    Event key.

Protected onceInternal

  • onceInternal(type, listener): EventsKey | EventsKey[]
  • Protected

    Parameters

    • type: string | string[]

      Type.

    • listener: ((arg0) => unknown)

      Listener.

        • (arg0): unknown

        • Parameters

          • arg0: Event | BaseEvent

          Returns unknown

    Returns EventsKey | EventsKey[]

    Event key.

refresh

  • refresh(): void

  • Refreshes the source. The source will be cleared, and data from the server will be reloaded.

    Returns void

    Api

removeChangeListener

  • removeChangeListener(key, listener): void

  • Parameters

    • key: string

      Key name.

    • listener: Listener

      Listener.

    Returns void

removeEventListener

  • removeEventListener(type, listener): void

  • Parameters

    • type: string

      Type.

    • listener: Listener

      Listener.

    Returns void

set

  • set(key, value, silent?): void

  • Sets a value.

    Parameters

    • key: string

      Key name.

    • value: any

      Value.

    • Optional silent: boolean

      Update without triggering an event.

    Returns void

    Api

setAttributions

  • setAttributions(attributions): void

  • Set the attributions of the source.

    Parameters

    • attributions: undefined | AttributionLike

      Attributions. Can be passed as string, Array<string>, module:ol/source/Source~Attribution, or undefined.

    Returns void

    Api

Protected setKey

  • setKey(key): void
  • Protected

    Set the value to be used as the key for all tiles in the source.

    Parameters

    • key: string

      The key for tiles.

    Returns void

setProperties

  • setProperties(values, silent?): void

  • Sets a collection of key-value pairs. Note that this changes any existing properties and adds new ones (it does not remove any existing properties).

    Parameters

    • values: {
          [x: string]: any;
      }

      Values.

      • [x: string]: any
    • Optional silent: boolean

      Update without triggering an event.

    Returns void

    Api

setState

  • setState(state): void

  • Set the state of the source.

    Parameters

    • state: State

      State.

    Returns void

setTileLoadFunction

  • setTileLoadFunction(tileLoadFunction): void

  • Set the tile load function of the source.

    Parameters

    • tileLoadFunction: LoadFunction

      Tile load function.

    Returns void

    Api

setTileUrlFunction

  • setTileUrlFunction(tileUrlFunction, key?): void

  • Set the tile URL function of the source.

    Parameters

    • tileUrlFunction: UrlFunction

      Tile URL function.

    • Optional key: string

      Optional new tile key for the source.

    Returns void

    Api

setUrl

  • setUrl(url): void

  • Set the URL to use for requests.

    Parameters

    • url: string

      URL.

    Returns void

    Api

setUrls

  • setUrls(urls): void

  • Set the URLs to use for requests.

    Parameters

    • urls: string[]

      URLs.

    Returns void

    Api

tileUrlFunction

  • tileUrlFunction(tileCoord, pixelRatio, projection): undefined | string

  • Parameters

    • tileCoord: TileCoord

      Tile coordinate.

    • pixelRatio: number

      Pixel ratio.

    • projection: Projection

      Projection.

    Returns undefined | string

    Tile URL.

Protected unInternal

  • unInternal(type, listener): void
  • Protected

    Unlisten for a certain type of event.

    Parameters

    • type: string | string[]

      Type.

    • listener: ((arg0) => unknown)

      Listener.

        • (arg0): unknown

        • Parameters

          • arg0: Event | BaseEvent

          Returns unknown

    Returns void

unset

  • unset(key, silent?): void

  • Unsets a property.

    Parameters

    • key: string

      Key name.

    • Optional silent: boolean

      Unset without triggering an event.

    Returns void

    Api

updateCacheSize

  • updateCacheSize(tileCount, projection): void

  • Increases the cache size if needed

    Parameters

    • tileCount: number

      Minimum number of tiles needed.

    • projection: Projection

      Projection.

    Returns void

useTile

  • useTile(z, x, y): void

  • Marks a tile coord as being used, without triggering a load.

    Parameters

    • z: number

      Tile coordinate z.

    • x: number

      Tile coordinate x.

    • y: number

      Tile coordinate y.

    Returns void

Settings

Member Visibility

On This Page

constructordisposedloadingononceprojectiontileCachetileClasstileGridtileLoadFunctiontileOptionstmpSizeunurlsviewRejectorviewResolverzDirectionaddChangeListeneraddEventListenerapplyPropertiescanExpireCachechangedcleardispatchEventdisposedisposeInternalexpireCacheforEachLoadedTilegetgetAttributionsgetAttributionsCollapsiblegetFeaturesInExtentgetGutterForProjectiongetInterpolategetKeygetKeysgetListenersgetOpaquegetOverlapsgetProjectiongetPropertiesgetPropertiesInternalgetResolutionsgetRevisiongetSourceTilesgetStategetTilegetTileCacheForProjectiongetTileCoordForTileUrlFunctiongetTileGridgetTileGridForProjectiongetTileLoadFunctiongetTilePixelRatiogetTilePixelSizegetTileUrlFunctiongetUrlsgetViewgetWrapXhandleTileChangehasListenerhasPropertiesnotifyonInternalonceInternalrefreshremoveChangeListenerremoveEventListenersetsetAttributionssetKeysetPropertiessetStatesetTileLoadFunctionsetTileUrlFunctionsetUrlsetUrlstileUrlFunctionunInternalunsetupdateCacheSizeuseTile