Create maps with arbitrary extents.

100% Map style by Stamen Design, © OpenStreetMap contributors

Map extents can be of any size. They will be subdivided into tiles accordingly.

index.js
import { Vector3, Object3D, MathUtils } from "three";
import { MapControls } from "three/examples/jsm/controls/MapControls.js";
import StadiaMaps from "ol/source/StadiaMaps.js";

import Extent from "@giro3d/giro3d/core/geographic/Extent.js";
import Instance from "@giro3d/giro3d/core/Instance.js";
import ColorLayer from "@giro3d/giro3d/core/layer/ColorLayer.js";
import Map from "@giro3d/giro3d/entities/Map.js";
import Inspector from "@giro3d/giro3d/gui/Inspector.js";
import Helpers from "@giro3d/giro3d/helpers/Helpers.js";
import TiledImageSource from "@giro3d/giro3d/sources/TiledImageSource.js";

function bindButton(id, onClick) {
  const element = document.getElementById(id);
  if (!(element instanceof HTMLButtonElement)) {
    throw new Error(
      "invalid binding element: expected HTMLButtonElement, got: " +
        element.constructor.name,
    );
  }

  element.onclick = () => {
    onClick(element);
  };

  return element;
}

const EPSG3857_BOUNDS = new Extent(
  "EPSG:3857",
  -20037508.342789244,
  20037508.342789244,
  -20037508.342789244,
  20037508.342789244,
);

let currentMap;

const instance = new Instance({
  target: "view",
  crs: EPSG3857_BOUNDS.crs,
  backgroundColor: 0x0a3b59,
});

instance.view.camera.position.set(0, 0, 100000000);

const controls = new MapControls(instance.view.camera, instance.domElement);
instance.view.setControls(controls);

Inspector.attach("inspector", instance);

instance.notifyChange();

const layers = ["stamen_watercolor", "stamen_toner", "stamen_terrain"];

let mapCount = 0;

// Create a grid that encompasses the whole EPSG:3857 bounds.
const grid = Helpers.createGrid(
  new Vector3(0, 0, -10000),
  EPSG3857_BOUNDS.dimensions().x,
  20,
);
instance.threeObjects.add(grid);

function createMap(extent) {
  if (currentMap) {
    instance.remove(currentMap);
    currentMap = null;
  }

  mapCount++;

  const object3d = new Object3D();

  currentMap = new Map({
    extent,
    maxSubdivisionLevel: 10,
    object3d,
    showOutline: true,
  });

  currentMap.name = `${mapCount}`;

  currentMap.object3d.position.set(0, 0, mapCount * 10000);

  instance.add(currentMap);

  // Adds an TMS imagery layer
  const layer = layers[mapCount % layers.length];
  currentMap
    .addLayer(
      new ColorLayer({
        name: "osm",
        extent,

        source: new TiledImageSource({
          source: new StadiaMaps({ layer, wrapX: false }),
        }),
      }),
    )
    .catch((e) => console.error(e));

  instance.notifyChange();
}

bindButton("createMap", () => {
  const dimensions = EPSG3857_BOUNDS.dimensions();

  const width = MathUtils.randFloat(
    dimensions.width * 0.5,
    dimensions.width * 0.1,
  );
  const height = MathUtils.randFloat(
    dimensions.height * 0.5,
    dimensions.height * 0.1,
  );
  const x = MathUtils.randFloat(-dimensions.width / 2, +dimensions.width / 2);
  const y = MathUtils.randFloat(-dimensions.height / 2, +dimensions.height / 2);

  const extent = Extent.fromCenterAndSize(
    "EPSG:3857",
    { x, y },
    width,
    height,
  ).intersect(EPSG3857_BOUNDS);

  createMap(extent);
});
index.html
<!doctype html>
<html lang="en">
  <head>
    <title>Arbitrary map extents</title>
    <meta charset="UTF-8" />
    <meta name="name" content="arbitrary_map_extents" />
    <meta name="description" content="Create maps with arbitrary extents." />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />

    <link rel="icon" href="https://giro3d.org/images/favicon.svg" />
    <link
      href="https://giro3d.org/assets/bootstrap-custom.css"
      rel="stylesheet"
    />
    <script src="https://giro3d.org/assets/bootstrap.bundle.min.js"></script>
    <link
      rel="stylesheet"
      type="text/css"
      href="https://giro3d.org/next/css/example.css"
    />
  </head>

  <body>
    <div id="view" class="m-0 p-0 w-100 h-100"></div>
    <div
      id="inspector"
      class="position-absolute top-0 start-0 mh-100 overflow-auto"
    ></div>

    <div class="side-pane-with-status-bar">
      <button class="btn btn-primary" id="createMap">Create new map</button>
    </div>

    <script type="module" src="index.js"></script>
    <script>
      /* activate popovers */
      const popoverTriggerList = [].slice.call(
        document.querySelectorAll('[data-bs-toggle="popover"]'),
      );
      popoverTriggerList.map(
        // bootstrap is used as script in the template, disable warning about undef
        // eslint-disable-next-line no-undef
        (popoverTriggerEl) =>
          new bootstrap.Popover(popoverTriggerEl, {
            trigger: "hover",
            placement: "left",
            content: document.getElementById(
              popoverTriggerEl.getAttribute("data-bs-content"),
            ).innerHTML,
            html: true,
          }),
      );
    </script>
  </body>
</html>
package.json
{
    "name": "arbitrary_map_extents",
    "dependencies": {
        "@giro3d/giro3d": "git+https://gitlab.com/giro3d/giro3d.git"
    },
    "devDependencies": {
        "vite": "^3.2.3"
    },
    "scripts": {
        "start": "vite",
        "build": "vite build"
    }
}