app.kalangitan.location.snapshot

kalangitan-lexicon.spaces-alpha.bsky.network

Documentation

A discrete "here's where I was" location record — a snapshot, like any other post. Contrast with app.kalangitan.location.live, which is a single continuously-overwritten record. Belongs to a persona via profileUri; the persona's location.visibility defaults govern whether snapshots are recorded at all and at what precision.

main record

A discrete "here's where I was" location record — a snapshot, like any other post. Contrast with app.kalangitan.location.live, which is a single continuously-overwritten record. Belongs to a persona via profileUri; the persona's location.visibility defaults govern whether snapshots are recorded at all and at what precision.

Record Key tid Timestamp-based ID

Properties

capturedAt string datetime Required

When the location was actually captured by the device.

createdAt string datetime Required

An RFC 3339 formatted timestamp.

profileUri string at-uri Required

AT-URI of the app.kalangitan.actor.profile record this snapshot belongs to.

View raw schema 
{
  "description": "A discrete \"here's where I was\" location record — a snapshot, like any other post. Contrast with app.kalangitan.location.live, which is a single continuously-overwritten record. Belongs to a persona via profileUri; the persona's location.visibility defaults govern whether snapshots are recorded at all and at what precision.",
  "key": "tid",
  "record": {
    "properties": {
      "capturedAt": {
        "description": "When the location was actually captured by the device.",
        "format": "datetime",
        "type": "string"
      },
      "createdAt": {
        "format": "datetime",
        "type": "string"
      },
      "geo": {
        "ref": "app.kalangitan.location.snapshot#geo",
        "type": "ref"
      },
      "profileUri": {
        "description": "AT-URI of the app.kalangitan.actor.profile record this snapshot belongs to.",
        "format": "at-uri",
        "type": "string"
      }
    },
    "required": [
      "profileUri",
      "geo",
      "capturedAt",
      "createdAt"
    ],
    "type": "object"
  },
  "type": "record"
}
geo object

Shared location shape, referenced by feed.post, feed.note, feed.story, and location.snapshot. Coordinates must already be coarsened to the persona's configured precision before the record is written — the precision field records which level was applied.

Properties

label string Optional

Optional human-readable place name.

maxLength: 256 bytesmaxGraphemes: 256 graphemes
latitude integer Required

Latitude in E7 microdegrees (degrees x 10^7), i.e. 145995000 = 14.5995N. The atproto data model has no float type, so coordinates are signed fixed-point integers.

minimum: -900000000maximum: 900000000
longitude integer Required

Longitude in E7 microdegrees (degrees x 10^7).

minimum: -1800000000maximum: 1800000000
precision string Required

exact: precise point. neighborhood: coarsened to ~1km. city: coarsened to city centroid/extent.

Known values: exact, neighborhood, city
View raw schema 
{
  "description": "Shared location shape, referenced by feed.post, feed.note, feed.story, and location.snapshot. Coordinates must already be coarsened to the persona's configured precision before the record is written — the precision field records which level was applied.",
  "properties": {
    "label": {
      "description": "Optional human-readable place name.",
      "maxGraphemes": 256,
      "maxLength": 256,
      "type": "string"
    },
    "latitude": {
      "description": "Latitude in E7 microdegrees (degrees x 10^7), i.e. 145995000 = 14.5995N. The atproto data model has no float type, so coordinates are signed fixed-point integers.",
      "maximum": 900000000,
      "minimum": -900000000,
      "type": "integer"
    },
    "longitude": {
      "description": "Longitude in E7 microdegrees (degrees x 10^7).",
      "maximum": 1800000000,
      "minimum": -1800000000,
      "type": "integer"
    },
    "precision": {
      "description": "exact: precise point. neighborhood: coarsened to ~1km. city: coarsened to city centroid/extent.",
      "knownValues": [
        "exact",
        "neighborhood",
        "city"
      ],
      "type": "string"
    }
  },
  "required": [
    "latitude",
    "longitude",
    "precision"
  ],
  "type": "object"
}

Lexicon Garden

@