mirror of
https://github.com/bilawalsidhu/gods-eye-view.git
synced 2026-11-04 18:34:02 +00:00
Said TurkseverandClaude Opus 5.5
4ea6631425
Trim the doc text this PR adds (README, CHANGELOG, CURRENT-STATE, KNOWN-ISSUES, SECURITY, DATA_SOURCES, .env.example, the CI job comment), drop code comments that restate the code, cut design-note JSDoc to a line or two, and drop review tags from test names. Comments only; no code changes. Also: README key count (seven keys, two metered), CURRENT-STATE's gate paragraph (CI runs a production build with a dummy token), the stacked doc above meshBoxInRange and the orphaned inMeshRange line in coverage.js, and a duplicate ALPR row in DATA_SOURCES that a merge had brought back. Co-Authored-By: Claude Opus 5.5 <[email protected]>
73 lines
3.0 KiB
JavaScript
73 lines
3.0 KiB
JavaScript
import path from 'node:path';
|
||
|
||
/** Mapillary vector tile root; the path template is /{layer}/2/{z}/{x}/{y}. */
|
||
export const MAPILLARY_TILE_HOST = 'https://tiles.mapillary.com/maps/vtp';
|
||
|
||
/** Public tile layer names this proxy exposes, mapped to Mapillary's ids. */
|
||
export const TILE_LAYERS = Object.freeze({
|
||
// Region-sized z6–10 tiles are refused; the app never asks for them. The
|
||
// z14 `image` layer is ~98% of a tile and unused (positions come from the
|
||
// graph API), so it is dropped in transit.
|
||
coverage: Object.freeze({
|
||
upstream: 'mly1_public',
|
||
zoomRanges: Object.freeze([Object.freeze([0, 5]), Object.freeze([11, 14])]),
|
||
dropLayers: Object.freeze(['image']),
|
||
}),
|
||
});
|
||
|
||
/** Disk cache root, alongside the other providers' caches. */
|
||
export const MAPILLARY_CACHE_DIR = path.join(
|
||
process.cwd(),
|
||
'.gev-cache',
|
||
'mapillary',
|
||
);
|
||
export const TILE_DISK_DIR = path.join(MAPILLARY_CACHE_DIR, 'tiles');
|
||
|
||
/**
|
||
* Longer than the 15-minute upstream Cache-Control: tiles change only when new
|
||
* imagery is processed, and a day avoids re-downloading a city per camera move.
|
||
*/
|
||
export const TILE_DISK_TTL_MS = 24 * 60 * 60 * 1000;
|
||
|
||
/**
|
||
* A tile write starts a background sweep at most this often: expired files go
|
||
* first, then the oldest until the cache fits in TILE_DISK_MAX_BYTES.
|
||
*/
|
||
export const TILE_DISK_SWEEP_INTERVAL_MS = 15 * 60 * 1000;
|
||
export const TILE_DISK_MAX_BYTES = 1024 * 1024 * 1024;
|
||
/** Per-file cost on top of its size, so empty tiles still count. */
|
||
export const TILE_DISK_FILE_OVERHEAD_BYTES = 4096;
|
||
|
||
/** A z14 image tile over a dense city is ~11 MB; anything past this is wrong. */
|
||
export const TILE_MAX_BYTES = 48 * 1024 * 1024;
|
||
|
||
export const TILE_MEMORY_BUDGET_BYTES = 96 * 1024 * 1024;
|
||
/** Per-entry cost on top of its bytes, so empty tiles still count. */
|
||
export const TILE_MEMORY_ENTRY_OVERHEAD_BYTES = 1024;
|
||
export const TILE_FETCH_TIMEOUT_MS = 60_000;
|
||
/**
|
||
* Upstream fetches at once; further misses queue. A view needs at most 25
|
||
* tiles, and the cap stops a burst of misses opening thousands of requests.
|
||
*/
|
||
export const TILE_UPSTREAM_CONCURRENCY = 6;
|
||
/**
|
||
* Tile requests per client IP per minute, cache hits included. 600 is 24 new
|
||
* 25-tile views a minute, more than a person flying the camera reaches, but it
|
||
* stops one page draining the shared token into a Mapillary rate limit.
|
||
*/
|
||
export const TILE_ROUTE_MAX_PER_MIN = 600;
|
||
/**
|
||
* How long a 401/403 answers tile misses before asking Mapillary again. A
|
||
* changed token is tried at once.
|
||
*/
|
||
export const TILE_KEY_REJECTED_HOLD_MS = 5 * 60 * 1000;
|
||
/** After a 429 without a usable Retry-After, hold tile misses this long. */
|
||
export const TILE_RATE_LIMIT_HOLD_MS = 60_000;
|
||
/** The longest Retry-After honoured, so a bad header cannot stall coverage. */
|
||
export const TILE_RATE_LIMIT_MAX_HOLD_MS = 10 * 60 * 1000;
|
||
|
||
/** The client token lives in the browser by design; the server adds it to tile URLs too. */
|
||
export function mapillaryToken() {
|
||
return String(process.env.MAPILLARY_CLIENT_TOKEN || '').trim();
|
||
}
|