Location

Represents a place where activities, events, or operations occur, encompassing both physical locations (buildings, rooms, warehouses, offices, venues) and virtual locations (video conferencing links, online platforms, virtual meeting rooms). Location serves as the universal spatial reference point for any business entity or event across all domains. Physical locations include detailed address information, building and room identifiers, accessibility features, and geographic coordinates for mapping and proximity analysis. Virtual locations capture meeting URLs, platform identifiers, and access credentials. The entity supports capacity management for space planning, operating hours for scheduling, and contact information for location-specific inquiries. Location can represent spaces at any granularity level - from entire campuses and buildings down to specific rooms and desks, or from virtual platforms down to specific meeting room URLs. This enables comprehensive facility management, resource allocation, event scheduling, delivery logistics, and location-based analytics across all industries and domains.

33 properties
Schema

Properties

PropertyTypeModeDescriptionRequired
namestring
stored

Display name of the location

Example: "Conference Room A - Building 3"

Required
typestring
stored

Type of location indicating its primary purpose or category

Values: physical, virtual

Example: "physical"

Required
subtypestring
stored

Specific category or classification of the location for more granular identification

Example: "conference-room"

Optional
descriptionstring
stored

Detailed description of the location, its features, or special characteristics

Example: "Large conference room with video conferencing capabilities, whiteboard, and presentation equipment"

Optional
statusstring
stored

Current operational status of the location

Values: active, inactive, maintenance, closed, temporarily-unavailable

Example: "active"

Required
addressPostalAddress
stored

Physical postal address for physical locations (reference to PostalAddress entity)

Optional
buildingNamestring
stored

Name or identifier of the building where this location is situated

Example: "Headquarters Building 3"

Optional
floorstring
stored

Floor level or number within the building

Example: "2nd Floor"

Optional
roomNumberstring
stored

Room, suite, or unit number within the building or floor

Example: "Room 205-A"

Optional
capacitynumber
stored

Maximum number of people or units that can occupy or be accommodated at this location

Example: 25

Optional
areanumber
stored

Total area or size of the location in square meters

Example: 75.5

Optional
virtualUrlstring
stored

URL or link for virtual locations (meeting links, platform URLs, virtual room identifiers)

Example: "https://meet.example.com/room/abc-123-def"

Optional
virtualPlatformstring
stored

Name of the virtual platform or service provider for virtual locations

Example: "Zoom"

Optional
accessInstructionsstring
stored

Instructions for accessing the location (directions, entry codes, parking information, meeting credentials)

Example: "Enter through main lobby, use elevator to 2nd floor, room is on the right. Access code: 1234"

Optional
accessibilityFeaturesstring[]
stored

List of accessibility features available at this location for users with disabilities

Example: ["wheelchair-accessible","hearing-loop","braille-signage"]

Optional
amenitiesstring[]
stored

Available amenities, facilities, or equipment at this location

Example: ["wifi","projector","whiteboard","video-conferencing","catering"]

Optional
parentLocationLocation
stored

Reference to a parent location for hierarchical location structures (room within building, building within campus)

Optional
organizationOrganization
stored

Reference to the Organization that owns or operates this location

Optional
managerPerson
stored

Reference to the Person responsible for managing or overseeing this location

Optional
contactsContactPoint[]
stored

Contact points specific to this location (phone, email, etc.) for location-specific inquiries

Optional
operatingHoursstring
stored

Standard operating hours or availability schedule for this location

Example: "Monday-Friday: 8:00 AM - 6:00 PM, Saturday: 9:00 AM - 1:00 PM, Sunday: Closed"

Optional
timezonestring
stored

Timezone identifier for this location (IANA timezone format)

Example: "America/New_York"

Optional
imageUrlstring
stored

URL to an image or photo of the location for visual identification

Example: "https://example.com/images/conference-room-a.jpg"

Optional
bookingUrlstring
stored

URL to a booking or reservation system for this location

Example: "https://booking.example.com/locations/conf-room-a"

Optional
tagsstring[]
stored

Searchable tags or labels for categorization and filtering

Example: ["meeting-space","presentations","video-enabled"]

Optional
metadatajson
stored

Additional location-specific metadata and custom fields for extensibility

