Description

A Building describes a physical building structure associated with a Venue.

NOTE: Building records are captured as unlocated features, deferring representation of their physical extents to associated Footprint features

Object Structure

  • Building objects are unlocated Feature objects
  • Building objects MUST have an "id" member with a FEATURE-ID value
  • Building objects MUST have a "feature_type" member with the value "building"
  • Building objects MUST have a "geometry" member with a null value

Property Keys

Property Type Description
name null or LABELS The official name for the Building as declared by the Venue Organization
alt_name null or LABELS Alternative name for the Building that may be recognized by the Venue Organization or which is commonly used amongst pedestrians that frequent the Building
category BUILDING-CATEGORY The category that best describes the function of the physical Building
restriction null or RESTRICTION-CATEGORY The category that best describes a restriction that applies to the entire physical Building
display_point null or DISPLAY-POINT The curated location to use as the point-based representation of the Building
address_id null or ADDRESS-ID ID reference to Address record

Example

{
  "id": "11111111-1111-1111-1111-111111111111",
  "type": "Feature",
  "feature_type": "building",
  "geometry": null,
  "properties": {
    "category": "parking",
    "restriction": "employeesonly",
    "name": {
      "en": "Parking Garage 1"
    },
    "alt_name": null,
    "display_point": {
      "type": "Point",
      "coordinates": [1.0, 2.0]
    },
    "address_id": "2222222-2222-2222-2222-222222222222"
  }
}

Property Capturing Rules

Address ID

  • MAY reference the Address referenced by the Venue
  • null value implies that the Address associated with the Venue is applicable to the Building

Category

  • MUST have value "parking" if the described Building is an enclosed environment whose intended purpose is the storage of vehicles

  • SHOULD have value "transit" (hierarchy) if the described Building's operational function is distinct and different from an "unspecified" Building whose operational function is effectively described by the Venue's category

Display Point

  • MUST be located within a Footprint referencing the Building.
    • Display-point is a cartographic preference that may be leveraged for map labeling purposes.
    • Display-point and Address are "decoupled" and do not invoke specialized system handling

Name

  • MUST not be the same as an Occupant within it when it is reasonable to assume that tenancy is temporary

Illustration

Tenants in this Building are temporary. A physical building may undergo renovations, and spaces merged and split to accommodate new tenant build-out requirements. Consequently, the Building should remain unnamed

Restriction

  • A Venue Organization that deliberately wishes to capture a mix of non-public and public buildings SHOULD set a restriction on each non-public Building