@itwin/map-layers-formats 5.0.0-dev.67 → 5.0.0-dev.69

package/lib/esm/GoogleMaps/GoogleMapDecorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoogleMapDecorator.js","sourceRoot":"","sources":["../../../src/GoogleMaps/GoogleMapDecorator.ts"],"names":[],"mappings":"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","sourcesContent":["import { CanvasDecoration, DecorateContext, Decorator, IconSprites, IModelApp, Sprite } from \"@itwin/core-frontend\";\nimport { Point3d } from \"@itwin/core-geometry\";\nimport { GoogleMapsMapTypes } from \"./GoogleMaps\";\n\n\n/** A simple decorator that show logo at the a given screen position.\n * @internal\n */\nexport class LogoDecoration implements CanvasDecoration {\n  private _sprite?: Sprite;\n\n  /** The current position of the logo in view coordinates. */\n  public readonly position = new Point3d();\n\n  private _offset: Point3d|undefined;\n\n  public set offset(offset: Point3d|undefined) {\n      this._offset = offset;\n    }\n\n  /** The logo offset in view coordinates.*/\n  public get offset() {\n    return this._offset;\n  }\n\n  /** Move the logo to the lower left corner of the screen. */\n  public moveToLowerLeftCorner(context: DecorateContext) : boolean{\n    if (!this._sprite || !this._sprite.isLoaded)\n      return false;\n\n    this.position.x = this._offset?.x ?? 0;\n    this.position.y =  context.viewport.parentDiv.clientHeight - this._sprite.size.y;\n    if (this._offset?.y)\n      this.position.y -= this._offset.y;\n    return true;\n  }\n\n  /* TODO: Add other move methods as needed */\n\n  /** Indicate if the logo is loaded and ready to be drawn. */\n  public get isLoaded() { return this._sprite?.isLoaded ?? false; }\n\n  public async activate(sprite: Sprite): Promise<boolean> {\n    this._sprite = sprite;\n    return new Promise<boolean>((resolve, _reject) => {\n      sprite.loadPromise.then(() => {\n        resolve(true);\n      }).catch(() => {\n        resolve (false);\n      });\n    });\n  }\n\n  /** Draw this sprite onto the supplied canvas.\n   * @see [[CanvasDecoration.drawDecoration]]\n   */\n  public drawDecoration(ctx: CanvasRenderingContext2D): void {\n    if (this.isLoaded) {\n    // Draw image with an origin at the top left corner\n    ctx.drawImage(this._sprite!.image!, 0, 0);\n    }\n  }\n\n  public decorate(context: DecorateContext) {\n    context.addCanvasDecoration(this);\n  }\n}\n\n/** A decorator that adds the Google Maps logo to the lower left corner of the screen.\n * @internal\n*/\nexport class GoogleMapsDecorator implements Decorator {\n  public readonly logo = new LogoDecoration();\n\n  /** Activate the logo based on the given map type. */\n  public async activate(mapType: GoogleMapsMapTypes): Promise<boolean> {\n    // Pick the logo that is the most visible on the background map\n    const imageName = mapType === \"roadmap\" ?\n    \"google_on_white\" :\n    \"google_on_non_white\";\n\n    // We need to move the logo right after the 'i.js' button\n    this.logo.offset = new Point3d(45, 10);\n\n    return this.logo.activate(IconSprites.getSpriteFromUrl(`${IModelApp.publicPath}images/${imageName}.png`));\n  };\n\n  /** Decorate implementation */\n  public decorate = (context: DecorateContext) => {\n    if (!this.logo.isLoaded)\n      return;\n    this.logo.moveToLowerLeftCorner(context);\n    this.logo.decorate(context);\n  };\n}\n"]}

package/lib/esm/GoogleMaps/GoogleMaps.d.ts

