Customizations

Cityweft provides numerous opportunities for customizing output, allowing for tailored solutions that meet specific user requirements.

Customizing a POST Request

Below is a table outlining the key settings you can customize in a POST request:

Setting Parameter	Description	Type	Default
topographyModel	Includes or excludes the topography model from output	Boolean	false
disableSurfaceProjection	Don't project the surface geometry onto the terrain. The parameter will be changed soon in our to support images as the surfaces.	Boolean	false
defaultRoofType	Applies a default roof type when the actual type is unknown.	'flat' | 'hipped' | 'gabled' | 'onion' | 'dome' | 'round' | 'skillion' | 'mansard' | 'quadrupleSaltbox' | 'saltbox' | 'gambrel' | 'pyramidal'	flat
defaultLevels	Applies a default amount of levels the actual data is unknown.	Number	1
defaultLevelHeight	Applies a default level height when the actual height is unknown.	Float	4
topographyReturnType	Topography type. More info: Topography	'meshes' | 'elevationMap' | 'both'	meshes
crs	Specifies the coordinate reference system for geometry coordinates (e.g., "EPSG:3857" for Web Mercator, "UTM" to get UTM-zone-based coordinates, "LOCAL" for meter-based coordinates with a defined origin)	local EPSG:3857 UTM	local
geometry	An array specifying the desired geometry type is returned. Supported geometry types are buildings surface barriers topography infrastructure (or instances ) More detailed information about the geometry types: Geometry NB. Does not include topography by default.	Array	[ 'buildings', 'surface', 'barriers', 'instances', ]
upAxis	Specifies which axis represents the "up" direction in the generated 3D geometry. The parameter ensures that buildings, terrain, and other geometry elements are properly oriented for your target application, preventing the need for manual rotation after import. In the current API version, Y is the default.	'Y' | 'Z'	Y
cropScene	When provided, the API slices the city model to include only geometry inside the polygon boundary. It might slow down the response by 5-20% depending on the area.	Boolean	false

Example of settings object

settings: {
    defaultRoofType:  "gabled"
    defaultLevels: 2,
    defaultLevelHeight: 4.5,
    geometry: ["buildings", "infrastructure", "barriers"],
    cropScene: true
}