Skip to main content

LocationHistory

The LocationHistory type represents a historical location record for a tracker. It combines data from location reports and provides additional context such as nearest city information.

Fields

FieldTypeDescription
idID!Unique identifier for the location history record
timestampDateTime!The timestamp when the location was recorded
locationCoordinates!The geographical coordinates of the location
nearestCityStringThe nearest city to the location (if available)
trackerTracker!The tracker associated with this location
confidenceIntConfidence level of the location data (1-3, where 3 is highest)
horizontalAccuracyFloatHorizontal accuracy of the location in meters

Example

{
locationHistoryByTracker(trackerId: "123") {
id
timestamp
location {
latitude
longitude
}
nearestCity
confidence
horizontalAccuracy
tracker {
id
name
}
}
}

Notes

  • The confidence field uses a scale of 1-3:

    • 1: Low confidence
    • 2: Medium confidence
    • 3: High confidence
  • The horizontalAccuracy field represents the accuracy radius in meters. Lower values indicate more precise location data.

  • Location history records are filtered by default to only include medium to high confidence reports (confidence >= 2).

  • The nearestCity field is populated through an asynchronous geocoding process and may not be immediately available for new location records.