@@ -0,0 +1,166 @@
+/** @packageDocumentation
+ * @module MapLayersFormats
+ */
+import { BaseMapLayerSettings, ImageMapLayerSettings } from "@itwin/core-common";
+import { MapCartoRectangle } from "@itwin/core-frontend";
+/**
+ * The type of base map.
+ * @beta*/
+export type GoogleMapsLayerTypes = "layerRoadmap" | "layerStreetview";
+/**
+ *  Layer types that can be added to the map.
+ * @beta
+ * */
+export type GoogleMapsMapTypes = "roadmap" | "satellite" | "terrain";
+/**
+ * Scale factors that can be applied to labels and objects in the map.
+ * @beta
+ * */
+export type GoogleMapsScaleFactors = "scaleFactor1x" | "scaleFactor2x" | "scaleFactor4x";
+/**
+* Represents the options to create a Google Maps session.
+* @beta
+*/
+export interface GoogleMapsCreateSessionOptions {
+    /**
+   * The type of base map.
+   *
+   * `roadmap`: The standard Google Maps painted map tiles.
+   *
+   * `satellite`: Satellite imagery.
+   *
+   * `terrain`: Terrain imagery. When selecting `terrain` as the map type, you must also include the `layerRoadmap` layer type.
+   * @beta
+   * */
+    mapType: GoogleMapsMapTypes;
+    /**
+     * An {@link https://en.wikipedia.org/wiki/IETF_language_tag | IETF language tag} that specifies the language used to display information on the tiles. For example, `en-US` specifies the English language as spoken in the United States.
+     */
+    language: string;
+    /**
+    * A {@link https://cldr.unicode.org/ | Common Locale Data Repository}  region identifier (two uppercase letters) that represents the physical location of the user. For example, `US`.
+    */
+    region: string;
+    /**
+     * An array of values that specifies the layer types added to the map.
+     *
+     * `layerRoadmap`: Required if you specify terrain as the map type. Can also be optionally overlaid on the satellite map type. Has no effect on roadmap tiles.
+     *
+     * `layerStreetview`: Shows Street View-enabled streets and locations using blue outlines on the map.
+     *
+     * @beta
+     * */
+    layerTypes?: GoogleMapsLayerTypes[];
+    /**
+     * Scales-up the size of map elements (such as road labels), while retaining the tile size and coverage area of the default tile.
+     * Increasing the scale also reduces the number of labels on the map, which reduces clutter.
+     *
+     * `scaleFactor1x`: The default.
+     *
+     * `scaleFactor2x`: Doubles label size and removes minor feature labels.
+     *
+     * `scaleFactor4x`: Quadruples label size and removes minor feature labels.
+     * @beta
+     * */
+    scale?: GoogleMapsScaleFactors;
+    /**
+     * A boolean value that specifies whether layerTypes should be rendered as a separate overlay, or combined with the base imagery.
+     * When true, the base map isn't displayed. If you haven't defined any layerTypes, then this value is ignored.
+     * Default is false.
+     * @beta
+     * */
+    overlay?: boolean;
+    /**
+     * An array of values specifying additional options to apply.
+     * @beta
+     * */
+    apiOptions?: string[];
+}
+/**
+* Structure representing a Google Maps session.
+* @beta
+*/
+export interface GoogleMapsSession {
+    /** A session token value that you must include in all of your Map Tiles API requests. */
+    session: string;
+    /**  string that contains the time (in seconds since the epoch) at which the token expires. A session token is valid for two weeks from its creation time, but this policy might change without notice. */
+    expiry: number;
+    /** The width of the tiles measured in pixels. */
+    tileWidth: number;
+    /** he height of the tiles measured in pixels. */
+    tileHeight: number;
+    /** The image format, which can be either `png` or `jpeg`. */
+    imageFormat: string;
+}
+/**
+ * Represents the maximum zoom level available within a bounding rectangle.
+* @beta
+*/
+export interface MaxZoomRectangle {
+    maxZoom: number;
+    north: number;
+    south: number;
+    east: number;
+    west: number;
+}
+/**
+ * Indicate which areas of given viewport have imagery, and at which zoom levels.
+ * @beta
+*/
+export interface ViewportInfo {
+    /**  Attribution string that you must display on your map when you display roadmap and satellite tiles. */
+    copyright: string;
+    /** Array of bounding rectangles that overlap with the current viewport. Also contains the maximum zoom level available within each rectangle.. */
+    maxZoomRects: MaxZoomRectangle[];
+}
+/**
+ * Request parameters for the getViewportInfo method.
+ * @beta
+*/
+export interface ViewportInfoRequestParams {
+    /** Bounding rectangle */
+    rectangle: MapCartoRectangle;
+    /** Session token */
+    session: string;
+    /** The Google Cloud API key */
+    key: string;
+    /** Zoom level of the viewport */
+    zoom: number;
+}
+/**
+ * Google Maps API
+ * @beta
+*/
+export declare const GoogleMaps: {
+    /**
+     * Creates Google Maps map-layer settings.
+     * @param name Name of the layer (Defaults to "GoogleMaps")
+     * @param opts Options to create the session  (Defaults to satellite map type, English language, US region, and roadmap layer type)
+     *
+     * The following examples illustrates how a Googles Map layer can be attached to a viewport:
+     * ```ts
+     * [[include:GoogleMaps_AttachMapLayerSimple]]
+     * ```
+     * ```ts
+     * [[include:GoogleMaps_AttachMapLayerOpts]]
+     * ```
+     * @beta
+    */
+    createMapLayerSettings: (name?: string, opts?: GoogleMapsCreateSessionOptions) => ImageMapLayerSettings;
+    /**
+     * Creates Google Maps base layer settings.
+     * @param name Name of the layer (Defaults to "GoogleMaps")
+     * @param opts Options to create the session  (Defaults to satellite map type, English language, US region, and roadmap layer type)
+     *
+     * The following examples illustrates how a Google Maps base layer can be set on a viewport:
+     * ```ts
+     * [[include:GoogleMaps_BaseMapSimple]]
+     * ```
+     * ```ts
+     * [[include:GoogleMaps_BaseMapOpts]]
+     * ```
+     * @beta
+    */
+    createBaseLayerSettings: (opts?: GoogleMapsCreateSessionOptions) => BaseMapLayerSettings;
+};
+//# sourceMappingURL=GoogleMaps.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GoogleMaps.d.ts","sourceRoot":"","sources":["../../../src/GoogleMaps/GoogleMaps.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAIzD;;UAEU;AACV,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG,iBAAiB,CAAC;AAEtE;;;KAGK;AACL,MAAM,MAAM,kBAAkB,GAAI,SAAS,GAAC,WAAW,GAAC,SAAS,CAAC;AAElE;;;KAGK;AACL,MAAM,MAAM,sBAAsB,GAAI,eAAe,GAAG,eAAe,GAAG,eAAe,CAAC;AAE1F;;;EAGE;AACF,MAAM,WAAW,8BAA8B;IAC3C;;;;;;;;;OASG;IACL,OAAO,EAAE,kBAAkB,CAAC;IAC5B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACf;;MAEE;IACJ,MAAM,EAAE,MAAM,CAAC;IAEf;;;;;;;;SAQK;IACL,UAAU,CAAC,EAAE,oBAAoB,EAAE,CAAC;IAEpC;;;;;;;;;;SAUK;IACL,KAAK,CAAC,EAAE,sBAAsB,CAAA;IAE9B;;;;;SAKK;IACH,OAAO,CAAC,EAAG,OAAO,CAAC;IAEnB;;;SAGK;IACL,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;EAGE;AACF,MAAM,WAAW,iBAAiB;IAChC,yFAAyF;IACzF,OAAO,EAAE,MAAM,CAAC;IAEhB,0MAA0M;IAC1M,MAAM,EAAE,MAAM,CAAC;IAEf,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAElB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;IAEnB,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;EAGE;AACF,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;EAGE;AACF,MAAM,WAAW,YAAY;IAC3B,0GAA0G;IAC1G,SAAS,EAAE,MAAM,CAAC;IAElB,kJAAkJ;IAClJ,YAAY,EAAE,gBAAgB,EAAE,CAAC;CAClC;AAED;;;EAGE;AACF,MAAM,WAAW,yBAAyB;IACxC,yBAAyB;IACzB,SAAS,EAAE,iBAAiB,CAAC;IAE7B,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAEhB,+BAA+B;IAC/B,GAAG,EAAE,MAAM,CAAC;IAEZ,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;EAGE;AAEF,eAAO,MAAM,UAAU;IACvB;;;;;;;;;;;;;MAaE;oCACgC,MAAM,SAAS,8BAA8B;IAI/E;;;;;;;;;;;;;MAaE;qCACiC,8BAA8B;CAGhE,CAAC"}

package/lib/esm/GoogleMaps/GoogleMaps.js

