@itwin/map-layers-formats 5.10.2 → 5.11.0-dev.10

package/lib/esm/AzureMaps/AzureMaps.d.ts

@@ -0,0 +1,40 @@
+/** @packageDocumentation
+ * @module MapLayersFormats
+ */
+import { BackgroundMapType, BaseMapLayerSettings, ImageMapLayerSettings } from "@itwin/core-common";
+import { type DisplayStyleState } from "@itwin/core-frontend";
+/**
+ * Azure Maps API.
+ * @beta
+ */
+export declare const AzureMaps: {
+    /**
+     * Creates Azure Maps base-layer settings for the supplied basemap type.
+     * @beta
+     */
+    createBaseLayerSettings: (type: BackgroundMapType) => BaseMapLayerSettings;
+    /**
+     * Creates any Azure Maps background helper layers required by the supplied basemap type.
+     * Hybrid is composed from aerial imagery plus an internal road-labels helper layer.
+     * @beta
+     */
+    createBackgroundLayers: (type: BackgroundMapType) => ImageMapLayerSettings[];
+    /**
+     * Removes any Azure Maps helper layers owned by this package from the display style.
+     * @beta
+     */
+    clearBackgroundLayers: (displayStyle: DisplayStyleState) => void;
+    /**
+     * Applies the requested Azure Maps basemap to the supplied display style.
+     * Preserves the existing base-layer display state, such as visibility and transparency,
+     * while replacing the basemap source with the Azure Maps equivalent.
+     * @beta
+     */
+    applyBackgroundMap: (displayStyle: DisplayStyleState, type: BackgroundMapType) => void;
+    /**
+     * Identifies the active Azure Maps basemap type for the supplied display style, if any.
+     * @beta
+     */
+    getBackgroundMapType: (displayStyle: DisplayStyleState) => BackgroundMapType | undefined;
+};
+//# sourceMappingURL=AzureMaps.d.ts.map

package/lib/esm/AzureMaps/AzureMaps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AzureMaps.d.ts","sourceRoot":"","sources":["../../../src/AzureMaps/AzureMaps.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAqB,oBAAoB,EAAsB,qBAAqB,EAAgD,MAAM,oBAAoB,CAAC;AACzL,OAAO,EAAE,KAAK,iBAAiB,EAAa,MAAM,sBAAsB,CAAC;AA2CzE;;;GAGG;AAEH,eAAO,MAAM,SAAS;IACpB;;;OAGG;oCAC6B,iBAAiB;IAKjD;;;;OAIG;mCAC4B,iBAAiB;IAMhD;;;OAGG;0CACmC,iBAAiB;IAQvD;;;;;OAKG;uCACgC,iBAAiB,QAAQ,iBAAiB;IAmB7E;;;OAGG;yCACkC,iBAAiB,KAAG,iBAAiB,GAAG,SAAS;CAgBvF,CAAC"}

package/lib/esm/AzureMaps/AzureMaps.js

@@ -0,0 +1,121 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module MapLayersFormats
+ */
+import { BackgroundMapType, BaseMapLayerSettings, ImageMapLayerSettings } from "@itwin/core-common";
+import { IModelApp } from "@itwin/core-frontend";
+import { AzureMapsMapLayerFormat } from "./AzureMapsImageryFormat.js";
+const streetUrl = "https://atlas.microsoft.com/map/tile?tilesetId=microsoft.base.road";
+const aerialUrl = "https://atlas.microsoft.com/map/tile?tilesetId=microsoft.imagery";
+const roadLabelsUrl = "https://atlas.microsoft.com/map/tile?tilesetId=microsoft.base.labels.road";
+const roadLabelsRole = "roadLabels";
+function assertRegistered() {
+    if (!IModelApp.mapLayerFormatRegistry.isRegistered(AzureMapsMapLayerFormat.formatId))
+        throw new Error("AzureMaps format is not registered");
+}
+function baseLayerProps(type) {
+    switch (type) {
+        case BackgroundMapType.Street:
+            return { formatId: AzureMapsMapLayerFormat.formatId, name: "Azure Maps: Streets", url: streetUrl };
+        case BackgroundMapType.Aerial:
+            return { formatId: AzureMapsMapLayerFormat.formatId, name: "Azure Maps: Aerial Imagery", url: aerialUrl };
+        case BackgroundMapType.Hybrid:
+            return { formatId: AzureMapsMapLayerFormat.formatId, name: "Azure Maps: Hybrid", url: aerialUrl };
+    }
+}
+function roadLabelsLayerProps() {
+    const properties = { azureMapsRole: roadLabelsRole };
+    return {
+        formatId: AzureMapsMapLayerFormat.formatId,
+        name: "Azure Maps: Road labels",
+        url: roadLabelsUrl,
+        transparentBackground: true,
+        properties,
+    };
+}
+function isOwnedRoadLabelsLayer(layer) {
+    // Identify by format + role marker, not URL: a persisted style created against an older
+    // roadLabelsUrl must still be recognized so Hybrid round-trips and cleanup stay correct.
+    return layer instanceof ImageMapLayerSettings
+        && layer.formatId === AzureMapsMapLayerFormat.formatId
+        && layer.properties?.azureMapsRole === roadLabelsRole;
+}
+/**
+ * Azure Maps API.
+ * @beta
+ */
+// eslint-disable-next-line @typescript-eslint/naming-convention
+export const AzureMaps = {
+    /**
+     * Creates Azure Maps base-layer settings for the supplied basemap type.
+     * @beta
+     */
+    createBaseLayerSettings: (type) => {
+        assertRegistered();
+        return BaseMapLayerSettings.fromJSON(baseLayerProps(type));
+    },
+    /**
+     * Creates any Azure Maps background helper layers required by the supplied basemap type.
+     * Hybrid is composed from aerial imagery plus an internal road-labels helper layer.
+     * @beta
+     */
+    createBackgroundLayers: (type) => {
+        return type === BackgroundMapType.Hybrid
+            ? [ImageMapLayerSettings.fromJSON(roadLabelsLayerProps())]
+            : [];
+    },
+    /**
+     * Removes any Azure Maps helper layers owned by this package from the display style.
+     * @beta
+     */
+    clearBackgroundLayers: (displayStyle) => {
+        const layers = displayStyle.settings.mapImagery.backgroundLayers;
+        for (let index = layers.length - 1; index >= 0; --index) {
+            if (isOwnedRoadLabelsLayer(layers[index]))
+                displayStyle.detachMapLayerByIndex({ index, isOverlay: false });
+        }
+    },
+    /**
+     * Applies the requested Azure Maps basemap to the supplied display style.
+     * Preserves the existing base-layer display state, such as visibility and transparency,
+     * while replacing the basemap source with the Azure Maps equivalent.
+     * @beta
+     */
+    applyBackgroundMap: (displayStyle, type) => {
+        assertRegistered();
+        AzureMaps.clearBackgroundLayers(displayStyle);
+        const azureBaseProps = baseLayerProps(type);
+        const previousBase = displayStyle.backgroundMapBase;
+        displayStyle.backgroundMapBase = previousBase instanceof BaseMapLayerSettings
+            ? BaseMapLayerSettings.fromJSON({
+                ...azureBaseProps,
+                visible: previousBase.visible,
+                transparency: previousBase.transparency,
+                transparentBackground: previousBase.transparentBackground,
+            })
+            : BaseMapLayerSettings.fromJSON(azureBaseProps);
+        for (const layer of AzureMaps.createBackgroundLayers(type))
+            displayStyle.attachMapLayer({ mapLayerIndex: { index: -1, isOverlay: false }, settings: layer });
+    },
+    /**
+     * Identifies the active Azure Maps basemap type for the supplied display style, if any.
+     * @beta
+     */
+    getBackgroundMapType: (displayStyle) => {
+        const baseLayer = displayStyle.backgroundMapBase;
+        if (!(baseLayer instanceof BaseMapLayerSettings) || baseLayer.formatId !== AzureMapsMapLayerFormat.formatId)
+            return undefined;
+        if (baseLayer.url === streetUrl)
+            return BackgroundMapType.Street;
+        if (baseLayer.url === aerialUrl) {
+            return displayStyle.settings.mapImagery.backgroundLayers.some(isOwnedRoadLabelsLayer)
+                ? BackgroundMapType.Hybrid
+                : BackgroundMapType.Aerial;
+        }
+        return undefined;
+    },
+};
+//# sourceMappingURL=AzureMaps.js.map

