import convert from './convert.js'; // GeoJSON conversion and preprocessing import clip from './clip.js'; // stripe clipping algorithm import wrap from './wrap.js'; // date line processing import transform from './transform.js'; // coordinate transformation import createTile from './tile.js'; // final simplified tile generation const defaultOptions = { maxZoom: 14, // max zoom to preserve detail on indexMaxZoom: 5, // max zoom in the tile index indexMaxPoints: 100000, // max number of points per tile in the tile index tolerance: 3, // simplification tolerance (higher means simpler) extent: 4096, // tile extent buffer: 64, // tile buffer on each side lineMetrics: false, // whether to calculate line metrics promoteId: null, // name of a feature property to be promoted to feature.id generateId: false, // whether to generate feature ids. Cannot be used with promoteId debug: 0 // logging level (0, 1 or 2) }; class GeoJSONVT { constructor(data, options) { options = this.options = extend(Object.create(defaultOptions), options); const debug = options.debug; if (debug) console.time('preprocess data'); if (options.maxZoom < 0 || options.maxZoom > 24) throw new Error('maxZoom should be in the 0-24 range'); if (options.promoteId && options.generateId) throw new Error('promoteId and generateId cannot be used together.'); // projects and adds simplification info let features = convert(data, options); // tiles and tileCoords are part of the public API this.tiles = {}; this.tileCoords = []; if (debug) { console.timeEnd('preprocess data'); console.log('index: maxZoom: %d, maxPoints: %d', options.indexMaxZoom, options.indexMaxPoints); console.time('generate tiles'); this.stats = {}; this.total = 0; } // wraps features (ie extreme west and extreme east) features = wrap(features, options); // start slicing from the top tile down if (features.length) this.splitTile(features, 0, 0, 0); if (debug) { if (features.length) console.log('features: %d, points: %d', this.tiles[0].numFeatures, this.tiles[0].numPoints); console.timeEnd('generate tiles'); console.log('tiles generated:', this.total, JSON.stringify(this.stats)); } } // splits features from a parent tile to sub-tiles. // z, x, and y are the coordinates of the parent tile // cz, cx, and cy are the coordinates of the target tile // // If no target tile is specified, splitting stops when we reach the maximum // zoom or the number of points is low as specified in the options. splitTile(features, z, x, y, cz, cx, cy) { const stack = [features, z, x, y]; const options = this.options; const debug = options.debug; // avoid recursion by using a processing queue while (stack.length) { y = stack.pop(); x = stack.pop(); z = stack.pop(); features = stack.pop(); const z2 = 1 << z; const id = toID(z, x, y); let tile = this.tiles[id]; if (!tile) { if (debug > 1) console.time('creation'); tile = this.tiles[id] = createTile(features, z, x, y, options); this.tileCoords.push({z, x, y}); if (debug) { if (debug > 1) { console.log('tile z%d-%d-%d (features: %d, points: %d, simplified: %d)', z, x, y, tile.numFeatures, tile.numPoints, tile.numSimplified); console.timeEnd('creation'); } const key = `z${ z}`; this.stats[key] = (this.stats[key] || 0) + 1; this.total++; } } // save reference to original geometry in tile so that we can drill down later if we stop now tile.source = features; // if it's the first-pass tiling if (cz == null) { // stop tiling if we reached max zoom, or if the tile is too simple if (z === options.indexMaxZoom || tile.numPoints <= options.indexMaxPoints) continue; // if a drilldown to a specific tile } else if (z === options.maxZoom || z === cz) { // stop tiling if we reached base zoom or our target tile zoom continue; } else if (cz != null) { // stop tiling if it's not an ancestor of the target tile const zoomSteps = cz - z; if (x !== cx >> zoomSteps || y !== cy >> zoomSteps) continue; } // if we slice further down, no need to keep source geometry tile.source = null; if (features.length === 0) continue; if (debug > 1) console.time('clipping'); // values we'll use for clipping const k1 = 0.5 * options.buffer / options.extent; const k2 = 0.5 - k1; const k3 = 0.5 + k1; const k4 = 1 + k1; let tl = null; let bl = null; let tr = null; let br = null; let left = clip(features, z2, x - k1, x + k3, 0, tile.minX, tile.maxX, options); let right = clip(features, z2, x + k2, x + k4, 0, tile.minX, tile.maxX, options); features = null; if (left) { tl = clip(left, z2, y - k1, y + k3, 1, tile.minY, tile.maxY, options); bl = clip(left, z2, y + k2, y + k4, 1, tile.minY, tile.maxY, options); left = null; } if (right) { tr = clip(right, z2, y - k1, y + k3, 1, tile.minY, tile.maxY, options); br = clip(right, z2, y + k2, y + k4, 1, tile.minY, tile.maxY, options); right = null; } if (debug > 1) console.timeEnd('clipping'); stack.push(tl || [], z + 1, x * 2, y * 2); stack.push(bl || [], z + 1, x * 2, y * 2 + 1); stack.push(tr || [], z + 1, x * 2 + 1, y * 2); stack.push(br || [], z + 1, x * 2 + 1, y * 2 + 1); } } getTile(z, x, y) { z = +z; x = +x; y = +y; const options = this.options; const {extent, debug} = options; if (z < 0 || z > 24) return null; const z2 = 1 << z; x = (x + z2) & (z2 - 1); // wrap tile x coordinate const id = toID(z, x, y); if (this.tiles[id]) return transform(this.tiles[id], extent); if (debug > 1) console.log('drilling down to z%d-%d-%d', z, x, y); let z0 = z; let x0 = x; let y0 = y; let parent; while (!parent && z0 > 0) { z0--; x0 = x0 >> 1; y0 = y0 >> 1; parent = this.tiles[toID(z0, x0, y0)]; } if (!parent || !parent.source) return null; // if we found a parent tile containing the original geometry, we can drill down from it if (debug > 1) { console.log('found parent tile z%d-%d-%d', z0, x0, y0); console.time('drilling down'); } this.splitTile(parent.source, z0, x0, y0, z, x, y); if (debug > 1) console.timeEnd('drilling down'); return this.tiles[id] ? transform(this.tiles[id], extent) : null; } } function toID(z, x, y) { return (((1 << z) * y + x) * 32) + z; } function extend(dest, src) { for (const i in src) dest[i] = src[i]; return dest; } export default function geojsonvt(data, options) { return new GeoJSONVT(data, options); }