ol 9.1.1-dev.1715087016979 → 9.1.1-dev.1715102817264

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ol",
-  "version": "9.1.1-dev.1715087016979",
+  "version": "9.1.1-dev.1715102817264",
   "description": "OpenLayers mapping library",
   "keywords": [
     "map",

package/source/OGCMapTile.d.ts

@@ -62,6 +62,11 @@ export type Options = {
      * To disable the opacity transition, pass `transition: 0`.
      */
     transition?: number | undefined;
+    /**
+     * A list of geospatial data sub-resources to include. If not provided, the entire dataset will
+     * be included. This option is not applicable when requesting the tileset for a single collection.
+     */
+    collections?: string[] | undefined;
 };
 /**
  * @typedef {Object} Options
@@ -91,12 +96,16 @@ export type Options = {
  * @property {boolean} [wrapX=true] Whether to wrap the world horizontally.
  * @property {number} [transition] Duration of the opacity transition for rendering.
  * To disable the opacity transition, pass `transition: 0`.
+ * @property {Array<string>} [collections] A list of geospatial data sub-resources to include. If not provided, the entire dataset will
+ * be included. This option is not applicable when requesting the tileset for a single collection.
  */
 /**
  * @classdesc
  * Layer source for map tiles from an [OGC API - Tiles](https://ogcapi.ogc.org/tiles/) service that provides "map" type tiles.
  * The service must conform to at least the core (http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/core)
- * and tileset (http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/tileset) conformance classes.
+ * and tileset (http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/tileset) conformance classes. For supporting the `collections`
+ * option, the service must conform to the collections selection
+ * (http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/collections-selection) conformance class.
  * @api
  */
 declare class OGCMapTile extends TileImage {

package/source/OGCMapTile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OGCMapTile.d.ts","sourceRoot":"","sources":["OGCMapTile.js"],"names":[],"mappings":";;;;;SASc,MAAM;;;;;;;;;;;;;;;;iBAKN,OAAO,YAAY,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAPjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH;;;;;;GAMG;AACH;IACE;;OAEG;IACH,qBAFW,OAAO,EA0BjB;IAED;;;OAGG;IACH,2BAIC;IAED;;;OAGG;IACH,qBAGC;CACF;sBAzFqB,gBAAgB"}
+{"version":3,"file":"OGCMapTile.d.ts","sourceRoot":"","sources":["OGCMapTile.js"],"names":[],"mappings":";;;;;SASc,MAAM;;;;;;;;;;;;;;;;iBAKN,OAAO,YAAY,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAPjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH;;;;;;;;GAQG;AACH;IACE;;OAEG;IACH,qBAFW,OAAO,EA2BjB;IAED;;;OAGG;IACH,2BAIC;IAED;;;OAGG;IACH,qBAGC;CACF;sBA9FqB,gBAAgB"}

package/source/OGCMapTile.js

@@ -33,13 +33,17 @@ import {error as logError} from '../console.js';
  * @property {boolean} [wrapX=true] Whether to wrap the world horizontally.
  * @property {number} [transition] Duration of the opacity transition for rendering.
  * To disable the opacity transition, pass `transition: 0`.
+ * @property {Array<string>} [collections] A list of geospatial data sub-resources to include. If not provided, the entire dataset will
+ * be included. This option is not applicable when requesting the tileset for a single collection.
  */
 
 /**
  * @classdesc
  * Layer source for map tiles from an [OGC API - Tiles](https://ogcapi.ogc.org/tiles/) service that provides "map" type tiles.
  * The service must conform to at least the core (http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/core)
- * and tileset (http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/tileset) conformance classes.
+ * and tileset (http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/tileset) conformance classes. For supporting the `collections`
+ * option, the service must conform to the collections selection
+ * (http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/collections-selection) conformance class.
  * @api
  */
 class OGCMapTile extends TileImage {
@@ -65,6 +69,7 @@ class OGCMapTile extends TileImage {
       projection: this.getProjection(),
       mediaType: options.mediaType,
       context: options.context || null,
+      collections: options.collections,
     };
 
     getTileSetInfo(sourceInfo)

package/source/OGCVectorTile.d.ts

@@ -63,6 +63,11 @@ export type Options = {
      * zoom levels. See {@link module :ol/tilegrid/TileGrid~TileGrid#getZForResolution}.
      */
     zDirection?: number | import("../array.js").NearestDirectionFunction | undefined;
+    /**
+     * A list of geospatial data sub-resources to include. If not provided, the entire dataset will
+     * be included. This option is not applicable when requesting the tileset for a single collection.
+     */
+    collections?: string[] | undefined;
 };
 /**
  * @typedef {Object} Options
@@ -91,12 +96,16 @@ export type Options = {
  * @property {number|import("../array.js").NearestDirectionFunction} [zDirection=1]
  * Choose whether to use tiles with a higher or lower zoom level when between integer
  * zoom levels. See {@link module:ol/tilegrid/TileGrid~TileGrid#getZForResolution}.
+ * @property {Array<string>} [collections] A list of geospatial data sub-resources to include. If not provided, the entire dataset will
+ * be included. This option is not applicable when requesting the tileset for a single collection.
  */
 /**
  * @classdesc
  * Layer source for map tiles from an [OGC API - Tiles](https://ogcapi.ogc.org/tiles/) service that provides "vector" type tiles.
  * The service must conform to at least the core (http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/core)
- * and tileset (http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/tileset) conformance classes.
+ * and tileset (http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/tileset) conformance classes. For supporting the `collections`
+ * option, the service must conform to the collections selection
+ * (http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/collections-selection) conformance class.
  *
  * Vector tile sets may come in a variety of formats (e.g. GeoJSON, MVT).  The `format` option is used to determine
  * which of the advertised media types is used.  If you need to force the use of a particular media type, you can

package/source/OGCVectorTile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OGCVectorTile.d.ts","sourceRoot":"","sources":["OGCVectorTile.js"],"names":[],"mappings":";;;;;SAUc,MAAM;;;;;;;;;YAGN,OAAO,sBAAsB,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAUtC,OAAO,YAAY,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;;;;;AAfjD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH;;;;;;;;;;GAUG;AACH;IACE;;OAEG;IACH,qBAFW,OAAO,EA4BjB;IAED;;;OAGG;IACH,2BAIC;IAED;;;OAGG;IACH,qBAGC;CACF;6BA9F4B,iBAAiB"}
+{"version":3,"file":"OGCVectorTile.d.ts","sourceRoot":"","sources":["OGCVectorTile.js"],"names":[],"mappings":";;;;;SAUc,MAAM;;;;;;;;;YAGN,OAAO,sBAAsB,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAUtC,OAAO,YAAY,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAfjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH;;;;;;;;;;;;GAYG;AACH;IACE;;OAEG;IACH,qBAFW,OAAO,EA6BjB;IAED;;;OAGG;IACH,2BAIC;IAED;;;OAGG;IACH,qBAGC;CACF;6BAnG4B,iBAAiB"}

package/source/OGCVectorTile.js

@@ -33,13 +33,17 @@ import {error as logError} from '../console.js';
  * @property {number|import("../array.js").NearestDirectionFunction} [zDirection=1]
  * Choose whether to use tiles with a higher or lower zoom level when between integer
  * zoom levels. See {@link module:ol/tilegrid/TileGrid~TileGrid#getZForResolution}.
+ * @property {Array<string>} [collections] A list of geospatial data sub-resources to include. If not provided, the entire dataset will
+ * be included. This option is not applicable when requesting the tileset for a single collection.
  */
 
 /**
  * @classdesc
  * Layer source for map tiles from an [OGC API - Tiles](https://ogcapi.ogc.org/tiles/) service that provides "vector" type tiles.
  * The service must conform to at least the core (http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/core)
- * and tileset (http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/tileset) conformance classes.
+ * and tileset (http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/tileset) conformance classes. For supporting the `collections`
+ * option, the service must conform to the collections selection
+ * (http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/collections-selection) conformance class.
  *
  * Vector tile sets may come in a variety of formats (e.g. GeoJSON, MVT).  The `format` option is used to determine
  * which of the advertised media types is used.  If you need to force the use of a particular media type, you can
@@ -71,6 +75,7 @@ class OGCVectorTile extends VectorTileSource {
       mediaType: options.mediaType,
       supportedMediaTypes: options.format.supportedMediaTypes,
       context: options.context || null,
+      collections: options.collections,
     };
 
     getTileSetInfo(sourceInfo)

package/source/ogcTileUtil.d.ts

@@ -11,20 +11,29 @@
  * @property {Array<string>} [supportedMediaTypes] The supported media types.
  * @property {import("../proj/Projection.js").default} projection The source projection.
  * @property {Object} [context] Optional context for constructing the URL.
+ * @property {Array<string>} [collections] Optional collections to append the URL with.
  */
+/**
+ * @param {string} tileUrlTemplate Tile URL template.
+ * @param {Array<string>} collections List of collections to include as query parameter.
+ * @return {string} The tile URL template with appended collections query parameter.
+ */
+export function appendCollectionsQueryParam(tileUrlTemplate: string, collections: Array<string>): string;
 /**
  * @param {Array<Link>} links Tileset links.
  * @param {string} [mediaType] The preferred media type.
+ * @param {Array<string>} [collections] Optional collections to append the URL with.
  * @return {string} The tile URL template.
  */
-export function getMapTileUrlTemplate(links: Array<Link>, mediaType?: string | undefined): string;
+export function getMapTileUrlTemplate(links: Array<Link>, mediaType?: string | undefined, collections?: string[] | undefined): string;
 /**
  * @param {Array<Link>} links Tileset links.
  * @param {string} [mediaType] The preferred media type.
  * @param {Array<string>} [supportedMediaTypes] The media types supported by the parser.
+ * @param {Array<string>} [collections] Optional collections to append the URL with.
  * @return {string} The tile URL template.
  */
-export function getVectorTileUrlTemplate(links: Array<Link>, mediaType?: string | undefined, supportedMediaTypes?: string[] | undefined): string;
+export function getVectorTileUrlTemplate(links: Array<Link>, mediaType?: string | undefined, supportedMediaTypes?: string[] | undefined, collections?: string[] | undefined): string;
 /**
  * @param {SourceInfo} sourceInfo Source info.
  * @return {Promise<TileSetInfo>} Tile set info.
@@ -65,6 +74,10 @@ export type SourceInfo = {
      * Optional context for constructing the URL.
      */
     context?: any;
+    /**
+     * Optional collections to append the URL with.
+     */
+    collections?: string[] | undefined;
 };
 export type TileType = 'map' | 'vector';
 export type CornerOfOrigin = 'topLeft' | 'bottomLeft';

package/source/ogcTileUtil.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ogcTileUtil.d.ts","sourceRoot":"","sources":["ogcTileUtil.js"],"names":[],"mappings":"AAoFA;;;;;GAKG;AAEH;;;;;;;GAOG;AAEH;;;;GAIG;AACH,6CAJW,MAAM,IAAI,CAAC,mCAEV,MAAM,CA6BjB;AAED;;;;;GAKG;AACH,gDALW,MAAM,IAAI,CAAC,+EAGV,MAAM,CAiDjB;AA2ND;;;GAGG;AACH,2CAHW,UAAU,GACT,QAAQ,WAAW,CAAC,CAM/B;;;;;iBAxUa,MAAM;;;;UACN,OAAO,yBAAyB,EAAE,OAAO;;;;iBACzC,OAAO,YAAY,EAAE,WAAW;;;;;;SAKhC,MAAM;;;;eACN,MAAM;;;;;;;;gBAEN,OAAO,uBAAuB,EAAE,OAAO;;;;;;uBAlFxC,KAAK,GAAG,QAAQ;6BAIhB,SAAS,GAAG,YAAY;;;;;cAKvB,QAAQ;;;;;;;;;;;;;;;;WAIR,MAAM,IAAI,CAAC;;;;;;SAKX,MAAM;;;;UACN,MAAM;;;;UACN,MAAM;;;;;;gBAKN,MAAM;;;;gBACN,MAAM;;;;gBACN,MAAM;;;;gBACN,MAAM;;;;gBACN,MAAM;;;;;;QAKN,MAAM;;;;SACN,MAAM;;;;;;;;kBAEN,MAAM,UAAU,CAAC;;;;;;QAKjB,MAAM;;;;cACN,MAAM;;;;mBACN,MAAM,MAAM,CAAC;;;;;;;;iBAEb,MAAM;;;;kBACN,MAAM;;;;eACN,MAAM;;;;gBACN,MAAM"}
+{"version":3,"file":"ogcTileUtil.d.ts","sourceRoot":"","sources":["ogcTileUtil.js"],"names":[],"mappings":"AAqFA;;;;;GAKG;AAEH;;;;;;;;GAQG;AAEH;;;;GAIG;AACH,6DAJW,MAAM,eACN,MAAM,MAAM,CAAC,GACZ,MAAM,CA6BjB;AAED;;;;;GAKG;AACH,6CALW,MAAM,IAAI,CAAC,uEAGV,MAAM,CAiCjB;AAED;;;;;;GAMG;AACH,gDANW,MAAM,IAAI,CAAC,mHAIV,MAAM,CAsDjB;AA6ND;;;GAGG;AACH,2CAHW,UAAU,GACT,QAAQ,WAAW,CAAC,CAM/B;;;;;iBAxXa,MAAM;;;;UACN,OAAO,yBAAyB,EAAE,OAAO;;;;iBACzC,OAAO,YAAY,EAAE,WAAW;;;;;;SAKhC,MAAM;;;;eACN,MAAM;;;;;;;;gBAEN,OAAO,uBAAuB,EAAE,OAAO;;;;;;;;;;uBAlFxC,KAAK,GAAG,QAAQ;6BAIhB,SAAS,GAAG,YAAY;;;;;cAKvB,QAAQ;;;;;;;;;;;;;;;;WAIR,MAAM,IAAI,CAAC;;;;;;SAKX,MAAM;;;;UACN,MAAM;;;;UACN,MAAM;;;;;;gBAKN,MAAM;;;;gBACN,MAAM;;;;gBACN,MAAM;;;;gBACN,MAAM;;;;gBACN,MAAM;;;;;;QAKN,MAAM;;;;SACN,MAAM;;;;;;;;kBAEN,MAAM,UAAU,CAAC;;;;;;QAKjB,MAAM;;;;cACN,MAAM;;;;mBACN,MAAM,MAAM,CAAC;;;;;;;;iBAEb,MAAM;;;;kBACN,MAAM;;;;eACN,MAAM;;;;gBACN,MAAM"}

package/source/ogcTileUtil.js

@@ -6,6 +6,7 @@ import TileGrid from '../tilegrid/TileGrid.js';
 import {getJSON, resolveUrl} from '../net.js';
 import {get as getProjection} from '../proj.js';
 import {getIntersection as intersectExtents} from '../extent.js';
+import {error as logError} from '../console.js';
 
 /**
  * See https://ogcapi.ogc.org/tiles/.
@@ -96,14 +97,50 @@ const knownVectorMediaTypes = {
  * @property {Array<string>} [supportedMediaTypes] The supported media types.
  * @property {import("../proj/Projection.js").default} projection The source projection.
  * @property {Object} [context] Optional context for constructing the URL.
+ * @property {Array<string>} [collections] Optional collections to append the URL with.
  */
 
+/**
+ * @param {string} tileUrlTemplate Tile URL template.
+ * @param {Array<string>} collections List of collections to include as query parameter.
+ * @return {string} The tile URL template with appended collections query parameter.
+ */
+export function appendCollectionsQueryParam(tileUrlTemplate, collections) {
+  if (!collections.length) {
+    return tileUrlTemplate;
+  }
+
+  // making sure we can always construct a URL instance.
+  const url = new URL(tileUrlTemplate, 'file://');
+
+  if (url.pathname.split('/').includes('collections')) {
+    logError(
+      'The "collections" query parameter cannot be added to collection endpoints',
+    );
+    return tileUrlTemplate;
+  }
+  // According to conformance class
+  // http://www.opengis.net/spec/ogcapi-tiles-1/1.0/conf/collections-selection
+  // commata in the identifiers of the `collections` query parameter
+  // need to be URLEncoded, while the commata separating the identifiers
+  // should not.
+  const encodedCollections = collections
+    .map((c) => encodeURIComponent(c))
+    .join(',');
+
+  url.searchParams.append('collections', encodedCollections);
+  const baseUrl = tileUrlTemplate.split('?')[0];
+  const queryParams = decodeURIComponent(url.searchParams.toString());
+  return `${baseUrl}?${queryParams}`;
+}
+
 /**
  * @param {Array<Link>} links Tileset links.
  * @param {string} [mediaType] The preferred media type.
+ * @param {Array<string>} [collections] Optional collections to append the URL with.
  * @return {string} The tile URL template.
  */
-export function getMapTileUrlTemplate(links, mediaType) {
+export function getMapTileUrlTemplate(links, mediaType, collections) {
   let tileUrlTemplate;
   let fallbackUrlTemplate;
   for (let i = 0; i < links.length; ++i) {
@@ -129,6 +166,10 @@ export function getMapTileUrlTemplate(links, mediaType) {
     }
   }
 
+  if (collections) {
+    tileUrlTemplate = appendCollectionsQueryParam(tileUrlTemplate, collections);
+  }
+
   return tileUrlTemplate;
 }
 
@@ -136,12 +177,14 @@ export function getMapTileUrlTemplate(links, mediaType) {
  * @param {Array<Link>} links Tileset links.
  * @param {string} [mediaType] The preferred media type.
  * @param {Array<string>} [supportedMediaTypes] The media types supported by the parser.
+ * @param {Array<string>} [collections] Optional collections to append the URL with.
  * @return {string} The tile URL template.
  */
 export function getVectorTileUrlTemplate(
   links,
   mediaType,
   supportedMediaTypes,
+  collections,
 ) {
   let tileUrlTemplate;
   let fallbackUrlTemplate;
@@ -184,6 +227,10 @@ export function getVectorTileUrlTemplate(
     }
   }
 
+  if (collections) {
+    tileUrlTemplate = appendCollectionsQueryParam(tileUrlTemplate, collections);
+  }
+
   return tileUrlTemplate;
 }
 
@@ -362,12 +409,14 @@ function parseTileSetMetadata(sourceInfo, tileSet) {
     tileUrlTemplate = getMapTileUrlTemplate(
       tileSet.links,
       sourceInfo.mediaType,
+      sourceInfo.collections,
     );
   } else if (tileSet.dataType === 'vector') {
     tileUrlTemplate = getVectorTileUrlTemplate(
       tileSet.links,
       sourceInfo.mediaType,
       sourceInfo.supportedMediaTypes,
+      sourceInfo.collections,
     );
   } else {
     throw new Error('Expected tileset data type to be "map" or "vector"');

package/util.js

@@ -33,4 +33,4 @@ export function getUid(obj) {
  * OpenLayers version.
  * @type {string}
  */
-export const VERSION = '9.1.1-dev.1715087016979';
+export const VERSION = '9.1.1-dev.1715102817264';