@loaders.gl/wms 4.3.0-alpha.1 → 4.3.0-alpha.3

package/dist/index.js

@@ -9,17 +9,15 @@ export { WMSErrorLoader } from "./wms-error-loader.js";
 export { WMSCapabilitiesLoader } from "./wms-capabilities-loader.js";
 export { WMSFeatureInfoLoader as _WMSFeatureInfoLoader } from "./wip/wms-feature-info-loader.js";
 export { WMSLayerDescriptionLoader as _WMSLayerDescriptionLoader } from "./wip/wms-layer-description-loader.js";
-export { WFSCapabilitiesLoader as _WFSCapabilitiesLoader } from "./wip/wfs-capabilities-loader.js";
+export { WFSCapabilitiesLoader as _WFSCapabilitiesLoader } from "./wfs-capabilities-loader.js";
 export { GMLLoader as _GMLLoader } from "./gml-loader.js";
 // EXPERIMENTAL: DATA SOURCES
-// TODO - restore once deck.gl has been udpated
-export { ImageSource } from '@loaders.gl/loader-utils';
-export { createImageService } from "./lib/services/create-image-service.js";
-export { createImageSource } from "./services/create-image-source.js";
-export { ImageService } from "./lib/services/image-service.js";
 // OGC Services
-export { CSWService } from "./services/ogc/csw-service.js";
-export { WMSSource, WMSService } from "./services/ogc/wms-service.js";
-// ArcGIS Services
+// export {CSWSource} from './services/ogc/csw-service';
+export { WMSSource, WMSImageSource } from "./services/ogc/wms-service.js";
+// ArcGIS SourceLoaders
 export { getArcGISServices as _getArcGISServices } from "./services/arcgis/arcgis-server.js";
-export { ArcGISImageService as _ArcGISImageService } from "./services/arcgis/arcgis-image-service.js";
+export { ArcGISImageServerSource as _ArcGISImageServerSource } from "./services/arcgis/arcgis-image-server.js";
+// DEPRECATED: TODO - remove once deck.gl has been udpated
+export { ImageSource } from '@loaders.gl/loader-utils';
+export { createImageSource } from "./lib/deprecated/create-image-source.js";

package/dist/lib/deprecated/create-image-source.d.ts

@@ -0,0 +1,21 @@
+import type { Source, ImageSource, ImageSourceProps } from '@loaders.gl/loader-utils';
+import type { WMSImageSourceProps } from "../../services/ogc/wms-service.js";
+export type ImageSourceType = 'wms' | 'arcgis-image-server' | 'template';
+/**
+ * * @deprecated Use createDataSource from @loaders.gl/core
+ */
+type CreateImageSourceProps = ImageSourceProps & WMSImageSourceProps & {
+    type?: ImageSourceType | 'auto';
+};
+/**
+ * Creates an image source
+ * If type is not supplied, will try to automatically detect the the
+ * @param url URL to the image source
+ * @param type type of source. if not known, set to 'auto'
+ * @returns an ImageSource instance
+ *
+ * @deprecated Use createDataSource from @loaders.gl/core
+ */
+export declare function createImageSource(url: string, props: CreateImageSourceProps, sources?: Source<import("@loaders.gl/loader-utils").DataSource<import("@loaders.gl/loader-utils").DataSourceProps>, any>[]): ImageSource;
+export {};
+//# sourceMappingURL=create-image-source.d.ts.map

package/dist/lib/deprecated/create-image-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-image-source.d.ts","sourceRoot":"","sources":["../../../src/lib/deprecated/create-image-source.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,MAAM,EAAE,WAAW,EAAE,gBAAgB,EAAC,MAAM,0BAA0B,CAAC;AACpF,OAAO,KAAK,EAAC,mBAAmB,EAAC,0CAAuC;AAIxE,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,qBAAqB,GAAG,UAAU,CAAC;AAIzE;;GAEG;AACH,KAAK,sBAAsB,GAAG,gBAAgB,GAC5C,mBAAmB,GAAG;IACpB,IAAI,CAAC,EAAE,eAAe,GAAG,MAAM,CAAC;CACjC,CAAC;AAEJ;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,sBAAsB,EAC7B,OAAO,mHAAU,GAChB,WAAW,CASb"}

