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 of the coordinates Spiral OUTPUTS — meeting points and every stop location it reports. Input positions keep their own accuracy, and a request to the travel calculator carries the full input accuracy, not this.
resolution real default 10: Distance (m) within which two locations count as the same place. Used only to decide whether an additional job is deployed as being at an existing job's location; it does not touch resource positions or travel estimates.
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.

Which property rounds what

Four properties quantise positions and times, and they are easy to confuse:

property	where	what it rounds
`precision`	topography	the coordinates Spiral outputs. A `precision` of `0.001` is a 111 m × 69 m cell at UK latitudes, and a host that displays Spiral’s reported stop locations sees that grid.
`resolution`	topography	whether an additional job counts as being at an existing job’s location.
`atResolution`	setObject	how finely a rendezvous location is searched for — an expensive optimisation.
`clockResolution`	stopParams	the estimated-arrival clock while a resource heads to a stop.

None of them rounds a resource’s reported position or a travel request: a position arrives at its own accuracy and is sent to the travel calculator as it arrived.

topographyObject

Which property rounds what

Related