Surface

Surfaces are meshed geometries representing area features such as zones and pathways. They are delivered as optimized meshes aligned with the terrain.

Geometry Type: meshes

{
     "type": "surface",
     "geometryType": "meshes",
     "meshes": Mesh[]
},

What does a surface mesh element contain? This is the example:

{
     // The most important element of any meshed geometry for visualization
     "vertices": [x1, y1, z1, x2, y2, z2, ...],
     "type": string
},

Available types

Type	Description
asphalt	Paved surfaces like roads
roadwayIntersection	Junctions of roads
pavement	Footpaths or sidewalks
water	Bodies of water
farmland	Agricultural land
grass	General grassy surfaces
sand	Sandy areas
rock	Rocky terrain
pitch	Sports fields
manicuredGrass	Well-maintained lawns
helipad	Helicopter landing areas
forest	Densely wooded areas
garden	Decorative or functional gardens
construction	Areas under construction
buildingConstruction	Building sites
shrubbery	Areas with shrubs
roadwayArea	Areas designated for roads

When a topography model is requested, all surfaces are projected onto it, which can significantly increase the size of the resulting surface data. To optimize performance, consider disabling projection when it’s not needed. More info Customizations

Projected Surfaces

An example of filtering by type in Three.js:

const material = new THREE.MeshStandardMaterial({
  color: mesh.descriptor.type === "asphalt" ? "#dc0d0d" : getRandomColour(),
});