package/dist/lib/deprecated/create-image-source.js

@@ -0,0 +1,44 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { WMSSource } from "../../services/ogc/wms-service.js";
+import { ArcGISImageServerSource } from "../../services/arcgis/arcgis-image-server.js";
+const SOURCES = [WMSSource, ArcGISImageServerSource];
+/**
+ * Creates an image source
+ * If type is not supplied, will try to automatically detect the the
+ * @param url URL to the image source
+ * @param type type of source. if not known, set to 'auto'
+ * @returns an ImageSource instance
+ *
+ * @deprecated Use createDataSource from @loaders.gl/core
+ */
+export function createImageSource(url, props, sources = SOURCES) {
+    const { type = 'auto' } = props;
+    const source = type === 'auto' ? guessSourceType(url, sources) : getSourceOfType(type, sources);
+    if (!source) {
+        throw new Error('Not a valid image source type');
+    }
+    return source.createDataSource(url, props);
+}
+/** Guess service type from URL */
+function getSourceOfType(type, sources) {
+    // if (type === 'template') {
+    //   return ImageSource;
+    // }
+    for (const source of sources) {
+        if (source.type === type) {
+            return source;
+        }
+    }
+    return null;
+}
+/** Guess source type from URL */
+function guessSourceType(url, sources) {
+    for (const source of sources) {
+        if (source.testURL && source.testURL(url)) {
+            return source;
+        }
+    }
+    return null;
+}

package/dist/lib/parsers/wfs/parse-wfs-capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-wfs-capabilities.d.ts","sourceRoot":"","sources":["../../../../src/lib/parsers/wfs/parse-wfs-capabilities.ts"],"names":[],"mappings":"AAIA,gHAAgH;AAChH,MAAM,MAAM,eAAe,GAAG;IAC5B,qBAAqB,EAAE;QACrB,KAAK,EAAE,MAAM,CAAC;QACd,kBAAkB,EAAE,MAAM,CAAC;QAC3B,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IAEF,eAAe,EAAE;QACf,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE;YACd,cAAc,EAAE,MAAM,CAAC;YACvB,YAAY,EAAE,MAAM,CAAC;YACrB,WAAW,EAAE;gBACX,OAAO,EAAE;oBACP,kBAAkB,EAAE,MAAM,CAAC;oBAC3B,IAAI,EAAE,MAAM,CAAC;oBACb,OAAO,EAAE,MAAM,CAAC;oBAChB,aAAa,EAAE,MAAM,CAAC;oBACtB,qBAAqB,EAAE,MAAM,CAAC;oBAC9B,UAAU,EAAE,MAAM,CAAC;iBACpB,CAAC;gBACF,KAAK,EAAE;oBACL,KAAK,EAAE,MAAM,CAAC;iBACf,CAAC;aACH,CAAC;SACH,CAAC;KACH,CAAC;IAEF,kBAAkB,EAAE;QAClB,eAAe,EAAE,GAAG,CAAC;QACrB,cAAc,EAAE,GAAG,CAAC;QACpB,OAAO,EAAE,GAAG,CAAC;KACd,CAAC;IAEF,QAAQ,EAAE;QACR,MAAM,EAAE;YACN,QAAQ,EAAE,MAAM,CAAC;YACjB,UAAU,EAAE,MAAM,CAAC;YACnB,KAAK,EAAE,MAAM,CAAC;YACd,OAAO,EAAE,MAAM,EAAE,CAAC;YAClB,MAAM,EAAE;gBACN,UAAU,EAAE,MAAM,CAAC;gBACnB,SAAS,EAAE,MAAM,CAAC;gBAClB,KAAK,EAAE,MAAM,CAAC;gBACd,QAAQ,CAAC,EAAE,MAAM,CAAC;aACnB,EAAE,CAAC;YACJ,MAAM,EAAE;gBACN,IAAI,EAAE,MAAM,CAAC;gBACb,KAAK,EAAE,MAAM,CAAC;gBACd,MAAM,EAAE,MAAM,CAAC;gBACf,GAAG,EAAE,MAAM,CAAC;aACb,CAAC;YACF,kBAAkB,EAAE;gBAClB,aAAa,EAAE,MAAM,CAAC;aACvB,EAAE,CAAC;YACJ,cAAc,EAAE;gBACd,UAAU,EAAE,MAAM,CAAC;gBACnB,SAAS,EAAE;oBACT,UAAU,EAAE,MAAM,CAAC;oBACnB,YAAY,EAAE,MAAM,CAAC;oBACrB,WAAW,EAAE,MAAM,CAAC;oBACpB,gBAAgB,EAAE,MAAM,CAAC;oBACzB,SAAS,EAAE,MAAM,CAAC;oBAClB,UAAU,EAAE,MAAM,CAAC;oBACnB,aAAa,EAAE;wBACb,GAAG,EAAE,MAAM,CAAC;wBACZ,GAAG,EAAE,MAAM,CAAC;qBACb,CAAC;iBACH,EAAE,CAAC;aACL,CAAC;SACH,EAAE,CAAC;KACL,CAAC;CACH,CAAC;AAEF;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,KAAA,GAAG,eAAe,CAY3E"}

