OpenLayers 3 API Documentation

Class: XYZ

ol.source.XYZ

Layer source for tile data with URLs in a set XYZ format.

new ol.source.XYZ(options) experimental

src/ol/source/xyzsource.js, line 20
Name Type Description
options

XYZ options.

Name Type Description
attributions Array.<ol.Attribution> | undefined optional

Attributions.
crossOrigin null | string | undefined optional

Cross origin setting for image requests.
extent ol.Extent | undefined optional

Extent.
logo string | undefined optional

Logo.
projection ol.proj.ProjectionLike

Projection. Default is EPSG:3857.
maxZoom number | undefined optional

Optional max zoom level. Default is 18.
minZoom number | undefined optional

Unsupported (TODO: remove this).
tileLoadFunction ol.TileLoadFunctionType | undefined optional

Optional function to load a tile given a URL.
tileUrlFunction ol.TileUrlFunctionType | undefined optional

Optional function to get tile URL given a tile coordinate and the projection. Required if url or urls are not provided.
url string | undefined optional

URL template. Must include {x}, {y} or {-y}, and {z} placeholders.
urls Array.<string> | undefined optional

An array of URL templates.
wrapX boolean | undefined optional

Whether to wrap the world horizontally. Default is true.
Fires:
  • change experimental - Triggered when the state of the source changes.

Subclasses

Extends

Methods

dispatchChangeEvent() inherited experimental

src/ol/observable.js, line 41

Dispatches a change event.

Fires:
  • change experimental

getState(){ol.source.State} inherited experimental

src/ol/source/source.js, line 142
Returns:
State.

getTileGrid(){ol.tilegrid.TileGrid} inherited experimental

src/ol/source/tilesource.js, line 167
Returns:
Tile grid.

getTileLoadFunction(){ol.TileLoadFunctionType} inherited experimental

src/ol/source/tileimagesource.js, line 130
Returns:
TileLoadFunction

getTileUrlFunction(){ol.TileUrlFunctionType} inherited experimental

src/ol/source/tileimagesource.js, line 139
Returns:
TileUrlFunction

on(type, listener, opt_this){goog.events.Key} inherited experimental

src/ol/observable.js, line 63

Listen for a certain type of event.

Name Type Description
type string | Array.<string>

The event type or array of event types.
listener function

The listener function.
this Object optional

The object to use as this in listener.
Returns:
Unique key for the listener.

once(type, listener, opt_this){goog.events.Key} inherited experimental

src/ol/observable.js, line 76

Listen once for a certain type of event.

Name Type Description
type string | Array.<string>

The event type or array of event types.
listener function

The listener function.
this Object optional

The object to use as this in listener.
Returns:
Unique key for the listener.

setTileLoadFunction(tileLoadFunction) inherited experimental

src/ol/source/tileimagesource.js, line 148
Name Type Description
tileLoadFunction ol.TileLoadFunctionType

Tile load function.

setTileUrlFunction(tileUrlFunction) inherited experimental

src/ol/source/tileimagesource.js, line 159
Name Type Description
tileUrlFunction ol.TileUrlFunctionType

Tile URL function.

setUrl(url) experimental

src/ol/source/xyzsource.js, line 77
Name Type Description
url string

URL.

un(type, listener, opt_this) inherited experimental

src/ol/observable.js, line 88

Unlisten for a certain type of event.

Name Type Description
type string | Array.<string>

The event type or array of event types.
listener function

The listener function.
this Object optional

The object to use as this in listener.

unByKey(key) inherited experimental

src/ol/observable.js, line 98

Removes an event listener using the key returned by on() or once().

Name Type Description
key goog.events.Key

Key.