# Module: ol/source/XYZ

This documentation is for OpenLayers v10.9.0. The latest is v.

## ol/source/XYZ

### Classes

XYZ

### Type Definitions

#### Options{Object}

  ##### Properties:

  Name | Type | Description
  --- | --- | ---
  `attributions` | AttributionLike | undefined | Attributions.
  `attributionsCollapsible` | boolean (defaults to true) | Attributions are collapsible.
  `cacheSize` | number | undefined | Deprecated. Use the cacheSize option on the layer instead.
  `crossOrigin` | null | string | undefined | The `crossOrigin` attribute for loaded images. Note that you must provide a `crossOrigin` value if you want to access pixel data with the Canvas renderer. See https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_enabled_image for more detail.
  `referrerPolicy` | ReferrerPolicy | undefined | The `referrerPolicy` property for loaded images.
  `interpolate` | boolean (defaults to true) | Use interpolated values when resampling. By default, linear interpolation is used when resampling. Set to false to use the nearest neighbor instead.
  `projection` | ProjectionLike (defaults to 'EPSG:3857') | Projection.
  `reprojectionErrorThreshold` | number (defaults to 0.5) | Maximum allowed reprojection error (in pixels). Higher values can increase reprojection performance, but decrease precision.
  `maxZoom` | number (defaults to 42) | Optional max zoom level. Not used if `tileGrid` is provided.
  `minZoom` | number (defaults to 0) | Optional min zoom level. Not used if `tileGrid` is provided.
  `maxResolution` | number | undefined | Optional tile grid resolution at level zero. Not used if `tileGrid` is provided.
  `tileGrid` | TileGrid | undefined | Tile grid.
  `tileLoadFunction` | LoadFunction | undefined | Deprecated. Use an ImageTile source with a loader instead. Optional function to load a tile given a URL. The default is
      function(imageTile, src) {
        imageTile.getImage().src = src;
      };
  `tilePixelRatio` | number (defaults to 1) | The pixel ratio used by the tile service. For example, if the tile service advertizes 256px by 256px tiles but actually sends 512px by 512px images (for retina/hidpi devices) then `tilePixelRatio` should be set to `2`.
  `tileSize` | number | Size (defaults to [256, 256]) | The tile size used by the tile service. Not used if `tileGrid` is provided.
  `gutter` | number (defaults to 0) | The size in pixels of the gutter around image tiles to ignore. This allows artifacts of rendering at tile edges to be ignored. Supported images should be wider and taller than the tile size by a value of `2 x gutter`.
  `tileUrlFunction` | UrlFunction | undefined | Deprecated. Use an ImageTile source and provide a function for the url option instead.
  `url` | string | undefined | URL template. Must include `{x}`, `{y}` or `{-y}`, and `{z}` placeholders. A `{?-?}` template pattern, for example `subdomain{a-f}.domain.com`, may be used instead of defining each one separately in the `urls` option.
  `urls` | Array.<string> | undefined | Deprecated. Use an ImageTile source and provide an array of URLs for the url option instead.
  `wrapX` | boolean (defaults to true) | Whether to wrap the world horizontally.
  `transition` | number (defaults to 250) | Duration of the opacity transition for rendering. To disable the opacity transition, pass `transition: 0`.
  `zDirection` | number | NearestDirectionFunction (defaults to 0) | Choose whether to use tiles with a higher or lower zoom level when between integer zoom levels. See `getZForResolution`.