package/dist/{wip/lib → lib/parsers}/wfs/parse-wfs-capabilities.js

@@ -5,11 +5,14 @@ import { XMLLoader } from '@loaders.gl/xml';
  * @note Error handlings is fairly weak
  */
 export function parseWFSCapabilities(text, options) {
-    const parsedXML = XMLLoader.parseTextSync?.(text, { ...options, xml: {
+    const parsedXML = XMLLoader.parseTextSync?.(text, {
+        ...options,
+        xml: {
             ...options?.xml,
             removeNSPrefix: true,
             uncapitalizeKeys: true
-        } });
+        }
+    });
     const xmlCapabilities = parsedXML.Capabilities || parsedXML;
     return xmlCapabilities;
 }

package/dist/lib/parsers/wfs/parse-wfs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-wfs.d.ts","sourceRoot":"","sources":["../../../../src/lib/parsers/wfs/parse-wfs.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,eAAe,GAAG,EAAE,CAAC;AAEjC;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,KAAA,GAAG,eAAe,CAM3E"}

package/dist/services/arcgis/arcgis-feature-server.d.ts

@@ -0,0 +1,67 @@
+import { Schema, GeoJSONTable } from '@loaders.gl/schema';
+import type { VectorSourceProps, VectorSourceMetadata, GetFeaturesParameters, LoaderWithParser } from '@loaders.gl/loader-utils';
+import { VectorSource } from '@loaders.gl/loader-utils';
+export type ArcGISImageServiceQueryOptions = {
+    returnGeometry: boolean;
+    where: '1%3D1';
+    outSR: 4326;
+    outFields: string | '*';
+    inSR: 4326;
+    geometry: `${-90}%2C+${30}%2C+${-70}%2C+${50}`;
+    geometryType: 'esriGeometryEnvelope';
+    spatialRel: 'esriSpatialRelIntersects';
+    geometryPrecision: number;
+    resultType: 'tile';
+    f?: 'geojson';
+};
+/**
+ * @ndeprecated This is a WIP, not fully implemented
+ * @see https://developers.arcgis.com/rest/services-reference/enterprise/feature-service.htm
+ */
+export declare const ArcGISFeatureServerSource: {
+    readonly name: "ArcGISFeatureServer";
+    readonly id: "arcgis-feature-server";
+    readonly module: "wms";
+    readonly version: "0.0.0";
+    readonly extensions: [];
+    readonly mimeTypes: [];
+    readonly options: {
+        readonly url: never;
+        readonly 'arcgis-feature-server': {
+            /** Tabular loaders, normally the GeoJSONLoader */
+            readonly loaders: [];
+        };
+    };
+    readonly type: "arcgis-feature-server";
+    readonly fromUrl: true;
+    readonly fromBlob: false;
+    readonly testURL: (url: string) => boolean;
+    readonly createDataSource: (url: string | Blob, props: ArcGISVectorSourceProps) => ArcGISVectorSource;
+};
+export type ArcGISVectorSourceProps = VectorSourceProps & {
+    url: string;
+    'arcgis-feature-server'?: {
+        loaders: LoaderWithParser[];
+    };
+};
+/**
+ * ArcGIS ImageServer
+ * Note - exports a big API, that could be exposed here if there is a use case
+ * @see https://developers.arcgis.com/rest/services-reference/enterprise/feature-service.htm
+ */
+export declare class ArcGISVectorSource extends VectorSource<ArcGISVectorSourceProps> {
+    data: string;
+    protected formatSpecificMetadata: Promise<any>;
+    constructor(props: ArcGISVectorSourceProps);
+    /** TODO - not yet clear if we can find schema information in the FeatureServer metadata or if we need to request a feature */
+    getSchema(): Promise<Schema>;
+    getMetadata(options: {
+        formatSpecificMetadata: any;
+    }): Promise<VectorSourceMetadata>;
+    getFeatures(parameters: GetFeaturesParameters): Promise<GeoJSONTable>;
+    protected _getFormatSpecificMetadata(): Promise<any>;
+}
+/** Sample metadata
+ * @see https://developers.arcgis.com/rest/services-reference/enterprise/feature-service.htm
+ */
+//# sourceMappingURL=arcgis-feature-server.d.ts.map

