topographyObject

The topography object describes the spatial environment resources move through. Rather than an internal route network, Spiral can use external services for precise travel and distance calculation.

Define legislature in every map. Beyond the regulatory rules it names, it bounds where work can happen: anything outside every declared region is not serviced — see legislatureObject.

{

"geometry": FLAT | WGS84,

"precision": <real>,

"resolution": <real>,

"cache": <cacheObject> | null,

"fractalDimension": <real> | null,

"referenceTravel": <referenceTravelObject>,

"inaccessible": <inaccessibleObject>,

"urbanTimeFactor": <urbanTimeFactorObject>,

"barrier": [barrierObject],

"urban": [urbanObject],

"island": [islandObject],

"legislature": [legislatureObject],

"terminal": <terminalObject>,

}

geometry FLAT | WGS84 default FLAT: Coordinate system: flat Cartesian or spherical.
precision real default 0.000001: Accuracy when comparing / outputting coordinates.
resolution real default 10: Maximum distance (m) before two points are treated as identical.
cache cacheObject: Travel / distance cache configuration.
fractalDimension real default 1.2: Converts straight-line distance to a realistic travel distance.
referenceTravel referenceTravelObject: Typical resource speed across unobstructed terrain.
inaccessible inaccessibleObject: Max distance/time penalties when locations can’t reach each other.
urbanTimeFactor urbanTimeFactorObject: How travel speed varies by time and day within urban zones.
barrier barrierObject: Obstacles (e.g. rivers) requiring detours via crossing points.
urban urbanObject: Significant urban regions that distort distance estimates.
island islandObject: Discrete regions needing terminal connections to move between.
legislature legislatureObject: REQUIRED. Areas under distinct regulatory rules (holidays, etc.) — and the serviceable extent of the map: a point outside every legislature is not serviced at all, so a map that declares none services nothing.
terminal terminalObject: Map of terminal name → terminalObject: connection points enabling scheduled transfers between islands.

topographyObject

Related