package/lib/esm/AzureMaps/AzureMaps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AzureMaps.js","sourceRoot":"","sources":["../../../src/AzureMaps/AzureMaps.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module MapLayersFormats\n */\n\nimport { BackgroundMapType, BaseMapLayerProps, BaseMapLayerSettings, ImageMapLayerProps, ImageMapLayerSettings, MapLayerProviderProperties, MapLayerSettings } from \"@itwin/core-common\";\nimport { type DisplayStyleState, IModelApp } from \"@itwin/core-frontend\";\nimport { AzureMapsMapLayerFormat } from \"./AzureMapsImageryFormat.js\";\n\nconst streetUrl = \"https://atlas.microsoft.com/map/tile?tilesetId=microsoft.base.road\";\nconst aerialUrl = \"https://atlas.microsoft.com/map/tile?tilesetId=microsoft.imagery\";\nconst roadLabelsUrl = \"https://atlas.microsoft.com/map/tile?tilesetId=microsoft.base.labels.road\";\nconst roadLabelsRole = \"roadLabels\";\n\nfunction assertRegistered(): void {\n  if (!IModelApp.mapLayerFormatRegistry.isRegistered(AzureMapsMapLayerFormat.formatId))\n    throw new Error(\"AzureMaps format is not registered\");\n}\n\nfunction baseLayerProps(type: BackgroundMapType): BaseMapLayerProps {\n  switch (type) {\n    case BackgroundMapType.Street:\n      return { formatId: AzureMapsMapLayerFormat.formatId, name: \"Azure Maps: Streets\", url: streetUrl };\n    case BackgroundMapType.Aerial:\n      return { formatId: AzureMapsMapLayerFormat.formatId, name: \"Azure Maps: Aerial Imagery\", url: aerialUrl };\n    case BackgroundMapType.Hybrid:\n      return { formatId: AzureMapsMapLayerFormat.formatId, name: \"Azure Maps: Hybrid\", url: aerialUrl };\n  }\n}\n\nfunction roadLabelsLayerProps(): ImageMapLayerProps {\n  const properties: MapLayerProviderProperties = { azureMapsRole: roadLabelsRole };\n  return {\n    formatId: AzureMapsMapLayerFormat.formatId,\n    name: \"Azure Maps: Road labels\",\n    url: roadLabelsUrl,\n    transparentBackground: true,\n    properties,\n  };\n}\n\nfunction isOwnedRoadLabelsLayer(layer: MapLayerSettings): layer is ImageMapLayerSettings {\n  // Identify by format + role marker, not URL: a persisted style created against an older\n  // roadLabelsUrl must still be recognized so Hybrid round-trips and cleanup stay correct.\n  return layer instanceof ImageMapLayerSettings\n    && layer.formatId === AzureMapsMapLayerFormat.formatId\n    && layer.properties?.azureMapsRole === roadLabelsRole;\n}\n\n/**\n * Azure Maps API.\n * @beta\n */\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport const AzureMaps = {\n  /**\n   * Creates Azure Maps base-layer settings for the supplied basemap type.\n   * @beta\n   */\n  createBaseLayerSettings: (type: BackgroundMapType) => {\n    assertRegistered();\n    return BaseMapLayerSettings.fromJSON(baseLayerProps(type));\n  },\n\n  /**\n   * Creates any Azure Maps background helper layers required by the supplied basemap type.\n   * Hybrid is composed from aerial imagery plus an internal road-labels helper layer.\n   * @beta\n   */\n  createBackgroundLayers: (type: BackgroundMapType) => {\n    return type === BackgroundMapType.Hybrid\n      ? [ImageMapLayerSettings.fromJSON(roadLabelsLayerProps())]\n      : [];\n  },\n\n  /**\n   * Removes any Azure Maps helper layers owned by this package from the display style.\n   * @beta\n   */\n  clearBackgroundLayers: (displayStyle: DisplayStyleState) => {\n    const layers = displayStyle.settings.mapImagery.backgroundLayers;\n    for (let index = layers.length - 1; index >= 0; --index) {\n      if (isOwnedRoadLabelsLayer(layers[index]))\n        displayStyle.detachMapLayerByIndex({ index, isOverlay: false });\n    }\n  },\n\n  /**\n   * Applies the requested Azure Maps basemap to the supplied display style.\n   * Preserves the existing base-layer display state, such as visibility and transparency,\n   * while replacing the basemap source with the Azure Maps equivalent.\n   * @beta\n   */\n  applyBackgroundMap: (displayStyle: DisplayStyleState, type: BackgroundMapType) => {\n    assertRegistered();\n    AzureMaps.clearBackgroundLayers(displayStyle);\n\n    const azureBaseProps = baseLayerProps(type);\n    const previousBase = displayStyle.backgroundMapBase;\n    displayStyle.backgroundMapBase = previousBase instanceof BaseMapLayerSettings\n      ? BaseMapLayerSettings.fromJSON({\n          ...azureBaseProps,\n          visible: previousBase.visible,\n          transparency: previousBase.transparency,\n          transparentBackground: previousBase.transparentBackground,\n        })\n      : BaseMapLayerSettings.fromJSON(azureBaseProps);\n\n    for (const layer of AzureMaps.createBackgroundLayers(type))\n      displayStyle.attachMapLayer({ mapLayerIndex: { index: -1, isOverlay: false }, settings: layer });\n  },\n\n  /**\n   * Identifies the active Azure Maps basemap type for the supplied display style, if any.\n   * @beta\n   */\n  getBackgroundMapType: (displayStyle: DisplayStyleState): BackgroundMapType | undefined => {\n    const baseLayer = displayStyle.backgroundMapBase;\n    if (!(baseLayer instanceof BaseMapLayerSettings) || baseLayer.formatId !== AzureMapsMapLayerFormat.formatId)\n      return undefined;\n\n    if (baseLayer.url === streetUrl)\n      return BackgroundMapType.Street;\n\n    if (baseLayer.url === aerialUrl) {\n      return displayStyle.settings.mapImagery.backgroundLayers.some(isOwnedRoadLabelsLayer)\n        ? BackgroundMapType.Hybrid\n        : BackgroundMapType.Aerial;\n    }\n\n    return undefined;\n  },\n};\n"]}

package/lib/esm/AzureMaps/AzureMapsImageryFormat.d.ts