package/dist/services/arcgis/arcgis-feature-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arcgis-feature-server.d.ts","sourceRoot":"","sources":["../../../src/services/arcgis/arcgis-feature-server.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,MAAM,EAAE,YAAY,EAAC,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAS,YAAY,EAAC,MAAM,0BAA0B,CAAC;AAW9D,MAAM,MAAM,8BAA8B,GAAG;IAC3C,cAAc,EAAE,OAAO,CAAC;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,IAAI,CAAC;IACZ,SAAS,EAAE,MAAM,GAAG,GAAG,CAAC;IACxB,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC;IAC/C,YAAY,EAAE,sBAAsB,CAAC;IACrC,UAAU,EAAE,0BAA0B,CAAC;IACvC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,CAAC,CAAC,EAAE,SAAS,CAAC;CACf,CAAC;AAuEF;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;YAUhC,kDAAkD;;;;;;;4BASvC,MAAM,KAAG,OAAO;2DACA,uBAAuB,KAAG,kBAAkB;CAEL,CAAC;AAEzE,MAAM,MAAM,uBAAuB,GAAG,iBAAiB,GAAG;IACxD,GAAG,EAAE,MAAM,CAAC;IACZ,uBAAuB,CAAC,EAAE;QACxB,OAAO,EAAE,gBAAgB,EAAE,CAAC;KAC7B,CAAC;CACH,CAAC;AAEF;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,YAAY,CAAC,uBAAuB,CAAC;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,sBAAsB,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;gBAEnC,KAAK,EAAE,uBAAuB;IAM1C,8HAA8H;IACxH,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAK5B,WAAW,CAAC,OAAO,EAAE;QAAC,sBAAsB,MAAA;KAAC,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAa7E,WAAW,CAAC,UAAU,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC;cAY3D,0BAA0B;CAM3C;AA2ID;;GAEG"}

package/dist/services/arcgis/arcgis-feature-server.js

