@basemaps/geo

@basemaps/geo

Utility functions to work with QuadKeys, Tiles and Projections.

Bounds and intersections

import { Bounds } from '@basemaps/geo';

const bounds = new Bounds(128, 128, 256, 256);
const boundsB = new Bounds(0, 0, 256, 256);

bounds.intersects(boundsB); // true

bounds.intersection(boundsB); // { x: 128, y: 128, width: 128, height: 128}

Typing for generic point and sizes

import { Point, Size, BoundingBox } from '@basemaps/geo';

const p: Point = { x: 5, y: 5 };
const s: Size = { width: 200, height: 500 };
const box: BoundingBox = { ...p, ...s };

QuadKey utilities

import {QuadKey} from '@basemaps/geo';


QuadKey.children('3') // ['30', '31', '32', '33']

QuadKey.fromTile({ x: 3, y: 2, z: 2 } // '31'

Tile Matrix Sets

import { GoogleTms } from '@basemaps/geo/build/tms/google';

/** Convert tile offsets into pixel coordinates */
GoogleTms.tileToPixels(1, 1); // { x: 256, y: 256 }

/** Convert a tile into the upper left point in Google  */
GoogleTms.tileToSource({ x: 0, y: 0, z: 0 }); // { x: -20037508.3427892, y: 20037508.3427892 }

Epsg Helpers

import { Epsg } from '@basemaps/geo';

Epsg.Google.toEpsgCode(); // `EPSG:3857`
Epsg.Google.toUrn(); // `urn:ogc:def:crs:EPSG:3857`
Epsg.parse('3857'); // Epsg.Google
Epsg.get(3857); // Epsg.Google

Changelog

8.0.0 (2025-05-11)

Bug Fixes

• cli: update landing deploy script with new cli-config package BM-1260 (#3431) (4d7e86d), closes /github.com/linz/basemaps/blob/e527a04fec65c82f8577642493e8fcb475762243/packages/landing/scripts/deploy.mjs#L1
• ensure all linzjs packages are correctly labeled as deps (#3439) (de9df87), closes #3438
• ensure api key blocks are set in ci/cd (#3442) (28f6403)

Features

• cli-vector: Extract cli to load schema json and prepare jobs to process vector mbtiles. BM-1267 (#3429) (db113e2)
• cli: add cli-config package BM-1260 (#3428) (4ca5a47)
• cli: move cogify create-config into cli-config package BM-1261 (#3432) (5f72430)
• cli: rename cogify package to cli-raster BM-1262 (#3433) (36d4449)
• cli: update cli-package commands to cmd-ts BM-1259 (#3427) (46cc342)