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.
Properties
| Property | Type | Mode | Description | Required |
|---|---|---|---|---|
| name | string | stored | Display name of the location Example: | Required |
| type | string | stored | Type of location indicating its primary purpose or category Values: Example: | Required |
| subtype | string | stored | Specific category or classification of the location for more granular identification Example: | Optional |
| description | string | stored | Detailed description of the location, its features, or special characteristics Example: | Optional |
| status | string | stored | Current operational status of the location Values: Example: | Required |
| address | PostalAddress | stored | Physical postal address for physical locations (reference to PostalAddress entity) | Optional |
| buildingName | string | stored | Name or identifier of the building where this location is situated Example: | Optional |
| floor | string | stored | Floor level or number within the building Example: | Optional |
| roomNumber | string | stored | Room, suite, or unit number within the building or floor Example: | Optional |
| capacity | number | stored | Maximum number of people or units that can occupy or be accommodated at this location Example: | Optional |
| area | number | stored | Total area or size of the location in square meters Example: | Optional |
| virtualUrl | string | stored | URL or link for virtual locations (meeting links, platform URLs, virtual room identifiers) Example: | Optional |
| virtualPlatform | string | stored | Name of the virtual platform or service provider for virtual locations Example: | Optional |
| accessInstructions | string | stored | Instructions for accessing the location (directions, entry codes, parking information, meeting credentials) Example: | Optional |
| accessibilityFeatures | string[] | stored | List of accessibility features available at this location for users with disabilities Example: | Optional |
| amenities | string[] | stored | Available amenities, facilities, or equipment at this location Example: | Optional |
| parentLocation | Location | stored | Reference to a parent location for hierarchical location structures (room within building, building within campus) | Optional |
| organization | Organization | stored | Reference to the Organization that owns or operates this location | Optional |
| manager | Person | stored | Reference to the Person responsible for managing or overseeing this location | Optional |
| contacts | ContactPoint[] | stored | Contact points specific to this location (phone, email, etc.) for location-specific inquiries | Optional |
| operatingHours | string | stored | Standard operating hours or availability schedule for this location Example: | Optional |
| timezone | string | stored | Timezone identifier for this location (IANA timezone format) Example: | Optional |
| imageUrl | string | stored | URL to an image or photo of the location for visual identification Example: | Optional |
| bookingUrl | string | stored | URL to a booking or reservation system for this location Example: | Optional |
| tags | string[] | stored | Searchable tags or labels for categorization and filtering Example: | Optional |
| metadata | json | stored | Additional location-specific metadata and custom fields for extensibility | Optional |
| isPhysical | boolean | calculated | Whether this is a physical location (type is physical) | Optional |
| isVirtual | boolean | calculated | Whether this is a virtual location (type is virtual) | Optional |
| isActive | boolean | calculated | Whether the location is currently active and operational (status is active) | Optional |
| hasCapacity | boolean | calculated | Whether capacity information is defined for this location | Optional |
| hasCoordinates | boolean | calculated | Whether geographic coordinates are available via address.latitude and address.longitude | Optional |
| fullAddress | string | calculated | Computed full address string combining all address components for display purposes | Optional |
| fullLocationPath | string | 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"
}
}