@@ -0,0 +1,20 @@
+/** @packageDocumentation
+ * @module MapLayersFormats
+ */
+import { ImageMapLayerSettings } from "@itwin/core-common";
+import { ImageryMapLayerFormat, MapLayerImageryProvider, type MapLayerSourceValidation, type ValidateSourceArgs } from "@itwin/core-frontend";
+/**
+ * Azure Maps imagery layer format.
+ * @beta
+ */
+export declare class AzureMapsMapLayerFormat extends ImageryMapLayerFormat {
+    /** Azure Maps imagery layer format.
+     * @beta
+     */
+    static formatId: string;
+    private static validateAzureSourceUrl;
+    static validate(args: ValidateSourceArgs): Promise<MapLayerSourceValidation>;
+    /** @internal */
+    static createImageryProvider(settings: ImageMapLayerSettings): MapLayerImageryProvider | undefined;
+}
+//# sourceMappingURL=AzureMapsImageryFormat.d.ts.map

package/lib/esm/AzureMaps/AzureMapsImageryFormat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AzureMapsImageryFormat.d.ts","sourceRoot":"","sources":["../../../src/AzureMaps/AzureMapsImageryFormat.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAa,uBAAuB,EAAwB,KAAK,wBAAwB,EAAE,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAI/K;;;GAGG;AACH,qBAAa,uBAAwB,SAAQ,qBAAqB;IAChE;;OAEG;IACH,OAAuB,QAAQ,SAAe;IAE9C,OAAO,CAAC,MAAM,CAAC,sBAAsB;WAiBR,QAAQ,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAYlG,gBAAgB;WACO,qBAAqB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,uBAAuB,GAAG,SAAS;CAGnH"}

package/lib/esm/AzureMaps/AzureMapsImageryFormat.js

@@ -0,0 +1,48 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module MapLayersFormats
+ */
+import { ImageryMapLayerFormat, IModelApp, MapLayerSourceStatus } from "@itwin/core-frontend";
+import { MapLayersFormats } from "../mapLayersFormats.js";
+import { AzureMapsLayerImageryProvider, getAzureMapsSubscriptionKey } from "./AzureMapsImageryProvider.js";
+/**
+ * Azure Maps imagery layer format.
+ * @beta
+ */
+export class AzureMapsMapLayerFormat extends ImageryMapLayerFormat {
+    /** Azure Maps imagery layer format.
+     * @beta
+     */
+    static formatId = "AzureMaps";
+    static validateAzureSourceUrl(url) {
+        let parsedUrl;
+        try {
+            parsedUrl = new URL(url);
+        }
+        catch {
+            return MapLayerSourceStatus.InvalidUrl;
+        }
+        if (!parsedUrl.protocol.startsWith("http"))
+            return MapLayerSourceStatus.InvalidUrl;
+        if (parsedUrl.hostname !== "atlas.microsoft.com" || parsedUrl.pathname !== "/map/tile")
+            return MapLayerSourceStatus.IncompatibleFormat;
+        return parsedUrl.searchParams.has("tilesetId") ? MapLayerSourceStatus.Valid : MapLayerSourceStatus.InvalidUrl;
+    }
+    static async validate(args) {
+        const urlStatus = AzureMapsMapLayerFormat.validateAzureSourceUrl(args.source.url);
+        if (urlStatus !== MapLayerSourceStatus.Valid)
+            return { status: urlStatus };
+        const accessKey = IModelApp.mapLayerFormatRegistry.configOptions.AzureMaps;
+        if (undefined === getAzureMapsSubscriptionKey(accessKey, MapLayersFormats.azureMapsOpts?.subscriptionKey))
+            return { status: MapLayerSourceStatus.RequireAuth };
+        return { status: MapLayerSourceStatus.Valid };
+    }
+    /** @internal */
+    static createImageryProvider(settings) {
+        return new AzureMapsLayerImageryProvider(settings, MapLayersFormats.azureMapsOpts?.subscriptionKey);
+    }
+}
+//# sourceMappingURL=AzureMapsImageryFormat.js.map

package/lib/esm/AzureMaps/AzureMapsImageryFormat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AzureMapsImageryFormat.js","sourceRoot":"","sources":["../../../src/AzureMaps/AzureMapsImageryFormat.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAGH,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAA2B,oBAAoB,EAA0D,MAAM,sBAAsB,CAAC;AAC/K,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,6BAA6B,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAE3G;;;GAGG;AACH,MAAM,OAAO,uBAAwB,SAAQ,qBAAqB;IAChE;;OAEG;IACI,MAAM,CAAU,QAAQ,GAAG,WAAW,CAAC;IAEtC,MAAM,CAAC,sBAAsB,CAAC,GAAW;QAC/C,IAAI,SAAc,CAAC;QACnB,IAAI,CAAC;YACH,SAAS,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,oBAAoB,CAAC,UAAU,CAAC;QACzC,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC;YACxC,OAAO,oBAAoB,CAAC,UAAU,CAAC;QAEzC,IAAI,SAAS,CAAC,QAAQ,KAAK,qBAAqB,IAAI,SAAS,CAAC,QAAQ,KAAK,WAAW;YACpF,OAAO,oBAAoB,CAAC,kBAAkB,CAAC;QAEjD,OAAO,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC,oBAAoB,CAAC,UAAU,CAAC;IAChH,CAAC;IAEM,MAAM,CAAU,KAAK,CAAC,QAAQ,CAAC,IAAwB;QAC5D,MAAM,SAAS,GAAG,uBAAuB,CAAC,sBAAsB,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClF,IAAI,SAAS,KAAK,oBAAoB,CAAC,KAAK;YAC1C,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAE/B,MAAM,SAAS,GAAG,SAAS,CAAC,sBAAsB,CAAC,aAAa,CAAC,SAAS,CAAC;QAC3E,IAAI,SAAS,KAAK,2BAA2B,CAAC,SAAS,EAAE,gBAAgB,CAAC,aAAa,EAAE,eAAe,CAAC;YACvG,OAAO,EAAE,MAAM,EAAE,oBAAoB,CAAC,WAAW,EAAE,CAAC;QAEtD,OAAO,EAAE,MAAM,EAAE,oBAAoB,CAAC,KAAK,EAAE,CAAC;IAChD,CAAC;IAED,gBAAgB;IACT,MAAM,CAAU,qBAAqB,CAAC,QAA+B;QAC1E,OAAO,IAAI,6BAA6B,CAAC,QAAQ,EAAE,gBAAgB,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;IACtG,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module MapLayersFormats\n */\n\nimport { ImageMapLayerSettings } from \"@itwin/core-common\";\nimport { ImageryMapLayerFormat, IModelApp, MapLayerImageryProvider, MapLayerSourceStatus, type MapLayerSourceValidation, type ValidateSourceArgs } from \"@itwin/core-frontend\";\nimport { MapLayersFormats } from \"../mapLayersFormats.js\";\nimport { AzureMapsLayerImageryProvider, getAzureMapsSubscriptionKey } from \"./AzureMapsImageryProvider.js\";\n\n/**\n * Azure Maps imagery layer format.\n * @beta\n */\nexport class AzureMapsMapLayerFormat extends ImageryMapLayerFormat {\n  /** Azure Maps imagery layer format.\n   * @beta\n   */\n  public static override formatId = \"AzureMaps\";\n\n  private static validateAzureSourceUrl(url: string): MapLayerSourceStatus {\n    let parsedUrl: URL;\n    try {\n      parsedUrl = new URL(url);\n    } catch {\n      return MapLayerSourceStatus.InvalidUrl;\n    }\n\n    if (!parsedUrl.protocol.startsWith(\"http\"))\n      return MapLayerSourceStatus.InvalidUrl;\n\n    if (parsedUrl.hostname !== \"atlas.microsoft.com\" || parsedUrl.pathname !== \"/map/tile\")\n      return MapLayerSourceStatus.IncompatibleFormat;\n\n    return parsedUrl.searchParams.has(\"tilesetId\") ? MapLayerSourceStatus.Valid : MapLayerSourceStatus.InvalidUrl;\n  }\n\n  public static override async validate(args: ValidateSourceArgs): Promise<MapLayerSourceValidation> {\n    const urlStatus = AzureMapsMapLayerFormat.validateAzureSourceUrl(args.source.url);\n    if (urlStatus !== MapLayerSourceStatus.Valid)\n      return { status: urlStatus };\n\n    const accessKey = IModelApp.mapLayerFormatRegistry.configOptions.AzureMaps;\n    if (undefined === getAzureMapsSubscriptionKey(accessKey, MapLayersFormats.azureMapsOpts?.subscriptionKey))\n      return { status: MapLayerSourceStatus.RequireAuth };\n\n    return { status: MapLayerSourceStatus.Valid };\n  }\n\n  /** @internal */\n  public static override createImageryProvider(settings: ImageMapLayerSettings): MapLayerImageryProvider | undefined {\n    return new AzureMapsLayerImageryProvider(settings, MapLayersFormats.azureMapsOpts?.subscriptionKey);\n  }\n}\n"]}

