Authentication, input and response
Fetch building geometry data on an object
POST
https://api.altum.ai/geometry
Headers
Request Body
{
"Output": {
"address": {
"bag_id": "0637010000264937",
"pand_id": "0637100000154943",
"postcode": "2728KH",
"housenumber": 5,
"houseaddition": null,
"number_of_floors": 2
},
"ground_surface": {
"ground_area": 58.58763122558594,
"perimeter": 29.91849544228239,
"max_length": 10.075360770088622,
"max_width": 5.997715962399906
},
"roof_surface": {
"type": "sloping",
"no_of_surfaces": 2,
"surfaces": [
{
"orientation": "NE",
"area": 18.283644166378284,
"perimeter": 26.122111567056024,
"roof_angle": 21.9
},
{
"orientation": "horizontal",
"area": 18.20771122754056,
"perimeter": 16.79418313304299,
"roof_angle": 0.6
}
]
},
"wall_surface": {
"wall_area": 289.73,
"shared_wall_area": 173.67,
"number_of_surfaces": 19,
"surfaces": [
{
"orientation": "NE",
"area": 0.1179748291056703,
"perimeter": 5.926721744304837
},
{
"orientation": "ES",
"area": 2.007550100242397,
"perimeter": 7.218128814489008
},
{
"orientation": "NE",
"area": 11.504453433629768,
"perimeter": 13.720814558970318
},
{
"orientation": "ES",
"area": 0.3648075626100832,
"perimeter": 10.157390687167904
},
{
"orientation": "SW",
"area": 0.3604685665218503,
"perimeter": 10.132360659459511
},
{
"orientation": "SW",
"area": 1.380436226506788,
"perimeter": 10.556900353281828
},
{
"orientation": "WN",
"area": "",
"perimeter": 20.807620799148147
},
{
"orientation": "WN",
"area": 0.5944294528413128,
"perimeter": 10.188479420953716
},
{
"orientation": "ES",
"area": 51.47712797293855,
"perimeter": 29.34865226714016
},
{
"orientation": "NE",
"area": 0.042340000059973,
"perimeter": 1.576008620102327
},
{
"orientation": "NE",
"area": 4.328445192627674,
"perimeter": 13.144203660340873
},
{
"orientation": "NE",
"area": 0.1464361841671296,
"perimeter": 5.933419121639009
},
{
"orientation": "WN",
"area": 3.945476944682557,
"perimeter": 8.538686973032593
},
{
"orientation": "SW",
"area": 28.21407802068922,
"perimeter": 21.28721581352973
},
{
"orientation": "WN",
"area": 5.951166266376108,
"perimeter": 9.918066058911071
},
{
"orientation": "ES",
"area": 1.9453478134960305,
"perimeter": 7.1825074271135945
},
{
"orientation": "ES",
"area": 6.125275275908871,
"perimeter": 10.045215888535882
},
{
"orientation": "NE",
"area": 0.0825265321880375,
"perimeter": 1.708148598879047
},
{
"orientation": "NE",
"area": 5.7661478019092645,
"perimeter": 9.791363861506555
}
]
}
}
}
{
"Output": {
"address": {
"bag_id": "0499010002023718",
"pand_id": "0499100002015826",
"post_code": "2771DS",
"house_number": 87,
"house_addition": null,
"no_of_floors": 2
},
"ground_surface": {
"area": 122.03668975830078,
"perimeter": 53.19795020555981,
"max_length": 13.936105098015044,
"max_width": 12.699969711612086
},
"roof_surface": {
"type": "sloping",
"no_of_surfaces": 4,
"surfaces": [
{
"orientation": "WN",
"area": 19.832505836178303,
"perimeter": 20.4330747637086,
"roof_angle": 24.8,
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
105001.073,
453592.295,
1.771
],
[
105002.265,
453592.122,
2.327
],
[
105002.274,
453592.186,
2.327
],
[
105002.289,
453592.299,
2.328
],
[
105003.892,
453604.067,
2.418
],
[
105003.903,
453604.148,
2.418
],
[
105002.128,
453604.392,
1.591
],
[
105002.119,
453604.316,
1.591
],
[
105001.886,
453602.284,
1.595
],
[
105001.719,
453600.824,
1.599
],
[
105001.64,
453600.139,
1.6
],
[
105001.626,
453600.017,
1.601
],
[
105001.856,
453599.985,
1.708
],
[
105000.771,
453592.34,
1.63
],
[
105001.073,
453592.295,
1.771
]
]
]
}
},
{
"orientation": "WN",
"area": 12.652916942719283,
"perimeter": 25.810687359706225,
"roof_angle": 23.7,
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
105003.892,
453604.067,
3.957
],
[
105002.289,
453592.299,
3.975
],
[
105002.274,
453592.186,
3.975
],
[
105002.265,
453592.122,
3.975
],
[
105002.315,
453592.115,
3.997
],
[
105003.648,
453591.921,
4.588
],
[
105003.654,
453591.965,
4.588
],
[
105003.692,
453592.233,
4.588
],
[
105005.322,
453603.866,
4.59
],
[
105005.334,
453603.951,
4.59
],
[
105003.903,
453604.148,
3.957
],
[
105003.892,
453604.067,
3.957
]
]
]
}
},
{
"orientation": "SW",
"area": 5.255787722065841,
"perimeter": 13.98183934283994,
"roof_angle": 39.1,
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
105001.64,
453600.139,
1.037
],
[
105001.719,
453600.824,
1.599
],
[
105001.886,
453602.284,
2.793
],
[
104998.265,
453602.55,
2.625
],
[
104998.303,
453603.094,
3.068
],
[
104997.759,
453603.156,
3.061
],
[
104997.681,
453602.593,
2.598
],
[
104997.63,
453602.222,
2.294
],
[
104997.419,
453600.702,
1.046
],
[
104997.408,
453600.617,
0.975
],
[
104998.122,
453600.515,
0.969
],
[
105000.231,
453600.215,
0.95
],
[
105001.626,
453600.017,
0.938
],
[
105001.64,
453600.139,
1.037
]
]
]
}
},
{
"orientation": "ES",
"area": 71.68768159329929,
"perimeter": 40.00529312464371,
"roof_angle": 22.9,
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
105009.673,
453591.477,
2.043
],
[
105010.244,
453595.739,
2.054
],
[
105010.807,
453599.93,
2.065
],
[
105010.974,
453599.909,
1.994
],
[
105011.37,
453599.86,
1.825
],
[
105011.77,
453602.959,
1.84
],
[
105011.784,
453603.064,
1.841
],
[
105011.533,
453603.098,
1.947
],
[
105005.334,
453603.951,
4.59
],
[
105005.322,
453603.866,
4.59
],
[
105003.692,
453592.233,
4.588
],
[
105003.654,
453591.965,
4.588
],
[
105003.648,
453591.921,
4.588
],
[
105004.097,
453591.856,
4.397
],
[
105004.811,
453591.753,
4.092
],
[
105004.801,
453591.684,
4.092
],
[
105009.25,
453590.593,
2.168
],
[
105009.322,
453591.186,
2.172
],
[
105009.445,
453591.171,
2.12
],
[
105010.162,
453591.084,
1.815
],
[
105010.207,
453591.401,
1.815
],
[
105009.673,
453591.477,
2.043
]
]
]
}
}
]
},
"wall_surface": {
"wall_area": 289.73,
"shared_wall_area": 173.67,
"no_of_surfaces": 44,
"surfaces": [
{
"orientation": "NE",
"area": 1.060962676449464,
"perimeter": 5.05897142729812,
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
105010.207,
453591.401,
1.815
],
[
105010.207,
453591.401,
-2.119
],
[
105009.673,
453591.477,
-2.119
],
[
105009.673,
453591.477,
2.043
],
[
105010.207,
453591.401,
1.815
]
]
]
}
},
{
"orientation": "SW",
"area": 0.5723490386221373,
"perimeter": 4.390652544685693,
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
105000.771,
453592.34,
1.63
],
[
105000.771,
453592.34,
-2.119
],
[
105001.073,
453592.295,
-2.119
],
[
105001.073,
453592.295,
1.771
],
[
105000.771,
453592.34,
1.63
]
]
]
}
},
{
"orientation": "SW",
"area": 4.1192576712387305,
"perimeter": 8.934031161246072,
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
105002.315,
453592.115,
3.997
],
[
105002.315,
453592.115,
-2.119
],
[
105003.648,
453591.921,
-2.119
],
[
105003.648,
453591.921,
4.588
],
[
105002.315,
453592.115,
3.997
]
]
]
}
},
{
"orientation": "ES",
"area": 1.2804304494986765,
"perimeter": 5.481723398862594,
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
105009.25,
453590.593,
2.168
],
[
105009.25,
453590.593,
-2.119
],
[
105009.322,
453591.186,
-2.119
],
[
105009.322,
453591.186,
2.172
],
[
105009.25,
453590.593,
2.168
]
]
]
}
},
{
"orientation": "WN",
"area": 14.77529937307406,
"perimeter": 19.270612525761983,
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
105001.856,
453599.985,
1.708
],
[
105001.856,
453599.985,
-2.119
],
[
105000.771,
453592.34,
-2.119
],
[
105000.771,
453592.34,
1.63
],
[
105001.856,
453599.985,
1.708
]
]
]
}
},
{
"orientation": "ES",
"area": 0.6297902744652016,
"perimeter": 4.574356150984596,
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
105010.162,
453591.084,
1.815
],
[
105010.162,
453591.084,
-2.119
],
[
105010.207,
453591.401,
-2.119
],
[
105010.207,
453591.401,
1.815
],
[
105010.162,
453591.084,
1.815
]
]
]
}
},
{
"orientation": "SW",
"area": 0.8205847320560656,
"perimeter": 4.945353639379955,
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
105010.974,
453599.909,
1.994
],
[
105010.974,
453599.909,
-2.119
],
[
105011.37,
453599.86,
-2.119
],
[
105011.37,
453599.86,
1.825
],
[
105010.974,
453599.909,
1.994
]
]
]
}
},
{
"orientation": "SW",
"area": 0.352115357703032,
"perimeter": 4.534992491669089,
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
105010.807,
453599.93,
2.065
],
[
105010.807,
453599.93,
-2.119
],
[
105010.974,
453599.909,
-2.119
],
[
105010.974,
453599.909,
1.994
],
[
105010.807,
453599.93,
2.065
]
]
]
}
},
{
"orientation": "SW",
"area": 1.1157720743225852,
"perimeter": 4.536522789916829,
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
104997.408,
453600.617,
0.975
],
[
104997.408,
453600.617,
-2.119
],
[
104998.122,
453600.515,
-2.119
],
[
104998.122,
453600.515,
0.969
],
[
104997.408,
453600.617,
0.975
]
]
]
}
},
{
"orientation": "WN",
"area": 0.1356341908180616,
"perimeter": 3.3620057096150147,
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
104997.419,
453600.702,
1.046
],
[
104997.419,
453600.702,
-2.119
],
[
104997.408,
453600.617,
-2.119
],
[
104997.408,
453600.617,
0.975
],
[
104997.419,
453600.702,
1.046
]
]
]
}
},
{
"orientation": "ES",
"area": 0.2096868942455473,
"perimeter": 4.170863163295509,
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
105011.77,
453602.959,
1.84
],
[
105011.77,
453602.959,
-2.119
],
[
105011.784,
453603.064,
-2.119
],
[
105011.784,
453603.064,
1.841
],
[
105011.77,
453602.959,
1.84
]
]
]
}
},
{
"orientation": "NE",
"area": 0.5015187960255274,
"perimeter": 4.487870179071035,
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
105011.784,
453603.064,
1.841
],
[
105011.784,
453603.064,
-2.119
],
[
105011.533,
453603.098,
-2.119
],
[
105011.533,
453603.098,
1.947
],
[
105011.784,
453603.064,
1.841
]
]
]
}
},
{
"orientation": "NE",
"area": 12.721319418335009,
"perimeter": 17.116103991775674,
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
105011.533,
453603.098,
1.947
],
[
105011.533,
453603.098,
-2.119
],
[
105005.334,
453603.951,
-2.119
],
[
105005.334,
453603.951,
4.59
],
[
105011.533,
453603.098,
1.947
]
]
]
}
},
{
"orientation": "SW",
"area": "",
"perimeter": 4.207896859649481,
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
105001.626,
453600.017,
1.601
],
[
105001.626,
453600.017,
0.938
],
[
105001.626,
453600.017,
-2.119
],
[
105001.856,
453599.985,
-2.119
],
[
105001.856,
453599.985,
1.708
],
[
105001.626,
453600.017,
1.601
]
]
]
}
},
{
"orientation": "WN",
"area": 0.0938717762124373,
"perimeter": 1.874986841707227,
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
105002.289,
453592.299,
3.975
],
[
105002.289,
453592.299,
2.328
],
[
105002.274,
453592.186,
2.327
],
[
105002.274,
453592.186,
3.975
],
[
105002.289,
453592.299,
3.975
]
]
]
}
},
{
"orientation": "NE",
"area": 8.122403549846428,
"perimeter": 14.267601077617252,
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
105005.334,
453603.951,
4.59
],
[
105005.334,
453603.951,
-2.119
],
[
105003.903,
453604.148,
-2.119
],
[
105003.903,
453604.148,
2.418
],
[
105003.903,
453604.148,
3.957
],
[
105005.334,
453603.951,
4.59
]
]
]
}
},
{
"orientation": "ES",
"area": 6.16192446466457,
"perimeter": 10.193452295871491,
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
105011.37,
453599.86,
1.825
],
[
105011.37,
453599.86,
-2.119
],
[
105011.77,
453602.959,
-2.119
],
[
105011.77,
453602.959,
1.84
],
[
105011.37,
453599.86,
1.825
]
]
]
}
},
{
"orientation": "WN",
"area": 3.386040146673642,
"perimeter": 7.925560271436407,
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
104997.63,
453602.222,
2.294
],
[
104997.63,
453602.222,