Optional
isPhysicalboolean
calculated

Whether this is a physical location (type is physical)

Optional
isVirtualboolean
calculated

Whether this is a virtual location (type is virtual)

Optional
isActiveboolean
calculated

Whether the location is currently active and operational (status is active)

Optional
hasCapacityboolean
calculated

Whether capacity information is defined for this location

Optional
hasCoordinatesboolean
calculated

Whether geographic coordinates are available via address.latitude and address.longitude

Optional
fullAddressstring
calculated

Computed full address string combining all address components for display purposes

Optional
fullLocationPathstring
calculated

Complete hierarchical path from root location to this location (e.g., 'Campus > Building 3 > Floor 2 > Room 205-A')

Optional

Examples

Example 1

{
  "@type": "Location",
  "name": "Conference Room A - Building 3",
  "type": "physical",
  "subtype": "conference-room",
  "description": "Large conference room with video conferencing capabilities, whiteboard, and presentation equipment",
  "status": "active",
  "address": {
    "@type": "PostalAddress",
    "use": "work",
    "streetAddress": "100 Innovation Drive",
    "addressLocality": "San Francisco",
    "addressRegion": "CA",
    "postalCode": "94105",
    "addressCountry": "US",
    "latitude": 37.7749,
    "longitude": -122.4194
  },
  "buildingName": "Headquarters Building 3",
  "floor": "2nd Floor",
  "roomNumber": "Room 205-A",
  "capacity": 25,
  "area": 75.5,
  "accessInstructions": "Enter through main lobby, use elevator to 2nd floor, room is on the right. Access code: 1234",
  "accessibilityFeatures": [
    "wheelchair-accessible",
    "hearing-loop",
    "automatic-doors"
  ],
  "amenities": [
    "wifi",
    "projector",
    "whiteboard",
    "video-conferencing",
    "phone",
    "hdmi-cables"
  ],
  "contacts": [
    {
      "@type": "ContactPoint",
      "system": "phone",
      "value": "+1-555-0123",
      "use": "work",
      "label": "Front Desk"
    },
    {
      "@type": "ContactPoint",
      "system": "email",
      "value": "building3@example.com",
      "use": "work"
    }
  ],
  "operatingHours": "Monday-Friday: 7:00 AM - 7:00 PM",
  "timezone": "America/Los_Angeles",
  "imageUrl": "https://example.com/images/conf-room-a.jpg",
  "bookingUrl": "https://booking.example.com/locations/conf-room-a",
  "tags": [
    "meeting-space",
    "presentations",
    "video-enabled",
    "large-capacity"
  ]
}

Example 2

{
  "@type": "Location",
  "name": "Virtual Team Meeting Room",
  "type": "virtual",
  "subtype": "video-conference",
  "description": "Dedicated virtual meeting room for recurring team meetings and standups",
  "status": "active",
  "capacity": 100,
  "virtualUrl": "https://meet.example.com/room/engineering-standup",
  "virtualPlatform": "Zoom",
  "accessInstructions": "Meeting ID: 123-456-789, Password: teamstandup2024",
  "operatingHours": "Available 24/7",
  "timezone": "UTC",
  "tags": [
    "virtual",
    "recurring",
    "engineering"
  ]
}

Example 3