package/lib/esm/AzureMaps/AzureMapsImageryProvider.d.ts

@@ -0,0 +1,24 @@
+/** @packageDocumentation
+ * @module MapLayersFormats
+ */
+import { ImageMapLayerSettings, type ImageSource, type MapLayerKey } from "@itwin/core-common";
+import { MapLayerImageryProvider, ScreenViewport } from "@itwin/core-frontend";
+/** @internal */
+export declare const azureMapsSubscriptionKeyParameter = "subscription-key";
+/** @internal */
+export declare function getAzureMapsSubscriptionKey(accessKey: MapLayerKey | undefined, fallbackSubscriptionKey?: string): string | undefined;
+/**
+ * Azure Maps imagery provider.
+ * @beta
+ */
+export declare class AzureMapsLayerImageryProvider extends MapLayerImageryProvider {
+    private readonly _subscriptionKey?;
+    constructor(settings: ImageMapLayerSettings, _subscriptionKey?: string | undefined);
+    private reportAzureAuthFailure;
+    loadTile(row: number, column: number, zoomLevel: number): Promise<ImageSource | undefined>;
+    constructUrl(y: number, x: number, zoom: number): Promise<string>;
+    /** @deprecated in 5.0 - will not be removed until after 2026-06-13. Use [addAttributions] instead. */
+    addLogoCards(cards: HTMLTableElement): void;
+    addAttributions(cards: HTMLTableElement, _vp: ScreenViewport): Promise<void>;
+}
+//# sourceMappingURL=AzureMapsImageryProvider.d.ts.map

package/lib/esm/AzureMaps/AzureMapsImageryProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AzureMapsImageryProvider.d.ts","sourceRoot":"","sources":["../../../src/AzureMaps/AzureMapsImageryProvider.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,qBAAqB,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC/F,OAAO,EAAa,uBAAuB,EAA8E,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtK,gBAAgB;AAChB,eAAO,MAAM,iCAAiC,qBAAqB,CAAC;AAEpE,gBAAgB;AAChB,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,WAAW,GAAG,SAAS,EAAE,uBAAuB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOpI;AAQD;;;GAGG;AACH,qBAAa,6BAA8B,SAAQ,uBAAuB;IACpB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;gBAAnE,QAAQ,EAAE,qBAAqB,EAAmB,gBAAgB,CAAC,EAAE,MAAM,YAAA;IAI9F,OAAO,CAAC,sBAAsB;IAWR,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAsB1F,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQvF,sGAAsG;IACtF,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAOrC,eAAe,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAInG"}

package/lib/esm/AzureMaps/AzureMapsImageryProvider.js

@@ -0,0 +1,81 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module MapLayersFormats
+ */
+import { IModelApp, MapLayerImageryProvider, MapLayerImageryProviderStatus, NotifyMessageDetails, OutputMessagePriority } from "@itwin/core-frontend";
+/** @internal */
+export const azureMapsSubscriptionKeyParameter = "subscription-key";
+/** @internal */
+export function getAzureMapsSubscriptionKey(accessKey, fallbackSubscriptionKey) {
+    // A layer access key takes precedence, but an empty value falls through to the configured fallback
+    // rather than disabling auth outright.
+    if (accessKey !== undefined && accessKey.value.length > 0)
+        return accessKey.value;
+    return fallbackSubscriptionKey !== undefined && fallbackSubscriptionKey.length > 0 ? fallbackSubscriptionKey : undefined;
+}
+class AzureMapsRequireAuthError extends Error {
+    constructor() {
+        super(`Azure Maps requires a non-empty ${azureMapsSubscriptionKeyParameter} credential`);
+    }
+}
+/**
+ * Azure Maps imagery provider.
+ * @beta
+ */
+export class AzureMapsLayerImageryProvider extends MapLayerImageryProvider {
+    _subscriptionKey;
+    constructor(settings, _subscriptionKey) {
+        super(settings, true);
+        this._subscriptionKey = _subscriptionKey;
+    }
+    reportAzureAuthFailure() {
+        this.setStatus(MapLayerImageryProviderStatus.RequireAuth);
+        if (this._hasSuccessfullyFetchedTile) {
+            const msg = IModelApp.localization.getLocalizedString("iModelJs:MapLayers.Messages.LoadTileTokenError", { layerName: this._settings.name });
+            IModelApp.notifications.outputMessage(new NotifyMessageDetails(OutputMessagePriority.Warning, msg));
+        }
+    }
+    // The base loadTile marks `_hasSuccessfullyFetchedTile` as soon as a response is received, before
+    // inspecting its status. Azure returns 401/403 for missing/invalid credentials, so this override
+    // detects that before the success is recorded, ensuring no spurious token warning on the first fetch.
+    async loadTile(row, column, zoomLevel) {
+        try {
+            const tileUrl = await this.constructUrl(row, column, zoomLevel);
+            if (tileUrl.length === 0)
+                return undefined;
+            const tileResponse = await this.makeTileRequest(tileUrl);
+            if (tileResponse.status === 401 || tileResponse.status === 403) {
+                this.reportAzureAuthFailure();
+                return undefined;
+            }
+            this._hasSuccessfullyFetchedTile = true;
+            return await this.getImageFromTileResponse(tileResponse, zoomLevel);
+        }
+        catch (error) {
+            if (error instanceof AzureMapsRequireAuthError)
+                this.reportAzureAuthFailure();
+            return undefined;
+        }
+    }
+    async constructUrl(y, x, zoom) {
+        const subscriptionKey = getAzureMapsSubscriptionKey(this._settings.accessKey, this._subscriptionKey);
+        if (undefined === subscriptionKey)
+            throw new AzureMapsRequireAuthError();
+        return `${this._settings.url}&${azureMapsSubscriptionKeyParameter}=${encodeURIComponent(subscriptionKey)}&api-version=2.0&zoom=${zoom}&x=${x}&y=${y}`;
+    }
+    /** @deprecated in 5.0 - will not be removed until after 2026-06-13. Use [addAttributions] instead. */
+    addLogoCards(cards) {
+        if (!cards.dataset.azureMapsLogoCard) {
+            cards.dataset.azureMapsLogoCard = "true";
+            cards.appendChild(IModelApp.makeLogoCard({ heading: "Azure Maps", notice: IModelApp.localization.getLocalizedString("iModelJs:BackgroundMap.AzureMapsCopyright") }));
+        }
+    }
+    async addAttributions(cards, _vp) {
+        // eslint-disable-next-line @typescript-eslint/no-deprecated
+        return Promise.resolve(this.addLogoCards(cards));
+    }
+}
+//# sourceMappingURL=AzureMapsImageryProvider.js.map

