In this release

Building REC class model was expanded with primary basic building info: Address and Area Quantity. In this release a batch of new Asset subclasses was added. 

New functionality

RealEstate and Building basic info

Now the RealEstate and Building twin objects may keep a list of Address and apart that Building may keep a list of Area Quantity items.

Adress model:

{
      “type”: “postal”,
      “address”: {
          “streetAddress”: “Kungsgatan 50”,
          “postalCode”: null,
          “city”: null,
          “countryName”: “Sweden”,
         “locality”: null,
         “region”: null
}

Where:

  • ‘type’ : address type (postal, visiting, etc.);

Area Quantity model:

{
 “type”: “BOA”,
 “value”: 250.0,
 “measurementUnit“: “https://w3id.org/rec/core/SquareMeter“
}

Where:

  • ‘type’ : area quantity type (BOA, LOA, ATEMP, etc.)
  • ‘measurementUnit’ default value is “https://w3id.org/rec/core/SquareMeter”

Note: ‘measurementUnit’ should be a valid measurement unit IRI.

Basic building information population

Building information may be populated via existing RealEstate Component endpoints:

  • POST /json/realestate
  • PUT /json/realestate
  • POST /json/realestates
  • PUT /json/realestates
  • POST /json/realestatecomponent
  • PUT /json/realestatecomponent
  • POST /json/realestatecomponents
  • PUT /json/realestatecomponents

Example of full building json:

{
 “class”: “Building”,
 “addresses”: [
 {
 “type”: “postal”,
 “address”: {
 “streetAddress”: “Kungsgatan 50”,
 “postalCode”: null,
 “city”: null,
 “countryName”: “Sweden”,
 “locality”: null,
 “region”: null
 }
 },
 {
 “type”: “visiting”,
 “address”: {
 “streetAddress”: “Kungsgatan 52”,
 “postalCode”: null,
 “city”: null,
 “countryName”: “Sweden”,
 “locality”: null,
 “region”: null
 }
 }
 ],
 “areaQuantities”: [
 {
 “type”: “BOA”,
 “value”: 250.0,
 “measurementUnit”: “https://w3id.org/rec/core/SquareMeter”
 },
 {
 “type”: “LOA”,
 “value”: 350.0,
 “measurementUnit”: “https://w3id.org/rec/core/SquareMeter”
 }
 ],
 “id”: “dacd57e2-5d77-4ef4-b566-69a4a51ae90e”,
 “class”: “Building”,
 “status”: “Incomplete”,
 “createdTime”: null,
 “updatedTime”: null,
 “hasAlias”: null,
 “comment”: {
},
 “littera”: “AA0011”,
 “popularName”: “5MGzdWyZsoQ7eu0”,
 “createdByAgent”: null,
 “updatedByAgent”: null,
 “source”: {
},
 “isPartOfRealEstate”: “04fb5522-73ef-443b-988e-987da0c865f1”,
 “hasGeoReferenceOrigo”: “67.789789;89.45456;10”
}

Application scopes details

There is a new endpoint to get detailed information about supported applications scopes:

  • GET /json/application/scopes

Response example:

[
 {
 “type”: “Delegated”,
 “value”: “https://proptechos.onmicrosoft.com/{env}/api/Api.Use”
 },
 {
 “type”: “Application”,
 “value”: “https://proptechos.onmicrosoft.com/{env}/api/.default”
 }
]

“locatedInBuildings” filter for collections

There is a new filter for collections GET endpoints.

The list of endpoints with a new filter:

  • GET /json/collection
  • GET /json/tenantunit
  • GET /json/spacecollection
  • GET /json/system

For example:

  • /json/spacecollection?building_ids=38dead16-8c58-4cda-a832-e4542e58494

Asset subclasses

We add new Asset classes.

Breaking changes

None.

Fixes and minor updated

None.