Class: Location
_A Location represents a geographic location. The location may be described as any, some or all of the following: region (e.g., North America), civic address (e.g. New York, US), latitude and longitude. _
URI: attack:Location
classDiagram
class Location
click Location href "../Location/"
StixDomainObject <|-- Location
click StixDomainObject href "../StixDomainObject/"
Location : administrative_area
Location : city
Location : confidence
Location : country
Location : created
Location : created_by_ref
Location : description
Location : extensions
Location : external_references
Location --> "*" ExternalReference : external_references
click ExternalReference href "../ExternalReference/"
Location : granular_markings
Location --> "*" GranularMarking : granular_markings
click GranularMarking href "../GranularMarking/"
Location : id
Location : labels
Location : lang
Location : latitude
Location : longitude
Location : modified
Location : name
Location : object_marking_refs
Location : postal_code
Location : precision
Location : region
Location : revoked
Location : spec_version
Location --> "1" SpecVersionEnum : spec_version
click SpecVersionEnum href "../SpecVersionEnum/"
Location : street_address
Location : type
Inheritance
Slots
| Name | Cardinality and Range | Description | Inheritance |
|---|---|---|---|
| latitude | 0..1 Float |
Latitude in decimal degrees | direct |
| longitude | 0..1 Float |
Longitude in decimal degrees | direct |
| precision | 0..1 Float |
Coordinate precision in meters | direct |
| region | 0..1 String |
Geographic region | direct |
| country | 0..1 String |
Country name | direct |
| administrative_area | 0..1 String |
Sub-national administrative area | direct |
| city | 0..1 String |
City name | direct |
| street_address | 0..1 String |
Street address | direct |
| postal_code | 0..1 String |
Postal code | direct |
| type | 1 StixTypeName |
STIX object type | Core, StixEntity |
| spec_version | 1 SpecVersionEnum |
STIX specification version | Core |
| id | 1 StixIdentifier |
STIX object identifier | Core, StixEntity |
| created | 1 Datetime |
Creation timestamp | Core |
| modified | 1 Datetime |
Modification timestamp | Core |
| created_by_ref | 0..1 StixIdentifier |
ID of the object that created this object | Core |
| labels | * String |
Terms used to describe this object | Core |
| revoked | 0..1 Boolean |
Indicates whether this object has been revoked | Core |
| confidence | 0..1 Integer |
Confidence that the producer has in this data | Core |
| lang | 0..1 String |
Language of textual properties | Core |
| external_references | * ExternalReference |
External references to non-STIX information | Core |
| object_marking_refs | * StixIdentifier |
Marking definition references applied to this object | Core |
| granular_markings | * GranularMarking |
Granular markings that apply to selected content | Core |
| extensions | * String |
Open-ended extension payloads | Core |
| name | 0..1 String |
Human-readable name | StixEntity |
| description | 0..1 String |
Human-readable description | StixEntity |
In Subsets
Comments
- jsonschema_rule: anyOf+oneOf validator_hint: enforce-location-coordinate-and-region-rules jsonschema_source: https://github.com/oasis-open/cti-stix2-json-schemas/tree/master/schemas/sdos/location.json
Notes
- JSON Schema requires one of region, country, or latitude+longitude and constrains precision usage.
Identifier and Mapping Information
Schema Source
- from schema: https://w3id.org/lmodel/attack
Mappings
| Mapping Type | Mapped Value |
|---|---|
| self | attack:Location |
| native | attack:Location |
| exact | unified_cyber_ontology:Location |
LinkML Source
Direct
name: Location
description: 'A Location represents a geographic location. The location may be described
as any, some or all of the following: region (e.g., North America), civic address
(e.g. New York, US), latitude and longitude. '
notes:
- JSON Schema requires one of region, country, or latitude+longitude and constrains
precision usage.
comments:
- 'jsonschema_rule: anyOf+oneOf validator_hint: enforce-location-coordinate-and-region-rules
jsonschema_source: https://github.com/oasis-open/cti-stix2-json-schemas/tree/master/schemas/sdos/location.json'
in_subset:
- sdos
from_schema: https://w3id.org/lmodel/attack
exact_mappings:
- unified_cyber_ontology:Location
is_a: StixDomainObject
slots:
- latitude
- longitude
- precision
- region
- country
- administrative_area
- city
- street_address
- postal_code
slot_usage:
id:
name: id
pattern: ^location--[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$
type:
name: type
pattern: ^location$
Induced
name: Location
description: 'A Location represents a geographic location. The location may be described
as any, some or all of the following: region (e.g., North America), civic address
(e.g. New York, US), latitude and longitude. '
notes:
- JSON Schema requires one of region, country, or latitude+longitude and constrains
precision usage.
comments:
- 'jsonschema_rule: anyOf+oneOf validator_hint: enforce-location-coordinate-and-region-rules
jsonschema_source: https://github.com/oasis-open/cti-stix2-json-schemas/tree/master/schemas/sdos/location.json'
in_subset:
- sdos
from_schema: https://w3id.org/lmodel/attack
exact_mappings:
- unified_cyber_ontology:Location
is_a: StixDomainObject
slot_usage:
id:
name: id
pattern: ^location--[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$
type:
name: type
pattern: ^location$
attributes:
latitude:
name: latitude
description: Latitude in decimal degrees.
from_schema: https://w3id.org/lmodel/attack
rank: 1000
alias: latitude
owner: Location
domain_of:
- Location
range: float
minimum_value: -90
maximum_value: 90
longitude:
name: longitude
description: Longitude in decimal degrees.
from_schema: https://w3id.org/lmodel/attack
rank: 1000
alias: longitude
owner: Location
domain_of:
- Location
range: float
minimum_value: -180
maximum_value: 180
precision:
name: precision
description: Coordinate precision in meters.
from_schema: https://w3id.org/lmodel/attack
rank: 1000
alias: precision
owner: Location
domain_of:
- Location
range: float
region:
name: region
description: Geographic region.
from_schema: https://w3id.org/lmodel/attack
rank: 1000
alias: region
owner: Location
domain_of:
- Location
range: string
country:
name: country
description: Country name.
from_schema: https://w3id.org/lmodel/attack
rank: 1000
alias: country
owner: Location
domain_of:
- Location
range: string
administrative_area:
name: administrative_area
description: Sub-national administrative area.
from_schema: https://w3id.org/lmodel/attack
rank: 1000
alias: administrative_area
owner: Location
domain_of:
- Location
range: string
city:
name: city
description: City name.
from_schema: https://w3id.org/lmodel/attack
rank: 1000
alias: city
owner: Location
domain_of:
- Location
range: string
street_address:
name: street_address
description: Street address.
from_schema: https://w3id.org/lmodel/attack
rank: 1000
alias: street_address
owner: Location
domain_of:
- Location
range: string
postal_code:
name: postal_code
description: Postal code.
from_schema: https://w3id.org/lmodel/attack
rank: 1000
alias: postal_code
owner: Location
domain_of:
- Location
range: string
type:
name: type
description: STIX object type.
from_schema: https://w3id.org/lmodel/attack
related_mappings:
- unified_cyber_ontology:state
rank: 1000
alias: type
owner: Location
domain_of:
- StixEntity
- Bundle
- Core
- CyberObservableCore
- ExtensionDefinition
- LanguageContent
- MarkingDefinition
- File
range: stix_type_name
required: true
pattern: ^location$
spec_version:
name: spec_version
description: STIX specification version.
from_schema: https://w3id.org/lmodel/attack
close_mappings:
- unified_cyber_ontology:specVersion
rank: 1000
alias: spec_version
owner: Location
domain_of:
- Core
- CyberObservableCore
- MarkingDefinition
range: SpecVersionEnum
required: true
id:
name: id
description: STIX object identifier.
from_schema: https://w3id.org/lmodel/attack
related_mappings:
- unified_cyber_ontology:externalReference
rank: 1000
alias: id
owner: Location
domain_of:
- StixEntity
- Bundle
- Core
- CyberObservableCore
- ExtensionDefinition
- LanguageContent
- MarkingDefinition
- File
range: stix_identifier
required: true
pattern: ^location--[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$
created:
name: created
description: Creation timestamp.
notes:
- STIX core timestamps require millisecond precision.
from_schema: https://w3id.org/lmodel/attack
close_mappings:
- unified_cyber_ontology:objectCreatedTime
rank: 1000
alias: created
owner: Location
domain_of:
- Core
- MarkingDefinition
range: datetime
required: true
pattern: T\d{2}:\d{2}:\d{2}\.\d{3,}Z$
modified:
name: modified
description: Modification timestamp.
notes:
- STIX core timestamps require millisecond precision.
from_schema: https://w3id.org/lmodel/attack
close_mappings:
- unified_cyber_ontology:modifiedTime
rank: 1000
alias: modified
owner: Location
domain_of:
- Core
range: datetime
required: true
pattern: T\d{2}:\d{2}:\d{2}\.\d{3,}Z$
created_by_ref:
name: created_by_ref
description: ID of the object that created this object.
from_schema: https://w3id.org/lmodel/attack
close_mappings:
- unified_cyber_ontology:createdBy
rank: 1000
alias: created_by_ref
owner: Location
domain_of:
- Core
- MarkingDefinition
range: stix_identifier
labels:
name: labels
description: Terms used to describe this object.
comments:
- 'jsonschema_minItems: "1"'
from_schema: https://w3id.org/lmodel/attack
close_mappings:
- unified_cyber_ontology:tag
rank: 1000
alias: labels
owner: Location
domain_of:
- Core
range: string
multivalued: true
revoked:
name: revoked
description: Indicates whether this object has been revoked.
from_schema: https://w3id.org/lmodel/attack
rank: 1000
alias: revoked
owner: Location
domain_of:
- Core
range: boolean
confidence:
name: confidence
description: Confidence that the producer has in this data.
from_schema: https://w3id.org/lmodel/attack
rank: 1000
alias: confidence
owner: Location
domain_of:
- Core
range: integer
minimum_value: 0
maximum_value: 100
lang:
name: lang
description: Language of textual properties.
from_schema: https://w3id.org/lmodel/attack
rank: 1000
alias: lang
owner: Location
domain_of:
- Core
- GranularMarking
range: string
external_references:
name: external_references
description: External references to non-STIX information.
comments:
- 'jsonschema_minItems: "1"'
from_schema: https://w3id.org/lmodel/attack
close_mappings:
- unified_cyber_ontology:externalReference
rank: 1000
alias: external_references
owner: Location
domain_of:
- Core
- MarkingDefinition
range: ExternalReference
multivalued: true
object_marking_refs:
name: object_marking_refs
description: Marking definition references applied to this object.
comments:
- 'jsonschema_minItems: "1"'
from_schema: https://w3id.org/lmodel/attack
close_mappings:
- unified_cyber_ontology:objectMarking
rank: 1000
alias: object_marking_refs
owner: Location
domain_of:
- Core
- CyberObservableCore
- MarkingDefinition
range: stix_identifier
multivalued: true
granular_markings:
name: granular_markings
description: Granular markings that apply to selected content.
comments:
- 'jsonschema_minItems: "1"'
from_schema: https://w3id.org/lmodel/attack
narrow_mappings:
- unified_cyber_ontology:objectMarking
rank: 1000
alias: granular_markings
owner: Location
domain_of:
- Core
- CyberObservableCore
- MarkingDefinition
range: GranularMarking
multivalued: true
extensions:
name: extensions
description: Open-ended extension payloads.
notes:
- JSON Schema uses patternProperties for extension keys; exact key validation
is delegated to validator tooling.
comments:
- 'jsonschema_rule: patternProperties validator_hint: validate-extension-keys-and-values'
from_schema: https://w3id.org/lmodel/attack
related_mappings:
- unified_cyber_ontology:hasFacet
rank: 1000
alias: extensions
owner: Location
domain_of:
- Core
- CyberObservableCore
- MarkingDefinition
- File
range: string
multivalued: true
name:
name: name
description: Human-readable name.
from_schema: https://w3id.org/lmodel/attack
exact_mappings:
- unified_cyber_ontology:name
rank: 1000
alias: name
owner: Location
domain_of:
- RelatedAsset
- StixEntity
- ExtensionDefinition
- MarkingDefinition
- AutonomousSystem
- File
range: string
description:
name: description
description: Human-readable description.
from_schema: https://w3id.org/lmodel/attack
close_mappings:
- unified_cyber_ontology:description
rank: 1000
alias: description
owner: Location
domain_of:
- RelatedAsset
- MutableElement
- StixEntity
- ExtensionDefinition
- ExternalReference
range: string