DataStore

public classDataStore

Persisted location record management — query, upload, and destroy stored locations.

Access via BGGeo.instance.store.

---

Members

all

public func all() async throws -> [[String: Any]]

Retrieve all LocationEvent records stored in the SDK's SQLite database.

let bgGeo = BGGeo.shared
Task {
    do {
        let locations = try await bgGeo.store.all()
        print("[getLocations]", locations)
    } catch {
        print("Error: \(error)")
    }
}

count

public var count: Int

Retrieve the count of all locations currently stored in the SDK's SQLite database.

let bgGeo = BGGeo.shared
let count = bgGeo.store.count

destroy

public func destroy(_ uuid: String)

Remove a single location by LocationEvent.uuid.

let bgGeo = BGGeo.shared
let uuid = "some-location-uuid"
bgGeo.store.destroy(uuid)

destroyAll

public func destroyAll() async throws

Remove all records from the SDK's SQLite database.

let bgGeo = BGGeo.shared
Task {
    do {
        try await bgGeo.store.destroyAll()
    } catch {
        print("Error: \(error)")
    }
}

sync

public func sync() async throws -> [[String: Any]]

Manually upload all queued locations to HttpConfig.url.

Initiates a POST of all records in the SQLite database to your configured HttpConfig.url. Records that receive a 200 OK response are deleted from the database. If HttpConfig.batchSync is true, all locations are sent in a single request; otherwise one request is made per location. If no HTTP service is configured, all records are deleted from the database.

See also - HTTP Guide

let bgGeo = BGGeo.shared
Task {
    do {
        let records = try await bgGeo.store.sync()
        print("[sync] success: \(records)")
    } catch {
        print("[sync] FAILURE: \(error)")
    }
}