Building

Definition

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

IMPORTANT: 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