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.