Location · GraphQL type

Location type

A physical place identified by its global plus code (Open Location Code), with a street address resolved by reverse geocoding. Observed PositionSeen coordinates resolve to a Location, and many nearby positions can share one place. The address can be corrected by a user, and the correction then takes precedence over the geocoded result.

Fields

Field Name Description
id - ID! The Location's unique identifier on the security graph.
orgId - OrganizationId! Unique identifier that corresponds to your deployment of this product or a specific customer account that this Endpoint belongs to.
seen - SeenOnline! Describes when this Endpoint was seen online.
objectType - GraphObjectType! The type of this graph object.
objectTypeLabel - String! A localized label describing the object type.
displayName - String! A concise human-friendly identifier for this object suitable for display in user interface page titles and in AI chat responses that refer to the object.
firstSeen - Time! Time this object was first seen.
lastSeen - Time! Time this object was last seen.
createdAt - Time! The time this object was created in the security graph.
updatedAt - Time! The time this object was last mutated in the security graph.
snapshotInfo - GraphObjectSnapshotInfo! Whether this object is a point-in-time snapshot of an object's state rather than the object's live state, and when that state was observed.
address - PhysicalAddress! The physical address of this Location.
addressCorrected - Boolean! True if the address has been corrected by the user.
plusCodeGlobalCode - PlusCodeGlobalCode! A unique identifier of this Location in Open Location Code format, also known as a global plus code.
positionsSeen - PositionSeenConnection! Positions that have been associated with this Location.

Arguments

limit - Int

Maximum number of results to return.

skip - Int

Number of results to skip.
findings - FindingsPayload! Policy findings for this object.

Arguments

limit - Int

Maximum number of results to return.

skip - Int

Number of results to skip.
issues - IssuesPayload! Policy issues for this object.

Arguments

limit - Int

Maximum number of results to return.

skip - Int

Number of results to skip.
issuesSummary - IssuesSummary! Summary of the active policy issues currently open on this object, broken down by severity.

Returned by

  • location query: Retrieves a Location by its graph object id: a physical place, identified by its global plus code and street address, that observed positions…

Used by

  • PositionSeen type: A geographic coordinate (latitude and longitude) where a managed Endpoint was observed, and the times it was seen there.
  • GraphObjectType enum: An enumeration of the different types of security graph objects.
  • GraphObjectTypeCategory enum: High-level grouping used to organize GraphObjectType values in UI navigation and API discovery.
  • LocationPayload type: Payload wrapper for a single Location result.
  • SensorFilterLocations type: A filter considering the geographic location when determining if any sensors enabled by this scope apply to a Device or Network.

Example

Example

{
  "id": "4",
  "orgId": "615f3b3b28284380e28a7342",
  "seen": SeenOnline,
  "objectType": "ACCOUNT_POLICY",
  "objectTypeLabel": "abc123",
  "displayName": "abc123",
  "firstSeen": "2021-10-07T18:23:25.829Z",
  "lastSeen": "2021-10-07T18:23:25.829Z",
  "createdAt": "2021-10-07T18:23:25.829Z",
  "updatedAt": "2021-10-07T18:23:25.829Z",
  "snapshotInfo": GraphObjectSnapshotInfo,
  "address": PhysicalAddress,
  "addressCorrected": false,
  "plusCodeGlobalCode": "796RWF8Q+WF",
  "positionsSeen": PositionSeenConnection,
  "findings": FindingsPayload,
  "issues": IssuesPayload,
  "issuesSummary": IssuesSummary
}