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.
{
"geometry": FLAT | WGS84,
"precision": <real>,
"resolution": <real>,
"fractalDimension": <real> | null,
}
-
geometryFLAT | WGS84defaultFLAT - Coordinate system: flat Cartesian or spherical.
-
precisionrealdefault0.000001 - Accuracy when comparing / outputting coordinates.
-
resolutionrealdefault10 - Maximum distance (m) before two points are treated as identical.
-
cachecacheObject - Travel / distance cache configuration.
-
fractalDimensionrealdefault1.2 - Converts straight-line distance to a realistic travel distance.
-
referenceTravelreferenceTravelObject - Typical resource speed across unobstructed terrain.
-
inaccessibleinaccessibleObject - Max distance/time penalties when locations can’t reach each other.
-
urbanTimeFactorurbanTimeFactorObject - How travel speed varies by time and day within urban zones.
-
barrierbarrierObject - Obstacles (e.g. rivers) requiring detours via crossing points.
-
urbanurbanObject - Significant urban regions that distort distance estimates.
-
islandislandObject - Discrete regions needing terminal connections to move between.
-
legislaturelegislatureObject - Areas under distinct regulatory rules (holidays, etc.).
-
terminalterminalObject - Connection points enabling scheduled transfers between islands.