@@ -0,0 +1,53 @@
+/*---------------------------------------------------------------------------------------------
+* 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 { BaseMapLayerSettings, ImageMapLayerSettings } from "@itwin/core-common";
+import { GoogleMapsUtils } from "../internal/GoogleMapsUtils";
+;
+;
+/**
+ * Google Maps API
+ * @beta
+*/
+// eslint-disable-next-line @typescript-eslint/naming-convention
+export const GoogleMaps = {
+    /**
+     * Creates Google Maps map-layer settings.
+     * @param name Name of the layer (Defaults to "GoogleMaps")
+     * @param opts Options to create the session  (Defaults to satellite map type, English language, US region, and roadmap layer type)
+     *
+     * The following examples illustrates how a Googles Map layer can be attached to a viewport:
+     * ```ts
+     * [[include:GoogleMaps_AttachMapLayerSimple]]
+     * ```
+     * ```ts
+     * [[include:GoogleMaps_AttachMapLayerOpts]]
+     * ```
+     * @beta
+    */
+    createMapLayerSettings: (name, opts) => {
+        return ImageMapLayerSettings.fromJSON(GoogleMapsUtils.createMapLayerProps(name, opts));
+    },
+    /**
+     * Creates Google Maps base layer settings.
+     * @param name Name of the layer (Defaults to "GoogleMaps")
+     * @param opts Options to create the session  (Defaults to satellite map type, English language, US region, and roadmap layer type)
+     *
+     * The following examples illustrates how a Google Maps base layer can be set on a viewport:
+     * ```ts
+     * [[include:GoogleMaps_BaseMapSimple]]
+     * ```
+     * ```ts
+     * [[include:GoogleMaps_BaseMapOpts]]
+     * ```
+     * @beta
+    */
+    createBaseLayerSettings: (opts) => {
+        return BaseMapLayerSettings.fromJSON(GoogleMapsUtils.createMapLayerProps("GoogleMaps", opts));
+    }
+};
+//# sourceMappingURL=GoogleMaps.js.map

package/lib/esm/GoogleMaps/GoogleMaps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoogleMaps.js","sourceRoot":"","sources":["../../../src/GoogleMaps/GoogleMaps.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEjF,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAkF7D,CAAC;AAqBD,CAAC;AA4CF;;;EAGE;AACF,gEAAgE;AAChE,MAAM,CAAC,MAAM,UAAU,GAAG;IAC1B;;;;;;;;;;;;;MAaE;IACA,sBAAsB,EAAE,CAAC,IAAa,EAAE,IAAqC,EAAE,EAAE;QAC/E,OAAO,qBAAqB,CAAC,QAAQ,CAAC,eAAe,CAAC,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IACzF,CAAC;IAEH;;;;;;;;;;;;;MAaE;IACA,uBAAuB,EAAE,CAAC,IAAqC,EAAE,EAAE;QACjE,OAAO,oBAAoB,CAAC,QAAQ,CAAC,eAAe,CAAC,mBAAmB,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC;IAChG,CAAC;CACF,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 { BaseMapLayerSettings, ImageMapLayerSettings } from \"@itwin/core-common\";\nimport { MapCartoRectangle } from \"@itwin/core-frontend\";\nimport { GoogleMapsUtils } from \"../internal/GoogleMapsUtils\";\n\n\n/**\n * The type of base map.\n * @beta*/\nexport type GoogleMapsLayerTypes = \"layerRoadmap\" | \"layerStreetview\";\n\n/**\n *  Layer types that can be added to the map.\n * @beta\n * */\nexport type GoogleMapsMapTypes =  \"roadmap\"|\"satellite\"|\"terrain\";\n\n/**\n * Scale factors that can be applied to labels and objects in the map.\n * @beta\n * */\nexport type GoogleMapsScaleFactors =  \"scaleFactor1x\" | \"scaleFactor2x\" | \"scaleFactor4x\";\n\n/**\n* Represents the options to create a Google Maps session.\n* @beta\n*/\nexport interface GoogleMapsCreateSessionOptions {\n    /**\n   * The type of base map.\n   *\n   * `roadmap`: The standard Google Maps painted map tiles.\n   *\n   * `satellite`: Satellite imagery.\n   *\n   * `terrain`: Terrain imagery. When selecting `terrain` as the map type, you must also include the `layerRoadmap` layer type.\n   * @beta\n   * */\n  mapType: GoogleMapsMapTypes,\n  /**\n   * An {@link https://en.wikipedia.org/wiki/IETF_language_tag | IETF language tag} that specifies the language used to display information on the tiles. For example, `en-US` specifies the English language as spoken in the United States.\n   */\n  language: string;\n    /**\n    * A {@link https://cldr.unicode.org/ | Common Locale Data Repository}  region identifier (two uppercase letters) that represents the physical location of the user. For example, `US`.\n    */\n  region: string;\n\n  /**\n   * An array of values that specifies the layer types added to the map.\n   *\n   * `layerRoadmap`: Required if you specify terrain as the map type. Can also be optionally overlaid on the satellite map type. Has no effect on roadmap tiles.\n   *\n   * `layerStreetview`: Shows Street View-enabled streets and locations using blue outlines on the map.\n   *\n   * @beta\n   * */\n  layerTypes?: GoogleMapsLayerTypes[];\n\n  /**\n   * Scales-up the size of map elements (such as road labels), while retaining the tile size and coverage area of the default tile.\n   * Increasing the scale also reduces the number of labels on the map, which reduces clutter.\n   *\n   * `scaleFactor1x`: The default.\n   *\n   * `scaleFactor2x`: Doubles label size and removes minor feature labels.\n   *\n   * `scaleFactor4x`: Quadruples label size and removes minor feature labels.\n   * @beta\n   * */\n  scale?: GoogleMapsScaleFactors\n\n  /**\n   * A boolean value that specifies whether layerTypes should be rendered as a separate overlay, or combined with the base imagery.\n   * When true, the base map isn't displayed. If you haven't defined any layerTypes, then this value is ignored.\n   * Default is false.\n   * @beta\n   * */\n    overlay? : boolean;\n\n    /**\n     * An array of values specifying additional options to apply.\n     * @beta\n     * */\n    apiOptions?: string[];\n};\n\n/**\n* Structure representing a Google Maps session.\n* @beta\n*/\nexport interface GoogleMapsSession {\n  /** A session token value that you must include in all of your Map Tiles API requests. */\n  session: string;\n\n  /**  string that contains the time (in seconds since the epoch) at which the token expires. A session token is valid for two weeks from its creation time, but this policy might change without notice. */\n  expiry: number;\n\n  /** The width of the tiles measured in pixels. */\n  tileWidth: number;\n\n  /** he height of the tiles measured in pixels. */\n  tileHeight: number;\n\n  /** The image format, which can be either `png` or `jpeg`. */\n  imageFormat: string;\n};\n\n/**\n * Represents the maximum zoom level available within a bounding rectangle.\n* @beta\n*/\nexport interface MaxZoomRectangle {\n  maxZoom: number;\n  north: number;\n  south: number;\n  east: number;\n  west: number;\n}\n\n/**\n * Indicate which areas of given viewport have imagery, and at which zoom levels.\n * @beta\n*/\nexport interface ViewportInfo {\n  /**  Attribution string that you must display on your map when you display roadmap and satellite tiles. */\n  copyright: string;\n\n  /** Array of bounding rectangles that overlap with the current viewport. Also contains the maximum zoom level available within each rectangle.. */\n  maxZoomRects: MaxZoomRectangle[];\n}\n\n/**\n * Request parameters for the getViewportInfo method.\n * @beta\n*/\nexport interface ViewportInfoRequestParams {\n  /** Bounding rectangle */\n  rectangle: MapCartoRectangle;\n\n  /** Session token */\n  session: string;\n\n  /** The Google Cloud API key */\n  key: string;\n\n  /** Zoom level of the viewport */\n  zoom: number;\n}\n\n/**\n * Google Maps API\n * @beta\n*/\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport const GoogleMaps = {\n/**\n * Creates Google Maps map-layer settings.\n * @param name Name of the layer (Defaults to \"GoogleMaps\")\n * @param opts Options to create the session  (Defaults to satellite map type, English language, US region, and roadmap layer type)\n *\n * The following examples illustrates how a Googles Map layer can be attached to a viewport:\n * ```ts\n * [[include:GoogleMaps_AttachMapLayerSimple]]\n * ```\n * ```ts\n * [[include:GoogleMaps_AttachMapLayerOpts]]\n * ```\n * @beta\n*/\n  createMapLayerSettings: (name?: string, opts?: GoogleMapsCreateSessionOptions) => {\n    return ImageMapLayerSettings.fromJSON(GoogleMapsUtils.createMapLayerProps(name, opts));\n  },\n\n/**\n * Creates Google Maps base layer settings.\n * @param name Name of the layer (Defaults to \"GoogleMaps\")\n * @param opts Options to create the session  (Defaults to satellite map type, English language, US region, and roadmap layer type)\n *\n * The following examples illustrates how a Google Maps base layer can be set on a viewport:\n * ```ts\n * [[include:GoogleMaps_BaseMapSimple]]\n * ```\n * ```ts\n * [[include:GoogleMaps_BaseMapOpts]]\n * ```\n * @beta\n*/\n  createBaseLayerSettings: (opts?: GoogleMapsCreateSessionOptions) => {\n    return BaseMapLayerSettings.fromJSON(GoogleMapsUtils.createMapLayerProps(\"GoogleMaps\", opts));\n  }\n};"]}