@@ -0,0 +1,446 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { VectorSource } from '@loaders.gl/loader-utils';
+const TEST_SERVICE = 'https://services2.arcgis.com/CcI36Pduqd0OR4W9/ArcGIS/rest/services/Bicycle_Routes_Public/FeatureServer/0';
+const TEST_QUERY = 
+// eslint-disable-next-line no-template-curly-in-string
+'query?returnGeometry=true&where=1%3D1&outSR=4326&outFields=*&inSR=4326&geometry=${-90}%2C+${30}%2C+${-70}%2C+${50}&geometryType=esriGeometryEnvelope&spatialRel=esriSpatialRelIntersects&geometryPrecision=6&resultType=tile&f=geojson';
+// const DEFAULT_QUERY_OPTIONS: Required<ArcGISImageServiceQueryOptions>  = {
+//   returnGeometry:true,
+//   where: '1%3D1',
+//   outSR: 4326,
+//   outFields: '*',
+//   inSR: 4326,
+//   geometry: `${-90}%2C+${30}%2C+${-70}%2C+${50}`,
+//   geometryType: 'esriGeometryEnvelope',
+//   spatialRel: 'esriSpatialRelIntersects',
+//   geometryPrecision: 6,
+//   resultType: 'tile',
+//   f: 'geojson'
+// };
+// export type ArcGISFeatureServiceProps = ArcGISImageServiceQueryOptions & {
+//   url: string;
+//   loadOptions?: LoaderOptions;
+//   fetch?: typeof fetch | FetchLike;
+// };
+// export class ArcGISFeatureService {
+//   url: string;
+//   loadOptions: LoaderOptions;
+//   fetch: typeof fetch | FetchLike;
+//   constructor(props: ArcGISFeatureServiceProps) {
+//     this.url = props.url;
+//     this.loadOptions = props.loadOptions || {};
+//     this.fetch = props.fetch || fetch;
+//   }
+//   // URL creators
+//   metadataURL(options: {parameters?: Record<string, unknown>}): string {
+//     return this.getUrl({...options});
+//   }
+//   /**
+//    * Form a URL to an ESRI FeatureServer
+// // https://services2.arcgis.com/CcI36Pduqd0OR4W9/ArcGIS/rest/services/Bicycle_Routes_Public/FeatureServer/0/query?
+// //   returnGeometry=true&where=1%3D1&outSR=4326&outFields=*&inSR=4326&geometry=${-90}%2C+${30}%2C+${-70}%2C+${50}&
+// //   geometryType=esriGeometryEnvelope&spatialRel=esriSpatialRelIntersects&geometryPrecision=6&resultType=tile&f=geojson`
+//    */
+//   exportImageURL(options: {
+//     boundingBox: [number, number, number, number];
+//     boundingBoxSR?: string;
+//     width: number;
+//     height: number;
+//     imageSR?: string;
+//     time?: never;
+//     f?: 'geojson';
+//     resultType?: 'tile';
+//     noData?: never;
+//     noDataInterpretation?: 'esriNoDataMatchAny';
+//     interpolation?: '+RSP_NearestNeighbor';
+//     compression?: never
+//     compressionQuality?: never;
+//     bandIds?: never;
+//     mosaicRule?: never;
+//     renderingRule?: never;
+//     f?: 'image';
+//   }): string {
+//     const {boundingBox} = options;
+//     // const bbox = `bbox=${boundingBox[0]},${boundingBox[1]},${boundingBox[2]},${boundingBox[3]}`;
+//     // const size = `size=${width},${height}`
+//     return this.getUrl({path: 'exportImage', });
+//   }
+// }
+/**
+ * @ndeprecated This is a WIP, not fully implemented
+ * @see https://developers.arcgis.com/rest/services-reference/enterprise/feature-service.htm
+ */
+export const ArcGISFeatureServerSource = {
+    name: 'ArcGISFeatureServer',
+    id: 'arcgis-feature-server',
+    module: 'wms',
+    version: '0.0.0',
+    extensions: [],
+    mimeTypes: [],
+    options: {
+        url: undefined,
+        'arcgis-feature-server': {
+            /** Tabular loaders, normally the GeoJSONLoader */
+            loaders: []
+        }
+    },
+    type: 'arcgis-feature-server',
+    fromUrl: true,
+    fromBlob: false,
+    testURL: (url) => url.toLowerCase().includes('FeatureServer'),
+    createDataSource: (url, props) => new ArcGISVectorSource(props)
+};
+/**
+ * ArcGIS ImageServer
+ * Note - exports a big API, that could be exposed here if there is a use case
+ * @see https://developers.arcgis.com/rest/services-reference/enterprise/feature-service.htm
+ */
+export class ArcGISVectorSource extends VectorSource {
+    data;
+    formatSpecificMetadata;
+    constructor(props) {
+        super(props);
+        this.data = props.url;
+        this.formatSpecificMetadata = this._getFormatSpecificMetadata();
+    }
+    /** TODO - not yet clear if we can find schema information in the FeatureServer metadata or if we need to request a feature */
+    async getSchema() {
+        await this.getMetadata({ formatSpecificMetadata: true });
+        return { metadata: {}, fields: [] };
+    }
+    async getMetadata(options) {
+        // Wait for raw metadata to load
+        const formatSpecificMetadata = await this.formatSpecificMetadata;
+        const metadata = parseArcGISFeatureServerMetadata(formatSpecificMetadata);
+        // Only add the big blob of source metadata if explicitly requested
+        if (options.formatSpecificMetadata) {
+            metadata.formatSpecificMetadata = formatSpecificMetadata;
+        }
+        return metadata;
+    }
+    async getFeatures(parameters) {
+        const url = `${TEST_SERVICE}/${TEST_QUERY}`;
+        const response = await this.fetch(url);
+        const arrayBuffer = await response.arrayBuffer();
+        // TODO - hack - done to avoid pulling in selectLoader from core
+        const loader = this.props['arcgis-feature-server']?.loaders?.[0];
+        const table = loader?.parse(arrayBuffer);
+        return table;
+    }
+    // ImageServer endpoints
+    async _getFormatSpecificMetadata() {
+        // PJSON is formatted by a bit slower than JSON
+        const url = `${TEST_SERVICE}/f=pjson`;
+        const response = await this.fetch(url);
+        return await response.json();
+    }
+}
+/*
+  getArcGISOptions({
+    boundingBox: [min: [x: number, y: number], max: [x: number, y: number]]
+  }) {
+    return {
+      returnGeometry: true,
+      where: '1=1',
+      outFields: '*',
+      inSR: 432,
+      geometry: '${-90}%2C+${30}%2C+${-70}%2C+${50}',
+      geometryType: 'esriGeometryEnvelope',
+      spatialRel: 'esriSpatialRelIntersects',
+      geometryPrecision: 6,
+      resultType: 'tile',
+      f: 'geojson'
+    };
+  }
+  */
+/**
+   * Form a URL to an ESRI ImageServer
+   // https://sampleserver6.arcgisonline.com/arcgis/rest/services/NLCDLandCover2001/ImageServer/exportImage?bbox=${bounds[0]},${bounds[1]},${bounds[2]},${bounds[3]}&bboxSR=4326&size=${width},${height}&imageSR=102100&time=&format=jpgpng&pixelType=U8&noData=&noDataInterpretation=esriNoDataMatchAny&interpolation=+RSP_NearestNeighbor&compression=&compressionQuality=&bandIds=&mosaicRule=&renderingRule=&f=image`,
+   *
+  exportImage(options: {
+    boundingBox: [number, number, number, number];
+    boundingBoxSR?: string;
+    width: number;
+    height: number;
+    imageSR?: string;
+    time?: never;
+    format?: 'jpgpng';
+    pixelType?: 'U8';
+    noData?: never;
+    noDataInterpretation?: 'esriNoDataMatchAny';
+    interpolation?: '+RSP_NearestNeighbor';
+    compression?: never;
+    compressionQuality?: never;
+    bandIds?: never;
+    mosaicRule?: never;
+    renderingRule?: never;
+    f?: 'image';
+  }): Promise<ImageType> {
+    // See WMSService.getMap()
+    throw new Error('not implemented');
+  }
+
+  // URL creators
+
+  metadataURL(options: {parameters?: Record<string, unknown>}): string {
+    return `${this.props.url}?f=pjson`;
+  }
+
+  /**
+   * Form a URL to an ESRI ImageServer
+   // https://sampleserver6.arcgisonline.com/arcgis/rest/services/NLCDLandCover2001/ImageServer/exportImage?
+   //   bbox=${bounds[0]},${bounds[1]},${bounds[2]},${bounds[3]}&bboxSR=4326&
+   //   size=${width},${height}&imageSR=102100&time=&format=jpgpng&pixelType=U8&
+   //   noData=&noDataInterpretation=esriNoDataMatchAny&interpolation=+RSP_NearestNeighbor&compression=&
+   //   compressionQuality=&bandIds=&mosaicRule=&renderingRule=&
+   //   f=image
+   *
+  exportImageURL(options: {
+    bbox: [number, number, number, number];
+    boxSR?: string;
+    width: number;
+    height: number;
+    imageSR?: string;
+    time?: never;
+    format?: 'jpgpng';
+    pixelType?: 'U8';
+    noData?: never;
+    noDataInterpretation?: 'esriNoDataMatchAny';
+    interpolation?: '+RSP_NearestNeighbor';
+    compression?: never;
+    compressionQuality?: never;
+    bandIds?: never;
+    mosaicRule?: never;
+    renderingRule?: never;
+    f?: 'image';
+  }): string {
+    const bbox = `bbox=${options.bbox[0]},${options.bbox[1]},${options.bbox[2]},${options.bbox[3]}`;
+    const size = `size=${options.width},${options.height}`;
+    const arcgisOptions = {...options, bbox, size};
+    // @ts-expect-error
+    delete arcgisOptions.width;
+    // @ts-expect-error
+    delete arcgisOptions.height;
+    return this.getUrl('exportImage', arcgisOptions);
+  }
+
+  // INTERNAL METHODS
+
+  /**
+   * @note protected, since perhaps getWMSUrl may need to be overridden to handle certain backends?
+   * @note if override is common, maybe add a callback prop?
+   *
+  protected getUrl(
+    path: string,
+    options: Record<string, unknown>,
+    extra?: Record<string, unknown>
+  ): string {
+    let url = `${this.props.url}/${path}`;
+    let first = true;
+    for (const [key, value] of Object.entries(options)) {
+      url += first ? '?' : '&';
+      first = false;
+      if (Array.isArray(value)) {
+        url += `${key.toUpperCase()}=${value.join(',')}`;
+      } else {
+        url += `${key.toUpperCase()}=${value ? String(value) : ''}`;
+      }
+    }
+    return url;
+  }
+*/
+function parseArcGISFeatureServerMetadata(json) {
+    const layers = [];
+    for (const layer of json.layers || []) {
+        layers.push({
+            // id: layer.id,
+            name: layer.name
+        });
+    }
+    return {
+        // version: json.currentVersion || '',
+        title: json.serviceDescription || '',
+        name: json.serviceDescription || '',
+        abstract: json.description || '',
+        keywords: [],
+        // attrribution: json.copyrightText || ''.
+        // crs: 'EPSG:4326',
+        layers
+    };
+}
+/** Sample metadata
+ * @see https://developers.arcgis.com/rest/services-reference/enterprise/feature-service.htm
+ */
+//     "currentVersion": 11.1,
+//     "serviceDescription": "Birds",
+//     "hasVersionedData": false,
+//     "supportsDisconnectedEditing: false,
+//     "supportsDatumTransformation": true,
+//     "supportsReturnDeleteResults": true,
+//     "supportsRelationshipsResource": true,
+//     "syncEnabled": false,
+//     "supportedExportFormats": "sqlite,filegdb,shapefile,csv,geojson",
+//     "hasStaticData": false,
+//     "maxRecordCount": 1000,
+//     "supportedQueryFormats": "JSON",
+//     "capabilities": "Query,Create,Delete,Update,Uploads,Editing,Extract,ChangeTracking,Sync",
+//     "description": "",
+//     "copyrightText": "",
+//     "userTypeExtensions: [
+//       "utilityNetwork"
+//     ],
+//     "advancedEditingCapabilities": {
+//       "supportsSplit": true,
+//       "supportsReturnServiceEditsInSourceSR": true
+//     },
+//     "spatialReference": {
+//       "wkid": 4326,
+//       "latestWkid": 4326
+//     },
+//     "initialExtent": {
+//       "xmin": -118.016756138237,
+//       "ymin": 32.8933824408207,
+//       "xmax": -116.532738278622,
+//       "ymax": 34.3261469363675,
+//       "spatialReference": {
+//         "wkid": 4326,
+//         "latestWkid": 4326
+//       }
+//     },
+//     "fullExtent": {
+//       "xmin": -117.855689264791,
+//       "ymin": 32.5702577626442,
+//       "xmax": -116.87086222794,
+//       "ymax": 34.1460567673275,
+//       "spatialReference": {
+//         "wkid": 4326,
+//         "latestWkid": 4326
+//       }
+//     },
+//     "allowGeometryUpdates": true,
+//     "units": "esriDecimalDegrees",
+//     "syncEnabled": true,
+//     "validationSystemLayers": {
+//       "validationPointErrorlayerId": 1,
+//       "validationLineErrorlayerId": 2,
+//       "validationPolygonErrorlayerId": 3,
+//       "validationObjectErrortableId": 5
+//     },
+//     "extractChangesCapabilities": {
+//       "supportsReturnIdsOnly": true,
+//       "supportsReturnExtentOnly": false,
+//       "supportsReturnAttachments": false,
+//       "supportsLayerQueries": false,
+//       "supportsSpatialFilter": false,
+//       "supportsReturnFeature": false,
+//       "supportsReturnHasGeometryUpdates": true
+//     },
+//     "syncCapabilities": {
+//       "supportsASync": true,
+//       "supportsRegisteringExistingData": true,
+//       "supportsSyncDirectionControl": true,
+//       "supportsPerLayerSync": true,
+//       "supportsPerReplicaSync": false,
+//       "supportsRollbackOnFailure": false,
+//       "supportedSyncDataOptions": 3
+//       "supportsQueryWithDatumTransformation": true,
+//     },
+//     "editorTrackingInfo": {
+//       "enableEditorTracking": false,
+//       "enableOwnershipAccessControl": false,
+//       "allowOthersToUpdate": true,
+//       "allowOthersToDelete": false
+//     },
+//     "layers": [
+//       {
+//         "id": 0,
+//         "name": "Sitings",
+//         "parentLayerId": -1,
+//         "defaultVisibility": true,
+//         "subLayerIds": null,
+//         "minScale": 0,
+//         "maxScale": 0,
+//         "geometryType": "esriGeometryPoint"
+//       },
+//       {
+//         "id": 1,
+//         "name": "NestingGrounds",
+//         "parentLayerId": -1,
+//         "defaultVisibility": true,
+//         "subLayerIds": null,
+//         "minScale": 0,
+//         "maxScale": 0,
+//         "geometryType": "esriGeometryPolygon"
+//       },
+//       {
+//         "id": 2,
+//         "name": "LandCover",
+//         "parentLayerId": -1,
+//         "defaultVisibility": true,
+//         "subLayerIds": null,
+//         "minScale": 0,
+//         "maxScale": 0,
+//         "geometryType": "esriGeometryPolygon"
+//       }
+//     ],
+//     "tables": [],
+//     "relationships": [
+//      {
+//       "id": 0,
+//       "name": "relationship_1"
+//      }
+//     ],
+//     "datumTransformations": [
+//       {
+//         "geoTransforms": [
+//           {
+//             "wkid": 15931,
+//             "latestWkid": 15931,
+//             "transformForward": false,
+//             "name": NAD_1983_NSRS2007_To_WGS_1984_1"
+//           }
+//         ]
+//       },
+//       {
+//         "geoTransforms": [
+//           {
+//             "wkid": 15931,
+//             "latestWkid": 15931,
+//             "transformForward": true,
+//             "name": NAD_1983_NSRS2007_to_WGS_1984_1"
+//           }
+//         ]
+//       }
+//     ],
+//     "isIndoorsService": true,
+//     "isLocationTrackingService": true,
+//     "isLocationTrackingView": true
+//   }
+//   The following is a portion of a JSON response example for a spatial reference, VCS, tolerance, resolution properties, and high model info:
+//   ...
+//    "spatialReference": {
+//     "wkid": 102100,
+//     "latestWkid": 3857,
+//     "vcsWkid": 115700,
+//     "latestVcsWkid": 115700,
+//     "xyTolerance": 0.001,
+//     "zTolerance": 0.001,
+//     "mTolerance": 0.001,
+//     "falseX": -20037700,
+//     "falseY": -30241100,
+//     "xyUnits": 1.4892314192838538E8,
+//     "falseZ": -100000,
+//     "zUnits": 10000,
+//     "falseM": -100000,
+//     "mUnits": 10000
+//    },
+//    "heightModelInfo": {
+//     "heightModel": "ellipsoidal",
+//     "vertCRS": "WGS_1984",
+//     "heightUnit": "meter"
+//    },
+//   ...
+//   // TODO - normalize metadata
+// }