Skip to content

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