package/lib/esm/GoogleMaps/GoogleMapsImageryFormat.d.ts

@@ -0,0 +1,10 @@
+/** @packageDocumentation
+ * @module MapLayersFormats
+ */
+import { ImageMapLayerSettings } from "@itwin/core-common";
+import { ImageryMapLayerFormat, MapLayerImageryProvider } from "@itwin/core-frontend";
+export declare class GoogleMapsMapLayerFormat extends ImageryMapLayerFormat {
+    static formatId: string;
+    static createImageryProvider(settings: ImageMapLayerSettings): MapLayerImageryProvider | undefined;
+}
+//# sourceMappingURL=GoogleMapsImageryFormat.d.ts.map

package/lib/esm/GoogleMaps/GoogleMapsImageryFormat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoogleMapsImageryFormat.d.ts","sourceRoot":"","sources":["../../../src/GoogleMaps/GoogleMapsImageryFormat.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAGtF,qBAAa,wBAAyB,SAAQ,qBAAqB;IACjE,OAAuB,QAAQ,SAAgB;WACxB,qBAAqB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,uBAAuB,GAAG,SAAS;CAGnH"}

package/lib/esm/GoogleMaps/GoogleMapsImageryFormat.js

@@ -0,0 +1,16 @@
+/*---------------------------------------------------------------------------------------------
+* 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 } from "@itwin/core-frontend";
+import { GoogleMapsImageryProvider } from "./GoogleMapsImageryProvider";
+export class GoogleMapsMapLayerFormat extends ImageryMapLayerFormat {
+    static formatId = "GoogleMaps";
+    static createImageryProvider(settings) {
+        return new GoogleMapsImageryProvider(settings);
+    }
+}
+//# sourceMappingURL=GoogleMapsImageryFormat.js.map

package/lib/esm/GoogleMaps/GoogleMapsImageryFormat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoogleMapsImageryFormat.js","sourceRoot":"","sources":["../../../src/GoogleMaps/GoogleMapsImageryFormat.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAGH,OAAO,EAAE,qBAAqB,EAA2B,MAAM,sBAAsB,CAAC;AACtF,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAExE,MAAM,OAAO,wBAAyB,SAAQ,qBAAqB;IAC1D,MAAM,CAAU,QAAQ,GAAG,YAAY,CAAC;IACxC,MAAM,CAAU,qBAAqB,CAAC,QAA+B;QAC1E,OAAO,IAAI,yBAAyB,CAAC,QAAQ,CAAC,CAAC;IACjD,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, MapLayerImageryProvider } from \"@itwin/core-frontend\";\nimport { GoogleMapsImageryProvider } from \"./GoogleMapsImageryProvider\";\n\nexport class GoogleMapsMapLayerFormat extends ImageryMapLayerFormat {\n  public static override formatId = \"GoogleMaps\";\n  public static override createImageryProvider(settings: ImageMapLayerSettings): MapLayerImageryProvider | undefined {\n    return new GoogleMapsImageryProvider(settings);\n  }\n}\n"]}

package/lib/esm/GoogleMaps/GoogleMapsImageryProvider.d.ts

@@ -0,0 +1,25 @@
+/** @packageDocumentation
+ * @module MapLayersFormats
+ */
+import { ImageMapLayerSettings, ImageSource } from "@itwin/core-common";
+import { DecorateContext, MapLayerImageryProvider, MapLayerSourceValidation, ScreenViewport } from "@itwin/core-frontend";
+import { GoogleMapsSession } from "./GoogleMaps";
+export declare class GoogleMapsImageryProvider extends MapLayerImageryProvider {
+    private _decorator;
+    private _hadUnrecoverableError;
+    private _tileSize;
+    constructor(settings: ImageMapLayerSettings);
+    static validateUrlTemplate(template: string): MapLayerSourceValidation;
+    protected createSession(): Promise<GoogleMapsSession | undefined>;
+    get tileSize(): number;
+    initialize(): Promise<void>;
+    private createCreateSessionOptions;
+    constructUrl(row: number, column: number, level: number): Promise<string>;
+    private fetchAttributions;
+    private logJsonError;
+    loadTile(row: number, column: number, zoomLevel: number): Promise<ImageSource | undefined>;
+    decorate(context: DecorateContext): void;
+    private getSelectedTiles;
+    addAttributions(cards: HTMLTableElement, vp: ScreenViewport): Promise<void>;
+}
+//# sourceMappingURL=GoogleMapsImageryProvider.d.ts.map