{
  "@type": "Location",
  "name": "Main Warehouse - Distribution Center",
  "type": "physical",
  "subtype": "warehouse",
  "description": "Primary distribution center for west coast operations with refrigerated storage and loading docks",
  "status": "active",
  "address": {
    "@type": "PostalAddress",
    "use": "warehouse",
    "streetAddress": "5000 Logistics Parkway",
    "addressLocality": "Oakland",
    "addressRegion": "CA",
    "postalCode": "94621",
    "addressCountry": "US",
    "latitude": 37.7599,
    "longitude": -122.2073
  },
  "buildingName": "Distribution Center West",
  "capacity": 50,
  "area": 15000,
  "accessInstructions": "Truck entrance on north side. Check in at security gate. Loading docks 1-8 available.",
  "accessibilityFeatures": [
    "ground-level-access",
    "wide-aisles"
  ],
  "amenities": [
    "loading-docks",
    "refrigerated-storage",
    "forklift-equipment",
    "security-system",
    "parking"
  ],
  "manager": {
    "@type": "Person",
    "givenName": "Sarah",
    "familyName": "Johnson"
  },
  "contacts": [
    {
      "@type": "ContactPoint",
      "system": "phone",
      "value": "+1-555-0456",
      "use": "work",
      "label": "Warehouse Office"
    },
    {
      "@type": "ContactPoint",
      "system": "email",
      "value": "warehouse.west@example.com",
      "use": "work"
    }
  ],
  "operatingHours": "Monday-Friday: 6:00 AM - 6:00 PM, Saturday: 8:00 AM - 2:00 PM",
  "timezone": "America/Los_Angeles",
  "imageUrl": "https://example.com/images/warehouse-west.jpg",
  "tags": [
    "warehouse",
    "distribution",
    "refrigerated",
    "west-coast"
  ],
  "metadata": {
    "warehouseCode": "WH-WEST-001",
    "storageType": "climate-controlled",
    "loadingDocks": 8
  }
}

Example 4

{
  "@type": "Location",
  "name": "Examination Room 3",
  "type": "physical",
  "subtype": "medical-room",
  "description": "Examination room equipped for general practice consultations and minor procedures",
  "status": "active",
  "address": {
    "@type": "PostalAddress",
    "use": "work",
    "streetAddress": "450 Medical Plaza",
    "addressLocality": "Boston",
    "addressRegion": "MA",
    "postalCode": "02115",
    "addressCountry": "US",
    "latitude": 42.3398,
    "longitude": -71.0892
  },
  "buildingName": "Medical Center East Wing",
  "floor": "3rd Floor",
  "roomNumber": "E-305",
  "capacity": 3,
  "area": 18,
  "parentLocation": {
    "@type": "Location",
    "name": "Medical Center East Wing"
  },
  "accessInstructions": "Take elevator to 3rd floor, turn left, room is third door on right",
  "accessibilityFeatures": [
    "wheelchair-accessible",
    "adjustable-exam-table"
  ],
  "amenities": [
    "exam-table",
    "medical-equipment",
    "sink",
    "computer-workstation"
  ],
  "contacts": [
    {
      "@type": "ContactPoint",
      "system": "phone",
      "value": "+1-555-0789",
      "use": "work",
      "label": "Reception"
    }
  ],
  "operatingHours": "Monday-Friday: 8:00 AM - 5:00 PM",
  "timezone": "America/New_York",
  "tags": [
    "medical",
    "examination",
    "outpatient"
  ],
  "metadata": {
    "department": "General Practice",
    "equipmentLastInspected": "2024-11-01"
  }
}

Example 5

{
  "@type": "Location",
  "name": "Coworking Hot Desk Area",
  "type": "physical",
  "subtype": "open-workspace",
  "description": "Flexible hot-desking area with 20 workstations available on first-come, first-served basis",
  "status": "active",
  "address": {
    "@type": "PostalAddress",
    "use": "work",
    "streetAddress": "75 Innovation Street",
    "addressLocality": "Austin",
    "addressRegion": "TX",
    "postalCode": "78701",
    "addressCountry": "US",
    "latitude": 30.2672,
    "longitude": -97.7431
  },
  "buildingName": "Innovation Hub",
  "floor": "1st Floor",
  "capacity": 20,
  "area": 200,
  "accessInstructions": "Badge access required at main entrance. Hot desks available without reservation.",
  "accessibilityFeatures": [
    "wheelchair-accessible",
    "adjustable-desks"
  ],
  "amenities": [
    "wifi",
    "power-outlets",
    "monitors",
    "standing-desks",
    "coffee-station",
    "printing"
  ],
  "contacts": [
    {
      "@type": "ContactPoint",
      "system": "email",
      "value": "workspace@innovationhub.com",
      "use": "work"
    }
  ],
  "operatingHours": "Monday-Sunday: 24/7 for members",
  "timezone": "America/Chicago",
  "bookingUrl": "https://workspace.innovationhub.com/hotdesks",
  "tags": [
    "coworking",
    "hot-desk",
    "flexible",
    "open-space"
  ],
  "metadata": {
    "membershipRequired": true,
    "reservationPolicy": "first-come-first-served"
  }
}