package/lib/esm/AzureMaps/AzureMapsImageryProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AzureMapsImageryProvider.js","sourceRoot":"","sources":["../../../src/AzureMaps/AzureMapsImageryProvider.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module MapLayersFormats\n */\n\nimport { ImageMapLayerSettings, type ImageSource, type MapLayerKey } from \"@itwin/core-common\";\nimport { IModelApp, MapLayerImageryProvider, MapLayerImageryProviderStatus, NotifyMessageDetails, OutputMessagePriority, ScreenViewport } from \"@itwin/core-frontend\";\n\n/** @internal */\nexport const azureMapsSubscriptionKeyParameter = \"subscription-key\";\n\n/** @internal */\nexport function getAzureMapsSubscriptionKey(accessKey: MapLayerKey | undefined, fallbackSubscriptionKey?: string): string | undefined {\n  // A layer access key takes precedence, but an empty value falls through to the configured fallback\n  // rather than disabling auth outright.\n  if (accessKey !== undefined && accessKey.value.length > 0)\n    return accessKey.value;\n\n  return fallbackSubscriptionKey !== undefined && fallbackSubscriptionKey.length > 0 ? fallbackSubscriptionKey : undefined;\n}\n\nclass AzureMapsRequireAuthError extends Error {\n  public constructor() {\n    super(`Azure Maps requires a non-empty ${azureMapsSubscriptionKeyParameter} credential`);\n  }\n}\n\n/**\n * Azure Maps imagery provider.\n * @beta\n */\nexport class AzureMapsLayerImageryProvider extends MapLayerImageryProvider {\n  public constructor(settings: ImageMapLayerSettings, private readonly _subscriptionKey?: string) {\n    super(settings, true);\n  }\n\n  private reportAzureAuthFailure(): void {\n    this.setStatus(MapLayerImageryProviderStatus.RequireAuth);\n    if (this._hasSuccessfullyFetchedTile) {\n      const msg = IModelApp.localization.getLocalizedString(\"iModelJs:MapLayers.Messages.LoadTileTokenError\", { layerName: this._settings.name });\n      IModelApp.notifications.outputMessage(new NotifyMessageDetails(OutputMessagePriority.Warning, msg));\n    }\n  }\n\n  // The base loadTile marks `_hasSuccessfullyFetchedTile` as soon as a response is received, before\n  // inspecting its status. Azure returns 401/403 for missing/invalid credentials, so this override\n  // detects that before the success is recorded, ensuring no spurious token warning on the first fetch.\n  public override async loadTile(row: number, column: number, zoomLevel: number): Promise<ImageSource | undefined> {\n    try {\n      const tileUrl = await this.constructUrl(row, column, zoomLevel);\n      if (tileUrl.length === 0)\n        return undefined;\n\n      const tileResponse = await this.makeTileRequest(tileUrl);\n      if (tileResponse.status === 401 || tileResponse.status === 403) {\n        this.reportAzureAuthFailure();\n        return undefined;\n      }\n\n      this._hasSuccessfullyFetchedTile = true;\n      return await this.getImageFromTileResponse(tileResponse, zoomLevel);\n    } catch (error) {\n      if (error instanceof AzureMapsRequireAuthError)\n        this.reportAzureAuthFailure();\n\n      return undefined;\n    }\n  }\n\n  public override async constructUrl(y: number, x: number, zoom: number): Promise<string> {\n    const subscriptionKey = getAzureMapsSubscriptionKey(this._settings.accessKey, this._subscriptionKey);\n    if (undefined === subscriptionKey)\n      throw new AzureMapsRequireAuthError();\n\n    return `${this._settings.url}&${azureMapsSubscriptionKeyParameter}=${encodeURIComponent(subscriptionKey)}&api-version=2.0&zoom=${zoom}&x=${x}&y=${y}`;\n  }\n\n  /** @deprecated in 5.0 - will not be removed until after 2026-06-13. Use [addAttributions] instead. */\n  public override addLogoCards(cards: HTMLTableElement): void {\n    if (!cards.dataset.azureMapsLogoCard) {\n      cards.dataset.azureMapsLogoCard = \"true\";\n      cards.appendChild(IModelApp.makeLogoCard({ heading: \"Azure Maps\", notice: IModelApp.localization.getLocalizedString(\"iModelJs:BackgroundMap.AzureMapsCopyright\") }));\n    }\n  }\n\n  public override async addAttributions(cards: HTMLTableElement, _vp: ScreenViewport): Promise<void> {\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\n    return Promise.resolve(this.addLogoCards(cards));\n  }\n}\n"]}

package/lib/esm/map-layers-formats.d.ts

@@ -1,4 +1,6 @@
 export * from "./ArcGisFeature/ArcGisFeatureProvider.js";
+export * from "./AzureMaps/AzureMaps.js";
+export * from "./AzureMaps/AzureMapsImageryFormat.js";
 export * from "./GoogleMaps/GoogleMaps.js";
 export * from "./GoogleMaps/GoogleMapsSession.js";
 export * from "./GoogleMaps/GoogleMapsImageryFormat.js";

package/lib/esm/map-layers-formats.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"map-layers-formats.d.ts","sourceRoot":"","sources":["../../src/map-layers-formats.ts"],"names":[],"mappings":"AAKA,cAAc,0CAA0C,CAAC;AACzD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mCAAmC,CAAC;AAClD,cAAc,yCAAyC,CAAA;AACvD,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAE9C;;GAEG;AAEH;;GAEG"}
+{"version":3,"file":"map-layers-formats.d.ts","sourceRoot":"","sources":["../../src/map-layers-formats.ts"],"names":[],"mappings":"AAKA,cAAc,0CAA0C,CAAC;AACzD,cAAc,0BAA0B,CAAC;AACzC,cAAc,uCAAuC,CAAC;AACtD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mCAAmC,CAAC;AAClD,cAAc,yCAAyC,CAAA;AACvD,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAE9C;;GAEG;AAEH;;GAEG"}

package/lib/esm/map-layers-formats.js

@@ -3,6 +3,8 @@
 * See LICENSE.md in the project root for license terms and full copyright notice.
 *--------------------------------------------------------------------------------------------*/
 export * from "./ArcGisFeature/ArcGisFeatureProvider.js";
+export * from "./AzureMaps/AzureMaps.js";
+export * from "./AzureMaps/AzureMapsImageryFormat.js";
 export * from "./GoogleMaps/GoogleMaps.js";
 export * from "./GoogleMaps/GoogleMapsSession.js";
 export * from "./GoogleMaps/GoogleMapsImageryFormat.js";

package/lib/esm/map-layers-formats.js.map