package/lib/esm/GoogleMaps/GoogleMapsImageryProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoogleMapsImageryProvider.d.ts","sourceRoot":"","sources":["../../../src/GoogleMaps/GoogleMapsImageryProvider.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,eAAe,EAAgC,uBAAuB,EAAwB,wBAAwB,EAAW,cAAc,EAAQ,MAAM,sBAAsB,CAAC;AAC7L,OAAO,EAAoG,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAenJ,qBAAa,yBAA0B,SAAQ,uBAAuB;IAEpE,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,sBAAsB,CAAS;IACvC,OAAO,CAAC,SAAS,CAAM;gBACX,QAAQ,EAAE,qBAAqB;WAI7B,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,wBAAwB;cAI7D,aAAa,IAAK,OAAO,CAAC,iBAAiB,GAAC,SAAS,CAAC;IAYtE,IAAoB,QAAQ,IAAI,MAAM,CAA2B;IAE3C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BjD,OAAO,CAAC,0BAA0B;IAoCrB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAWxE,iBAAiB;YAqCjB,YAAY;IASJ,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IA0ChG,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAIxD,OAAO,CAAC,gBAAgB;IAIF,eAAe,CAAE,KAAK,EAAE,gBAAgB,EAAE,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAuBnG"}

package/lib/esm/GoogleMaps/GoogleMapsImageryProvider.js

