Geo Location

location

The Geo Location object describes a geographical location, usually associated with an IP address.

Attributes

CaptionNameTypeDescription
Aerial Heightaerial_heightString

Expressed as either height above takeoff location or height above ground level (AGL) for a UAS current location. This value is provided in meters and must have a minimum resolution of 1 m. Special Values: Invalid, No Value, or Unknown: -1000 m.

CitycityString

The name of the city.

ContinentcontinentString

The name of the continent.

CoordinatescoordinatesFloat[]

A two-element array, containing a longitude/latitude pair. The format conforms with GeoJSON. For example: [-73.983, 40.719].

🚧 WARNING: DEPRECATED

Coordinates has been deprecated since 1.2.0. Use specific lat, long attributes instead.

CountrycountryString

Entity:COUNTRY
The ISO 3166-1 Alpha-2 country code.

Note: The two letter country code should be capitalized. For example: US or CA.

DescriptiondescString

The description of the geographical location.

Geodetic Altitudegeodetic_altitudeString

The aircraft distance above or below the ellipsoid as measured along a line that passes through the aircraft and is normal to the surface of the WGS-84 ellipsoid. This value is provided in meters and must have a minimum resolution of 1 m. Special Values: Invalid, No Value, or Unknown: -1000 m.

Geodetic Vertical Accuracygeodetic_vertical_accuracyString

Provides quality/containment on geodetic altitude. This is based on ADS-B Geodetic Vertical Accuracy (GVA). Measured in meters.

GeohashgeohashString

Geohash of the geo-coordinates (latitude and longitude).

Geohashing is a geocoding system used to encode geographic coordinates in decimal degrees, to a single string.

Horizontal Accuracyhorizontal_accuracyString

Provides quality/containment on horizontal position. This is based on ADS-B NACp. Measured in meters.

On Premisesis_on_premisesBoolean

The indication of whether the location is on premises.

ISPispString

The name of the Internet Service Provider (ISP).

LatitudelatFloat

The geographical Latitude coordinate represented in Decimal Degrees (DD). For example: 42.361145.

LongitudelongFloat

The geographical Longitude coordinate represented in Decimal Degrees (DD). For example: -71.057083.

Postal Codepostal_codeString

The postal code of the location.

Pressure Altitudepressure_altitudeString

The uncorrected barometric pressure altitude (based on reference standard 29.92 inHg, 1013.25 mb) provides a reference for algorithms that utilize 'altitude deltas' between aircraft. This value is provided in meters and must have a minimum resolution of 1 m.. Special Values: Invalid, No Value, or Unknown: -1000 m.

ProviderproviderString

The provider of the geographical location data.

Raw Dataraw_dataJSON

Group:context
The event data as received from the event source.

Record IDrecord_idString

Group:primary
Unique identifier for the object

RegionregionString

The alphanumeric code that identifies the principal subdivision (e.g. province or state) of the country. For example, 'CH-VD' for the Canton of Vaud, Switzerland

UnmappedunmappedUnmapped[]

Data from the source that was not mapped into the schema.

Relationships

Geo Location shown in context

Inbound Relationships

These objects and events reference Geo Location in their attributes:

Outbound Relationships

Geo Location references the following objects and events in its attributes:

This page describes ocsf-1.4.0