@@ -1 +1 @@
-{"version":3,"file":"map-layers-formats.js","sourceRoot":"","sources":["../../src/map-layers-formats.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAE/F,cAAc,0CAA0C,CAAC;AACzD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mCAAmC,CAAC;AAClD,cAAc,yCAAyC,CAAA;AACvD,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAE9C;;GAEG;AAEH;;GAEG","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n\nexport * from \"./ArcGisFeature/ArcGisFeatureProvider.js\";\nexport * from \"./GoogleMaps/GoogleMaps.js\";\nexport * from \"./GoogleMaps/GoogleMapsSession.js\";\nexport * from \"./GoogleMaps/GoogleMapsImageryFormat.js\"\nexport * from \"./mapLayersFormats.js\";\nexport * from \"./Tools/MapFeatureInfoTool.js\";\n\n/** @docs-package-description\n * This package provides support for additional map layer formats that are not included in the @itwin/core-frontend package.\n */\n\n/** @docs-group-description MapLayersFormats\n * APIs for working with the map layer formats provided by this package.\n */\n"]}
+{"version":3,"file":"map-layers-formats.js","sourceRoot":"","sources":["../../src/map-layers-formats.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAE/F,cAAc,0CAA0C,CAAC;AACzD,cAAc,0BAA0B,CAAC;AACzC,cAAc,uCAAuC,CAAC;AACtD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mCAAmC,CAAC;AAClD,cAAc,yCAAyC,CAAA;AACvD,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAE9C;;GAEG;AAEH;;GAEG","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n\nexport * from \"./ArcGisFeature/ArcGisFeatureProvider.js\";\nexport * from \"./AzureMaps/AzureMaps.js\";\nexport * from \"./AzureMaps/AzureMapsImageryFormat.js\";\nexport * from \"./GoogleMaps/GoogleMaps.js\";\nexport * from \"./GoogleMaps/GoogleMapsSession.js\";\nexport * from \"./GoogleMaps/GoogleMapsImageryFormat.js\"\nexport * from \"./mapLayersFormats.js\";\nexport * from \"./Tools/MapFeatureInfoTool.js\";\n\n/** @docs-package-description\n * This package provides support for additional map layer formats that are not included in the @itwin/core-frontend package.\n */\n\n/** @docs-group-description MapLayersFormats\n * APIs for working with the map layer formats provided by this package.\n */\n"]}

package/lib/esm/mapLayersFormats.d.ts

@@ -6,6 +6,8 @@ import { GoogleMapsSessionManager } from "./map-layers-formats.js";
 export interface MapLayersFormatsConfig {
     localization?: Localization;
     googleMapsOpts?: GoogleMapsOptions;
+    /** Azure Maps options. */
+    azureMapsOpts?: AzureMapsOptions;
 }
 /** Google Maps options.
  * @beta
@@ -13,6 +15,13 @@ export interface MapLayersFormatsConfig {
 export interface GoogleMapsOptions {
     sessionManager?: GoogleMapsSessionManager;
 }
+/** Azure Maps options.
+ * @beta
+ */
+export interface AzureMapsOptions {
+    /** Azure Maps subscription key used when a layer does not supply its own access key. */
+    subscriptionKey?: string;
+}
 /** The primary API for the `@itwin/map-layers-formats` package. It allows the package's features to be [[initialize]]d.
  * @beta
  */
@@ -20,6 +29,7 @@ export declare class MapLayersFormats {
     private static _defaultNs;
     static localization: Localization;
     private static _googleMapsOpts?;
+    private static _azureMapsOpts?;
     /** Registers the [MapLayerFormat]($frontend)s provided by this package for use with [IModelApp]($frontend).
      * Typically, an application will call `MapLayersFormats.initialize` immediately after [IModelApp.startup]($frontend).
      * This function has no effect if called **before** [IModelApp.startup]($frontend) or **after** [IModelApp.shutdown]($frontend).
@@ -28,5 +38,7 @@ export declare class MapLayersFormats {
     /** The internationalization service namespace. */
     static get localizationNamespace(): string;
     static get googleMapsOpts(): GoogleMapsOptions | undefined;
+    /** Azure Maps options supplied during initialization. */
+    static get azureMapsOpts(): AzureMapsOptions | undefined;
 }
 //# sourceMappingURL=mapLayersFormats.d.ts.map