@@ -0,0 +1,228 @@
+/*---------------------------------------------------------------------------------------------
+* 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, MapCartoRectangle, MapLayerImageryProvider, MapLayerSourceStatus, MapTile } from "@itwin/core-frontend";
+import { BentleyError, BentleyStatus, Logger } from "@itwin/core-bentley";
+import { GoogleMapsDecorator } from "./GoogleMapDecorator";
+import { GoogleMapsUtils } from "../internal/GoogleMapsUtils";
+const loggerCategory = "MapLayersFormats.GoogleMaps";
+const levelToken = "{level}";
+const rowToken = "{row}";
+const columnToken = "{column}";
+const urlTemplate = `https://tile.googleapis.com/v1/2dtiles/${levelToken}/${columnToken}/${rowToken}`;
+/*
+* Google Maps imagery provider
+* @internal
+*/
+export class GoogleMapsImageryProvider extends MapLayerImageryProvider {
+    _decorator;
+    _hadUnrecoverableError = false;
+    _tileSize = 256;
+    constructor(settings) {
+        super(settings, true);
+        this._decorator = new GoogleMapsDecorator();
+    }
+    static validateUrlTemplate(template) {
+        return { status: (template.indexOf(levelToken) > 0 && template.indexOf(columnToken) > 0 && template.indexOf(rowToken) > 0) ? MapLayerSourceStatus.Valid : MapLayerSourceStatus.InvalidUrl };
+    }
+    async createSession() {
+        const sessionOptions = this.createCreateSessionOptions();
+        if (this._settings.accessKey) {
+            // Create session and store in query parameters
+            const sessionObj = await GoogleMapsUtils.createSession(this._settings.accessKey.value, sessionOptions);
+            this._settings.unsavedQueryParams = { session: sessionObj.session };
+            return sessionObj;
+        }
+        else {
+            Logger.logError(loggerCategory, `Missing GoogleMaps api key`);
+            return undefined;
+        }
+    }
+    get tileSize() { return this._tileSize; }
+    async initialize() {
+        const layerPropertyKeys = this._settings.properties ? Object.keys(this._settings.properties) : undefined;
+        if (layerPropertyKeys === undefined ||
+            !layerPropertyKeys.includes("mapType") ||
+            !layerPropertyKeys.includes("language") ||
+            !layerPropertyKeys.includes("region")) {
+            const msg = "Missing session options";
+            Logger.logError(loggerCategory, msg);
+            throw new BentleyError(BentleyStatus.ERROR, msg);
+        }
+        const session = await this.createSession();
+        if (!session) {
+            const msg = `Failed to create session`;
+            Logger.logError(loggerCategory, msg);
+            throw new BentleyError(BentleyStatus.ERROR, msg);
+        }
+        this._tileSize = session.tileWidth; // assuming here tiles are square
+        const isActivated = await this._decorator.activate(this._settings.properties.mapType);
+        if (!isActivated) {
+            const msg = `Failed to activate decorator`;
+            Logger.logError(loggerCategory, msg);
+            throw new BentleyError(BentleyStatus.ERROR, msg);
+        }
+    }
+    createCreateSessionOptions() {
+        const layerPropertyKeys = this._settings.properties ? Object.keys(this._settings.properties) : undefined;
+        if (layerPropertyKeys === undefined ||
+            !layerPropertyKeys.includes("mapType") ||
+            !layerPropertyKeys.includes("language") ||
+            !layerPropertyKeys.includes("region")) {
+            const msg = "Missing session options";
+            Logger.logError(loggerCategory, msg);
+            throw new BentleyError(BentleyStatus.ERROR, msg);
+        }
+        const createSessionOptions = {
+            mapType: this._settings.properties.mapType,
+            region: this._settings.properties.region,
+            language: this._settings.properties.language,
+        };
+        if (this._settings.properties?.layerTypes !== undefined) {
+            createSessionOptions.layerTypes = this._settings.properties.layerTypes;
+        }
+        if (this._settings.properties?.scale !== undefined) {
+            createSessionOptions.scale = this._settings.properties.scale;
+        }
+        if (this._settings.properties?.overlay !== undefined) {
+            createSessionOptions.overlay = this._settings.properties.overlay;
+        }
+        if (this._settings.properties?.apiOptions !== undefined) {
+            createSessionOptions.apiOptions = this._settings.properties.apiOptions;
+        }
+        return createSessionOptions;
+    }
+    // construct the Url from the desired Tile
+    async constructUrl(row, column, level) {
+        const tmpUrl = urlTemplate.replace(levelToken, level.toString()).replace(columnToken, column.toString()).replace(rowToken, row.toString());
+        const obj = new URL(tmpUrl);
+        if (this._settings.accessKey) {
+            obj.searchParams.append("key", this._settings.accessKey.value);
+        }
+        // We assume the 'session' param to be already part of the query parameters (checked in initialize)
+        return this.appendCustomParams(obj.toString());
+    }
+    async fetchAttributions(tiles) {
+        const zooms = new Set();
+        const matchingAttributions = [];
+        // Viewport info requests must be made for a specific zoom level
+        tiles.forEach((tile) => zooms.add(tile.depth));
+        for (const zoom of zooms) {
+            let cartoRect;
+            for (const tile of tiles) {
+                if (tile.depth === zoom && tile instanceof MapTile) {
+                    const extent = this.getEPSG4326Extent(tile.quadId.row, tile.quadId.column, tile.depth);
+                    const rect = MapCartoRectangle.fromDegrees(extent.longitudeLeft, extent.latitudeBottom, extent.longitudeRight, extent.latitudeTop);
+                    if (cartoRect)
+                        cartoRect.union(rect);
+                    else
+                        cartoRect = rect;
+                }
+            }
+            if (cartoRect) {
+                try {
+                    const viewportInfo = await GoogleMapsUtils.getViewportInfo({
+                        rectangle: cartoRect,
+                        session: this._settings.collectQueryParams().session,
+                        key: this._settings.accessKey.value,
+                        zoom
+                    });
+                    if (viewportInfo?.copyright) {
+                        matchingAttributions.push(viewportInfo.copyright);
+                    }
+                }
+                catch (error) {
+                    Logger.logError(loggerCategory, `Error while loading viewport info: ${error?.message ?? "Unknown error"}`);
+                }
+            }
+        }
+        return matchingAttributions;
+    }
+    async logJsonError(tileResponse) {
+        try {
+            const error = await tileResponse.json();
+            Logger.logError(loggerCategory, `Error while loading tile: ${error?.message}`);
+        }
+        catch {
+            Logger.logError(loggerCategory, `Error while loading tile: ${tileResponse.statusText}`);
+        }
+    }
+    async loadTile(row, column, zoomLevel) {
+        if (this._hadUnrecoverableError)
+            return undefined;
+        try {
+            let tileUrl = await this.constructUrl(row, column, zoomLevel);
+            let tileResponse = await this.makeTileRequest(tileUrl);
+            if (!tileResponse.ok) {
+                if (tileResponse.headers.get("content-type")?.includes("application/json")) {
+                    // Session might have expired, lets try to re-new it.
+                    const isSessionCreated = await this.createSession();
+                    if (isSessionCreated) {
+                        tileUrl = await this.constructUrl(row, column, zoomLevel);
+                        tileResponse = await this.makeTileRequest(tileUrl);
+                        if (!tileResponse.ok) {
+                            if (tileResponse.headers.get("content-type")?.includes("application/json")) {
+                                await this.logJsonError(tileResponse);
+                            }
+                            else {
+                                Logger.logError(loggerCategory, `Error while loading tile: ${tileResponse.statusText}`);
+                            }
+                            this._hadUnrecoverableError = true; // Prevent from doing more invalid requests
+                            return undefined;
+                        }
+                    }
+                    else {
+                        await this.logJsonError(tileResponse);
+                    }
+                }
+                else {
+                    Logger.logError(loggerCategory, `Error while loading tile: ${tileResponse.statusText}`);
+                    return undefined;
+                }
+            }
+            return await this.getImageFromTileResponse(tileResponse, zoomLevel);
+        }
+        catch (error) {
+            if (error?.code === 401) {
+                Logger.logError(loggerCategory, `Authorize to load tile: ${error.message}`);
+            }
+            else {
+                Logger.logError(loggerCategory, `Error while loading tile: ${error.message}`);
+            }
+            return undefined;
+        }
+    }
+    decorate(context) {
+        this._decorator.decorate(context);
+    }
+    getSelectedTiles(vp) {
+        return IModelApp.tileAdmin.getTilesForUser(vp)?.selected;
+    }
+    async addAttributions(cards, vp) {
+        let copyrightMsg = "";
+        const tiles = this.getSelectedTiles(vp);
+        if (tiles) {
+            try {
+                const attrList = await this.fetchAttributions(tiles);
+                for (const attr of attrList) {
+                    attr.split(",").forEach((line) => {
+                        copyrightMsg += `${copyrightMsg.length === 0 ? "" : "<br"}${line}`;
+                    });
+                }
+            }
+            catch (error) {
+                Logger.logError(loggerCategory, `Error while loading attributions: ${error?.message ?? "Unknown error"}`);
+            }
+        }
+        cards.appendChild(IModelApp.makeLogoCard({
+            iconSrc: `${IModelApp.publicPath}images/google_on_white_hdpi.png`,
+            heading: "Google Maps",
+            notice: copyrightMsg
+        }));
+    }
+}
+//# sourceMappingURL=GoogleMapsImageryProvider.js.map

package/lib/esm/GoogleMaps/GoogleMapsImageryProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoogleMapsImageryProvider.js","sourceRoot":"","sources":["../../../src/GoogleMaps/GoogleMapsImageryProvider.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, ImageSource } from \"@itwin/core-common\";\nimport { DecorateContext, IModelApp, MapCartoRectangle, MapLayerImageryProvider, MapLayerSourceStatus, MapLayerSourceValidation, MapTile, ScreenViewport, Tile } from \"@itwin/core-frontend\";\nimport { GoogleMapsCreateSessionOptions, GoogleMapsLayerTypes, GoogleMapsMapTypes, GoogleMapsScaleFactors, GoogleMapsSession } from \"./GoogleMaps\";\nimport { BentleyError, BentleyStatus, Logger } from \"@itwin/core-bentley\";\nimport { GoogleMapsDecorator } from \"./GoogleMapDecorator\";\nimport { GoogleMapsUtils } from \"../internal/GoogleMapsUtils\";\nconst loggerCategory = \"MapLayersFormats.GoogleMaps\";\nconst levelToken = \"{level}\";\nconst rowToken = \"{row}\";\nconst columnToken = \"{column}\";\n\nconst urlTemplate = `https://tile.googleapis.com/v1/2dtiles/${levelToken}/${columnToken}/${rowToken}`;\n\n/*\n* Google Maps imagery provider\n* @internal\n*/\nexport class GoogleMapsImageryProvider extends MapLayerImageryProvider {\n\n  private _decorator: GoogleMapsDecorator;\n  private _hadUnrecoverableError = false;\n  private _tileSize = 256\n  constructor(settings: ImageMapLayerSettings) {\n    super(settings, true);\n    this._decorator = new GoogleMapsDecorator();\n  }\n  public static validateUrlTemplate(template: string): MapLayerSourceValidation {\n    return { status: (template.indexOf(levelToken) > 0 && template.indexOf(columnToken) > 0 && template.indexOf(rowToken) > 0) ? MapLayerSourceStatus.Valid : MapLayerSourceStatus.InvalidUrl };\n  }\n\n  protected async createSession() : Promise<GoogleMapsSession|undefined> {\n    const sessionOptions = this.createCreateSessionOptions();\n    if (this._settings.accessKey ) {\n      // Create session and store in query parameters\n      const sessionObj = await GoogleMapsUtils.createSession(this._settings.accessKey.value, sessionOptions);\n      this._settings.unsavedQueryParams = {session: sessionObj.session};\n      return sessionObj;\n    } else {\n      Logger.logError(loggerCategory, `Missing GoogleMaps api key`);\n      return undefined;\n    }\n  }\n  public override get tileSize(): number { return this._tileSize; }\n\n  public override async initialize(): Promise<void> {\n\n    const layerPropertyKeys = this._settings.properties ? Object.keys(this._settings.properties) : undefined;\n    if (layerPropertyKeys === undefined ||\n        !layerPropertyKeys.includes(\"mapType\") ||\n        !layerPropertyKeys.includes(\"language\") ||\n        !layerPropertyKeys.includes(\"region\")) {\n      const msg = \"Missing session options\";\n      Logger.logError(loggerCategory, msg);\n      throw new BentleyError(BentleyStatus.ERROR, msg);\n    }\n\n    const session = await this.createSession();\n    if (!session) {\n      const msg = `Failed to create session`;\n      Logger.logError(loggerCategory, msg);\n      throw new BentleyError(BentleyStatus.ERROR, msg);\n    }\n    this._tileSize = session.tileWidth; // assuming here tiles are square\n\n    const isActivated = await this._decorator.activate(this._settings.properties!.mapType as GoogleMapsMapTypes);\n    if (!isActivated) {\n      const msg = `Failed to activate decorator`;\n      Logger.logError(loggerCategory, msg);\n      throw new BentleyError(BentleyStatus.ERROR, msg);\n    }\n  }\n\n  private createCreateSessionOptions(): GoogleMapsCreateSessionOptions {\n    const layerPropertyKeys = this._settings.properties ? Object.keys(this._settings.properties) : undefined;\n    if (layerPropertyKeys === undefined ||\n        !layerPropertyKeys.includes(\"mapType\") ||\n        !layerPropertyKeys.includes(\"language\") ||\n        !layerPropertyKeys.includes(\"region\")) {\n      const msg = \"Missing session options\";\n      Logger.logError(loggerCategory, msg);\n      throw new BentleyError(BentleyStatus.ERROR, msg);\n    }\n\n    const createSessionOptions: GoogleMapsCreateSessionOptions = {\n      mapType: this._settings.properties!.mapType as GoogleMapsMapTypes,\n      region: this._settings.properties!.region as string,\n      language: this._settings.properties!.language as string,\n    }\n\n    if (this._settings.properties?.layerTypes !== undefined) {\n      createSessionOptions.layerTypes = this._settings.properties.layerTypes as GoogleMapsLayerTypes[];\n    }\n\n    if (this._settings.properties?.scale !== undefined) {\n      createSessionOptions.scale = this._settings.properties.scale as GoogleMapsScaleFactors;\n    }\n\n    if (this._settings.properties?.overlay !== undefined) {\n      createSessionOptions.overlay = this._settings.properties.overlay as boolean;\n    }\n\n    if (this._settings.properties?.apiOptions !== undefined) {\n      createSessionOptions.apiOptions = this._settings.properties.apiOptions as string[];\n    }\n    return createSessionOptions;\n  }\n\n  // construct the Url from the desired Tile\n  public async constructUrl(row: number, column: number, level: number): Promise<string> {\n    const tmpUrl = urlTemplate.replace(levelToken, level.toString()).replace(columnToken, column.toString()).replace(rowToken, row.toString());\n    const obj = new URL(tmpUrl);\n    if (this._settings.accessKey ) {\n      obj.searchParams.append(\"key\", this._settings.accessKey.value);\n    }\n\n    // We assume the 'session' param to be already part of the query parameters (checked in initialize)\n    return this.appendCustomParams(obj.toString());\n  }\n\n  private async fetchAttributions(tiles: Set<Tile>): Promise<string[]> {\n    const zooms = new Set<number>();\n    const matchingAttributions: string[] = [];\n\n    // Viewport info requests must be made for a specific zoom level\n    tiles.forEach((tile) => zooms.add(tile.depth));\n\n    for (const zoom of zooms) {\n      let cartoRect: MapCartoRectangle|undefined;\n      for (const tile of tiles) {\n        if (tile.depth === zoom && tile instanceof MapTile) {\n          const extent = this.getEPSG4326Extent(tile.quadId.row, tile.quadId.column, tile.depth);\n          const rect = MapCartoRectangle.fromDegrees(extent.longitudeLeft, extent.latitudeBottom, extent.longitudeRight, extent.latitudeTop)\n          if (cartoRect)\n            cartoRect.union(rect);\n          else\n            cartoRect = rect;\n        }\n      }\n      if (cartoRect) {\n        try {\n          const viewportInfo = await GoogleMapsUtils.getViewportInfo({\n            rectangle: cartoRect,\n            session: this._settings.collectQueryParams().session,\n            key: this._settings.accessKey!.value,\n            zoom});\n          if (viewportInfo?.copyright) {\n            matchingAttributions.push(viewportInfo.copyright);\n          }\n        } catch (error:any) {\n          Logger.logError(loggerCategory, `Error while loading viewport info: ${error?.message??\"Unknown error\"}`);\n        }\n      }\n    }\n\n    return matchingAttributions;\n  }\n  private async logJsonError(tileResponse: Response) {\n    try {\n      const error = await tileResponse.json();\n      Logger.logError(loggerCategory, `Error while loading tile: ${error?.message}`);\n    } catch {\n      Logger.logError(loggerCategory, `Error while loading tile: ${tileResponse.statusText}`);\n    }\n  }\n\n  public override async loadTile(row: number, column: number, zoomLevel: number): Promise<ImageSource | undefined> {\n    if (this._hadUnrecoverableError)\n      return undefined;\n\n    try {\n      let tileUrl: string = await this.constructUrl(row, column, zoomLevel);\n      let tileResponse: Response = await this.makeTileRequest(tileUrl);\n      if (!tileResponse.ok) {\n        if (tileResponse.headers.get(\"content-type\")?.includes(\"application/json\")) {\n          // Session might have expired, lets try to re-new it.\n          const isSessionCreated = await this.createSession();\n          if (isSessionCreated) {\n            tileUrl = await this.constructUrl(row, column, zoomLevel);\n            tileResponse = await this.makeTileRequest(tileUrl);\n            if (!tileResponse.ok) {\n              if (tileResponse.headers.get(\"content-type\")?.includes(\"application/json\")) {\n                await this.logJsonError(tileResponse);\n              } else {\n                Logger.logError(loggerCategory, `Error while loading tile: ${tileResponse.statusText}`);\n              }\n              this._hadUnrecoverableError = true;   // Prevent from doing more invalid requests\n              return undefined;\n            }\n          } else {\n            await this.logJsonError(tileResponse);\n          }\n        } else {\n          Logger.logError(loggerCategory, `Error while loading tile: ${tileResponse.statusText}`);\n          return undefined;\n        }\n      }\n      return await this.getImageFromTileResponse(tileResponse, zoomLevel);\n    } catch (error: any) {\n      if (error?.code === 401) {\n        Logger.logError(loggerCategory, `Authorize to load tile: ${error.message}`);\n      } else {\n        Logger.logError(loggerCategory, `Error while loading tile: ${error.message}`);\n      }\n      return undefined;\n    }\n  }\n\n  public override decorate(context: DecorateContext): void {\n    this._decorator.decorate(context);\n  }\n\n  private getSelectedTiles(vp: ScreenViewport) {\n    return IModelApp.tileAdmin.getTilesForUser(vp)?.selected\n  }\n\n  public override async addAttributions (cards: HTMLTableElement, vp: ScreenViewport): Promise<void> {\n    let copyrightMsg = \"\";\n    const tiles = this.getSelectedTiles(vp);\n    if (tiles) {\n      try {\n        const attrList = await this.fetchAttributions(tiles);\n        for (const attr of attrList) {\n          attr.split(\",\").forEach((line) => {\n            copyrightMsg += `${copyrightMsg.length===0 ? \"\": \"<br\"}${line}`;\n        });\n        }\n      }\n      catch (error: any) {\n        Logger.logError(loggerCategory, `Error while loading attributions: ${error?.message??\"Unknown error\"}`);\n      }\n    }\n\n    cards.appendChild(IModelApp.makeLogoCard({\n      iconSrc: `${IModelApp.publicPath}images/google_on_white_hdpi.png`,\n      heading: \"Google Maps\",\n      notice: copyrightMsg }));\n  }\n\n}\n"]}