package/lib/esm/mapLayersFormats.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mapLayersFormats.d.ts","sourceRoot":"","sources":["../../src/mapLayersFormats.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAMlD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,cAAc,CAAC,EAAE,iBAAiB,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,cAAc,CAAC,EAAE,wBAAwB,CAAA;CAC1C;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAE3B,OAAO,CAAC,MAAM,CAAC,UAAU,CAAsB;IAC/C,OAAc,YAAY,EAAE,YAAY,CAAC;IAEzC,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,CAAoB;IAEnD;;;OAGG;WACiB,UAAU,CAAC,MAAM,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB9E,kDAAkD;IAClD,WAAkB,qBAAqB,IAAI,MAAM,CAEhD;IAED,WAAkB,cAAc,kCAE/B;CAEF"}
+{"version":3,"file":"mapLayersFormats.d.ts","sourceRoot":"","sources":["../../src/mapLayersFormats.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOlD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,cAAc,CAAC,EAAE,iBAAiB,CAAC;IACnC,0BAA0B;IAC1B,aAAa,CAAC,EAAE,gBAAgB,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,cAAc,CAAC,EAAE,wBAAwB,CAAA;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wFAAwF;IACxF,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAE3B,OAAO,CAAC,MAAM,CAAC,UAAU,CAAsB;IAC/C,OAAc,YAAY,EAAE,YAAY,CAAC;IAEzC,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,CAAoB;IACnD,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAmB;IAEjD;;;OAGG;WACiB,UAAU,CAAC,MAAM,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB9E,kDAAkD;IAClD,WAAkB,qBAAqB,IAAI,MAAM,CAEhD;IAED,WAAkB,cAAc,kCAE/B;IAED,yDAAyD;IACzD,WAAkB,aAAa,iCAE9B;CAEF"}

package/lib/esm/mapLayersFormats.js

@@ -8,6 +8,7 @@
 import { assert } from "@itwin/core-bentley";
 import { IModelApp } from "@itwin/core-frontend";
 import { ArcGisFeatureMapLayerFormat } from "./ArcGisFeature/ArcGisFeatureFormat.js";
+import { AzureMapsMapLayerFormat } from "./AzureMaps/AzureMapsImageryFormat.js";
 import { GoogleMapsMapLayerFormat } from "./GoogleMaps/GoogleMapsImageryFormat.js";
 import { OgcApiFeaturesMapLayerFormat } from "./OgcApiFeatures/OgcApiFeaturesFormat.js";
 import { MapFeatureInfoTool } from "./Tools/MapFeatureInfoTool.js";
@@ -18,6 +19,7 @@ export class MapLayersFormats {
     static _defaultNs = "mapLayersFormats";
     static localization;
     static _googleMapsOpts;
+    static _azureMapsOpts;
     /** Registers the [MapLayerFormat]($frontend)s provided by this package for use with [IModelApp]($frontend).
      * Typically, an application will call `MapLayersFormats.initialize` immediately after [IModelApp.startup]($frontend).
      * This function has no effect if called **before** [IModelApp.startup]($frontend) or **after** [IModelApp.shutdown]($frontend).
@@ -28,12 +30,14 @@ export class MapLayersFormats {
             IModelApp.mapLayerFormatRegistry.register(ArcGisFeatureMapLayerFormat);
             IModelApp.mapLayerFormatRegistry.register(OgcApiFeaturesMapLayerFormat);
             IModelApp.mapLayerFormatRegistry.register(GoogleMapsMapLayerFormat);
+            IModelApp.mapLayerFormatRegistry.register(AzureMapsMapLayerFormat);
         }
         // register namespace containing localized strings for this package
         MapLayersFormats.localization = config?.localization ?? IModelApp.localization;
         await MapLayersFormats.localization.registerNamespace(MapLayersFormats.localizationNamespace);
         MapFeatureInfoTool.register(MapLayersFormats.localizationNamespace);
         MapLayersFormats._googleMapsOpts = config?.googleMapsOpts;
+        MapLayersFormats._azureMapsOpts = config?.azureMapsOpts;
     }
     /** The internationalization service namespace. */
     static get localizationNamespace() {
@@ -42,5 +46,9 @@ export class MapLayersFormats {
     static get googleMapsOpts() {
         return MapLayersFormats._googleMapsOpts;
     }
+    /** Azure Maps options supplied during initialization. */
+    static get azureMapsOpts() {
+        return MapLayersFormats._azureMapsOpts;
+    }
 }
 //# sourceMappingURL=mapLayersFormats.js.map

package/lib/esm/mapLayersFormats.js.map

@@ -1 +1 @@
-{"version":3,"file":"mapLayersFormats.js","sourceRoot":"","sources":["../../src/mapLayersFormats.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAE/F;;GAEG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAC;AACrF,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AACnF,OAAO,EAAE,4BAA4B,EAAE,MAAM,0CAA0C,CAAC;AACxF,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAkBnE;;GAEG;AACH,MAAM,OAAO,gBAAgB;IAEnB,MAAM,CAAC,UAAU,GAAG,kBAAkB,CAAC;IACxC,MAAM,CAAC,YAAY,CAAe;IAEjC,MAAM,CAAC,eAAe,CAAqB;IAEnD;;;OAGG;IACI,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,MAA+B;QAC5D,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,kGAAkG,CAAC,CAAC;QAClI,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;YAC1B,SAAS,CAAC,sBAAsB,CAAC,QAAQ,CAAC,2BAA2B,CAAC,CAAC;YACvE,SAAS,CAAC,sBAAsB,CAAC,QAAQ,CAAC,4BAA4B,CAAC,CAAC;YACxE,SAAS,CAAC,sBAAsB,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAAC;QACtE,CAAC;QAED,mEAAmE;QACnE,gBAAgB,CAAC,YAAY,GAAG,MAAM,EAAE,YAAY,IAAI,SAAS,CAAC,YAAY,CAAC;QAC/E,MAAM,gBAAgB,CAAC,YAAY,CAAC,iBAAiB,CACnD,gBAAgB,CAAC,qBAAqB,CACvC,CAAC;QAEF,kBAAkB,CAAC,QAAQ,CAAC,gBAAgB,CAAC,qBAAqB,CAAC,CAAC;QACpE,gBAAgB,CAAC,eAAe,GAAG,MAAM,EAAE,cAAc,CAAC;IAC5D,CAAC;IAED,kDAAkD;IAC3C,MAAM,KAAK,qBAAqB;QACrC,OAAO,gBAAgB,CAAC,UAAU,CAAC;IACrC,CAAC;IAEM,MAAM,KAAK,cAAc;QAC9B,OAAO,gBAAgB,CAAC,eAAe,CAAC;IAC1C,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n\n/** @packageDocumentation\n * @module MapLayersFormats\n */\nimport { assert } from \"@itwin/core-bentley\";\nimport { Localization } from \"@itwin/core-common\";\nimport { IModelApp } from \"@itwin/core-frontend\";\nimport { ArcGisFeatureMapLayerFormat } from \"./ArcGisFeature/ArcGisFeatureFormat.js\";\nimport { GoogleMapsMapLayerFormat } from \"./GoogleMaps/GoogleMapsImageryFormat.js\";\nimport { OgcApiFeaturesMapLayerFormat } from \"./OgcApiFeatures/OgcApiFeaturesFormat.js\";\nimport { MapFeatureInfoTool } from \"./Tools/MapFeatureInfoTool.js\";\nimport { GoogleMapsSessionManager } from \"./map-layers-formats.js\";\n\n/** Configuration options.\n * @beta\n */\nexport interface MapLayersFormatsConfig {\n  localization?: Localization;\n  googleMapsOpts?: GoogleMapsOptions;\n}\n\n/** Google Maps options.\n * @beta\n */\nexport interface GoogleMapsOptions {\n  sessionManager?: GoogleMapsSessionManager\n}\n\n/** The primary API for the `@itwin/map-layers-formats` package. It allows the package's features to be [[initialize]]d.\n * @beta\n */\nexport class MapLayersFormats {\n\n  private static _defaultNs = \"mapLayersFormats\";\n  public static localization: Localization;\n\n  private static _googleMapsOpts?: GoogleMapsOptions;\n\n  /** Registers the [MapLayerFormat]($frontend)s provided by this package for use with [IModelApp]($frontend).\n   * Typically, an application will call `MapLayersFormats.initialize` immediately after [IModelApp.startup]($frontend).\n   * This function has no effect if called **before** [IModelApp.startup]($frontend) or **after** [IModelApp.shutdown]($frontend).\n   */\n  public static async initialize(config?: MapLayersFormatsConfig): Promise<void> {\n    assert(IModelApp.initialized, \"MapLayersFormats.initialize must be called after IModelApp.startup and before IModelApp.shutdown\");\n    if (IModelApp.initialized) {\n      IModelApp.mapLayerFormatRegistry.register(ArcGisFeatureMapLayerFormat);\n      IModelApp.mapLayerFormatRegistry.register(OgcApiFeaturesMapLayerFormat);\n      IModelApp.mapLayerFormatRegistry.register(GoogleMapsMapLayerFormat);\n    }\n\n    // register namespace containing localized strings for this package\n    MapLayersFormats.localization = config?.localization ?? IModelApp.localization;\n    await MapLayersFormats.localization.registerNamespace(\n      MapLayersFormats.localizationNamespace,\n    );\n\n    MapFeatureInfoTool.register(MapLayersFormats.localizationNamespace);\n    MapLayersFormats._googleMapsOpts = config?.googleMapsOpts;\n  }\n\n  /** The internationalization service namespace. */\n  public static get localizationNamespace(): string {\n    return MapLayersFormats._defaultNs;\n  }\n\n  public static get googleMapsOpts() {\n    return MapLayersFormats._googleMapsOpts;\n  }\n\n}\n"]}
+{"version":3,"file":"mapLayersFormats.js","sourceRoot":"","sources":["../../src/mapLayersFormats.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAE/F;;GAEG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAC;AACrF,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AACnF,OAAO,EAAE,4BAA4B,EAAE,MAAM,0CAA0C,CAAC;AACxF,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AA4BnE;;GAEG;AACH,MAAM,OAAO,gBAAgB;IAEnB,MAAM,CAAC,UAAU,GAAG,kBAAkB,CAAC;IACxC,MAAM,CAAC,YAAY,CAAe;IAEjC,MAAM,CAAC,eAAe,CAAqB;IAC3C,MAAM,CAAC,cAAc,CAAoB;IAEjD;;;OAGG;IACI,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,MAA+B;QAC5D,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,kGAAkG,CAAC,CAAC;QAClI,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;YAC1B,SAAS,CAAC,sBAAsB,CAAC,QAAQ,CAAC,2BAA2B,CAAC,CAAC;YACvE,SAAS,CAAC,sBAAsB,CAAC,QAAQ,CAAC,4BAA4B,CAAC,CAAC;YACxE,SAAS,CAAC,sBAAsB,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAAC;YACpE,SAAS,CAAC,sBAAsB,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC;QACrE,CAAC;QAED,mEAAmE;QACnE,gBAAgB,CAAC,YAAY,GAAG,MAAM,EAAE,YAAY,IAAI,SAAS,CAAC,YAAY,CAAC;QAC/E,MAAM,gBAAgB,CAAC,YAAY,CAAC,iBAAiB,CACnD,gBAAgB,CAAC,qBAAqB,CACvC,CAAC;QAEF,kBAAkB,CAAC,QAAQ,CAAC,gBAAgB,CAAC,qBAAqB,CAAC,CAAC;QACpE,gBAAgB,CAAC,eAAe,GAAG,MAAM,EAAE,cAAc,CAAC;QAC1D,gBAAgB,CAAC,cAAc,GAAG,MAAM,EAAE,aAAa,CAAC;IAC1D,CAAC;IAED,kDAAkD;IAC3C,MAAM,KAAK,qBAAqB;QACrC,OAAO,gBAAgB,CAAC,UAAU,CAAC;IACrC,CAAC;IAEM,MAAM,KAAK,cAAc;QAC9B,OAAO,gBAAgB,CAAC,eAAe,CAAC;IAC1C,CAAC;IAED,yDAAyD;IAClD,MAAM,KAAK,aAAa;QAC7B,OAAO,gBAAgB,CAAC,cAAc,CAAC;IACzC,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n\n/** @packageDocumentation\n * @module MapLayersFormats\n */\nimport { assert } from \"@itwin/core-bentley\";\nimport { Localization } from \"@itwin/core-common\";\nimport { IModelApp } from \"@itwin/core-frontend\";\nimport { ArcGisFeatureMapLayerFormat } from \"./ArcGisFeature/ArcGisFeatureFormat.js\";\nimport { AzureMapsMapLayerFormat } from \"./AzureMaps/AzureMapsImageryFormat.js\";\nimport { GoogleMapsMapLayerFormat } from \"./GoogleMaps/GoogleMapsImageryFormat.js\";\nimport { OgcApiFeaturesMapLayerFormat } from \"./OgcApiFeatures/OgcApiFeaturesFormat.js\";\nimport { MapFeatureInfoTool } from \"./Tools/MapFeatureInfoTool.js\";\nimport { GoogleMapsSessionManager } from \"./map-layers-formats.js\";\n\n/** Configuration options.\n * @beta\n */\nexport interface MapLayersFormatsConfig {\n  localization?: Localization;\n  googleMapsOpts?: GoogleMapsOptions;\n  /** Azure Maps options. */\n  azureMapsOpts?: AzureMapsOptions;\n}\n\n/** Google Maps options.\n * @beta\n */\nexport interface GoogleMapsOptions {\n  sessionManager?: GoogleMapsSessionManager\n}\n\n/** Azure Maps options.\n * @beta\n */\nexport interface AzureMapsOptions {\n  /** Azure Maps subscription key used when a layer does not supply its own access key. */\n  subscriptionKey?: string;\n}\n\n/** The primary API for the `@itwin/map-layers-formats` package. It allows the package's features to be [[initialize]]d.\n * @beta\n */\nexport class MapLayersFormats {\n\n  private static _defaultNs = \"mapLayersFormats\";\n  public static localization: Localization;\n\n  private static _googleMapsOpts?: GoogleMapsOptions;\n  private static _azureMapsOpts?: AzureMapsOptions;\n\n  /** Registers the [MapLayerFormat]($frontend)s provided by this package for use with [IModelApp]($frontend).\n   * Typically, an application will call `MapLayersFormats.initialize` immediately after [IModelApp.startup]($frontend).\n   * This function has no effect if called **before** [IModelApp.startup]($frontend) or **after** [IModelApp.shutdown]($frontend).\n   */\n  public static async initialize(config?: MapLayersFormatsConfig): Promise<void> {\n    assert(IModelApp.initialized, \"MapLayersFormats.initialize must be called after IModelApp.startup and before IModelApp.shutdown\");\n    if (IModelApp.initialized) {\n      IModelApp.mapLayerFormatRegistry.register(ArcGisFeatureMapLayerFormat);\n      IModelApp.mapLayerFormatRegistry.register(OgcApiFeaturesMapLayerFormat);\n      IModelApp.mapLayerFormatRegistry.register(GoogleMapsMapLayerFormat);\n      IModelApp.mapLayerFormatRegistry.register(AzureMapsMapLayerFormat);\n    }\n\n    // register namespace containing localized strings for this package\n    MapLayersFormats.localization = config?.localization ?? IModelApp.localization;\n    await MapLayersFormats.localization.registerNamespace(\n      MapLayersFormats.localizationNamespace,\n    );\n\n    MapFeatureInfoTool.register(MapLayersFormats.localizationNamespace);\n    MapLayersFormats._googleMapsOpts = config?.googleMapsOpts;\n    MapLayersFormats._azureMapsOpts = config?.azureMapsOpts;\n  }\n\n  /** The internationalization service namespace. */\n  public static get localizationNamespace(): string {\n    return MapLayersFormats._defaultNs;\n  }\n\n  public static get googleMapsOpts() {\n    return MapLayersFormats._googleMapsOpts;\n  }\n\n  /** Azure Maps options supplied during initialization. */\n  public static get azureMapsOpts() {\n    return MapLayersFormats._azureMapsOpts;\n  }\n\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itwin/map-layers-formats",
-  "version": "5.10.2",
+  "version": "5.11.0-dev.10",
   "description": "Enables additional map-layers formats in iTwin.js",
   "main": "lib/cjs/map-layers-formats.js",
   "module": "lib/esm/map-layers-formats.js",
@@ -52,20 +52,20 @@
     "source-map-support": "^0.5.6",
     "typescript": "~5.6.2",
     "fetch-mock": "~11.1.3",
-    "@itwin/appui-abstract": "5.10.2",
-    "@itwin/build-tools": "5.10.2",
-    "@itwin/core-bentley": "5.10.2",
-    "@itwin/core-common": "5.10.2",
+    "@itwin/appui-abstract": "5.11.0-dev.10",
+    "@itwin/build-tools": "5.11.0-dev.10",
     "internal-tools": "3.0.0-dev.69",
-    "@itwin/core-frontend": "5.10.2",
-    "@itwin/core-geometry": "5.10.2"
+    "@itwin/core-geometry": "5.11.0-dev.10",
+    "@itwin/core-bentley": "5.11.0-dev.10",
+    "@itwin/core-frontend": "5.11.0-dev.10",
+    "@itwin/core-common": "5.11.0-dev.10"
   },
   "peerDependencies": {
-    "@itwin/appui-abstract": "5.10.2",
-    "@itwin/core-bentley": "5.10.2",
-    "@itwin/core-frontend": "5.10.2",
-    "@itwin/core-common": "5.10.2",
-    "@itwin/core-geometry": "5.10.2"
+    "@itwin/core-bentley": "5.11.0-dev.10",
+    "@itwin/core-frontend": "5.11.0-dev.10",
+    "@itwin/core-common": "5.11.0-dev.10",
+    "@itwin/appui-abstract": "5.11.0-dev.10",
+    "@itwin/core-geometry": "5.11.0-dev.10"
   },
   "dependencies": {
     "google-protobuf": "~3.20.1",