package/lib/esm/internal/GoogleMapsUtils.d.ts

@@ -0,0 +1,38 @@
+import { ImageMapLayerProps, MapLayerProviderProperties } from "@itwin/core-common";
+import { GoogleMapsCreateSessionOptions, GoogleMapsSession, ViewportInfo, ViewportInfoRequestParams } from "../GoogleMaps/GoogleMaps";
+/** @internal */
+export declare const GoogleMapsUtils: {
+    /**
+     * Creates a Google Maps session.
+     * @param apiKey Google Cloud API key
+     * @param opts Options to create the session
+     * @internal
+    */
+    createSession: (apiKey: string, opts: GoogleMapsCreateSessionOptions) => Promise<GoogleMapsSession>;
+    /**
+     * Register the google maps format if it is not already registered.
+     * @internal
+    */
+    checkFormatRegistered: () => void;
+    /**
+   * Creates a Google Maps layer props.
+   * @param name Name of the layer (Defaults to "GoogleMaps")
+   * @param opts Options to create the session  (Defaults to satellite map type, English language, US region, and roadmap layer type)
+   * @internal
+  */
+    createMapLayerProps: (name?: string, opts?: GoogleMapsCreateSessionOptions) => ImageMapLayerProps;
+    /**
+    * Retrieves the maximum zoom level available within a bounding rectangle.
+    * @param rectangle The bounding rectangle
+    * @returns The maximum zoom level available within the bounding rectangle.
+    * @internal
+    */
+    getViewportInfo: (params: ViewportInfoRequestParams) => Promise<ViewportInfo | undefined>;
+    /**
+   * Converts the session options to provider properties
+   * @param opts Options to create the session
+   * @internal
+  */
+    createPropertiesFromSessionOptions: (opts: GoogleMapsCreateSessionOptions) => MapLayerProviderProperties;
+};
+//# sourceMappingURL=GoogleMapsUtils.d.ts.map

package/lib/esm/internal/GoogleMapsUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoogleMapsUtils.d.ts","sourceRoot":"","sources":["../../../src/internal/GoogleMapsUtils.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAEpF,OAAO,EAAE,8BAA8B,EAAE,iBAAiB,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAItI,gBAAgB;AAEhB,eAAO,MAAM,eAAe;IAC1B;;;;;MAKE;4BAC4B,MAAM,QAAQ,8BAA8B,KAAG,OAAO,CAAC,iBAAiB,CAAC;IAWvG;;;MAGE;;IAOF;;;;;IAKA;iCAC4B,MAAM,SAAwB,8BAA8B,KAAG,kBAAkB;IAW7G;;;;;MAKE;8BAC8B,yBAAyB,KAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAgB3F;;;;IAIA;+CACyC,8BAA8B,KAAG,0BAA0B;CAyBvG,CAAA"}