GIS annotation - JSON

Prev Next

Overview

The GIS Annotation JSON Format in Dataloop provides a structured representation of each annotation associated with a GIS data item, including spatial, labeling, and metadata details essential for geospatial analysis and annotation tasks. Here’s an explanation of its structure based on the provided content

To download the JSON file of an item’s annotations, click here. This JSON code includes the entity's data related to our software and its metadata.


GIS Annotation JSON Format

{
  "annotations": [
    {
      "id": "671b5eab1f899aa6991e529c",
      "datasetId": "66f696930998d514b9ee899c",
      "itemId": "6710cbb42b0fa56310b7fae1",
      "url": "https://rc-gate.dataloop.ai/api/v1/annotations/671b5eab1f899aa6991e529c",
      "item": "https://rc-gate.dataloop.ai/api/v1/items/6710cbb42b0fa56310b7fae1",
      "dataset": "https://rc-gate.dataloop.ai/api/v1/datasets/66f696930998d514b9ee899c",
      "type": "gis",
      "label": "a",
      "attributes": [],
      "metadata": {
        "system": {
          "status": null,
          "startTime": 0,
          "endTime": 0,
          "frame": 0,
          "endFrame": 1,
          "snapshots_": [],
          "promptId": null,
          "parentId": null,
          "clientId": "1b2f5dea-3db7-435c-bf79-fcf016465e9a",
          "automated": false,
          "objectId": "2",
          "attributes": {},
          "system": false,
          "itemLinks": [],
          "openAnnotationVersion": "1.82.1-rc.12",
          "recipeId": "66f696940bda130037a247c1"
        },
        "user": {}
      },
      "creator": "emailid@domain.com",
      "createdAt": "2024-10-25T09:02:35.049Z",
      "updatedBy": "emailid@domain.com",
      "updatedAt": "2024-10-25T09:02:35.049Z",
      "hash": "e44f16b629aa51a3eac630df38caaf32b6357e18",
      "source": "ui",
      "coordinates": {
        "geo_type": "polyline",
        "wgs84_geo_coordinates": [
          ["N0", "00"],
          ["N0", "00"]
        ]
      }
    },
    {
      "id": "671f74087f5d512beb9f2e9f",
      "datasetId": "66f696930998d514b9ee899c",
      "itemId": "6710cbb42b0fa56310b7fae1",
      "url": "https://rc-gate.dataloop.ai/api/v1/annotations/671f74087f5d512beb9f2e9f",
      "item": "https://rc-gate.dataloop.ai/api/v1/items/6710cbb42b0fa56310b7fae1",
      "dataset": "https://rc-gate.dataloop.ai/api/v1/datasets/66f696930998d514b9ee899c",
      "type": "class",
      "label": "man",
      "attributes": [],
      "metadata": {
        "system": {
          "status": null,
          "startTime": 0,
          "endTime": 0,
          "frame": 0,
          "endFrame": 1,
          "snapshots_": [],
          "promptId": null,
          "parentId": null,
          "clientId": "835c31d1-336d-4f7d-a823-d5ca024ff537",
          "automated": false,
          "objectId": "7",
          "attributes": {},
          "system": false,
          "itemLinks": [],
          "openAnnotationVersion": "1.82.1-rc.14",
          "recipeId": "66f696940bda130037a247c1"
        },
        "user": {}
      },
      "creator": "emailid@domain.com",
      "createdAt": "2024-10-28T11:22:48.239Z",
      "updatedBy": "emailid@domain.com",
      "updatedAt": "2024-10-28T11:22:48.239Z",
      "hash": "605f201b67f69e65b06563b6e43985ccfe42c1e1",
      "source": "ui"
    },
    {
      "id": "671f74087f5d514d3a9f2e9c",
      "datasetId": "66f696930998d514b9ee899c",
      "itemId": "6710cbb42b0fa56310b7fae1",
      "url": "https://rc-gate.dataloop.ai/api/v1/annotations/671f74087f5d514d3a9f2e9c",
      "item": "https://rc-gate.dataloop.ai/api/v1/items/6710cbb42b0fa56310b7fae1",
      "dataset": "https://rc-gate.dataloop.ai/api/v1/datasets/66f696930998d514b9ee899c",
      "type": "gis",
      "label": "a",
      "attributes": [],
      "metadata": {
        "system": {
          "status": null,
          "startTime": 0,
          "endTime": 0,
          "frame": 0,
          "endFrame": 1,
          "snapshots_": [],
          "promptId": null,
          "parentId": null,
          "clientId": "57532386-26c6-4973-a822-b6e1b2c052cf",
          "automated": false,
          "objectId": "4",
          "attributes": {},
          "system": false,
          "itemLinks": [],
          "openAnnotationVersion": "1.82.1-rc.14",
          "recipeId": "66f696940bda130037a247c1"
        },
        "user": {}
      },
      "creator": "emailid@domain.com",
      "createdAt": "2024-10-28T11:22:48.239Z",
      "updatedBy": "emailid@domain.com",
      "updatedAt": "2024-10-28T11:22:48.239Z",
      "hash": "908b54d549e6caf3c89 56c500063430ece3b833a",
      "source": "ui",
      "coordinates": {
        "geo_type": "polygon",
        "wgs84_geo_coordinates": [
          [
            [-117.1583154259652, 32.681641928697644],
            [-117.16166720313508, 32.68021050006596],
            [-117.1628413556346, 32.6771172113695],
            [-117.15843813221882, 32.67619340733788],
            [-117.1555912951791, 32.67854664829772]
          ]
        ]
      }
    },
    {
      "id": "671f74087f5d515e309f2e9b",
      "datasetId": "66f696930998d514b9ee899c",
      "itemId": "6710cbb42b0fa56310b7fae1",
      "url": "https://rc-gate.dataloop.ai/api/v1/annotations/671f74087f5d515e309f2e9b",
      "item": "https://rc-gate.dataloop.ai/api/v1/items/6710cbb42b0fa56310b7fae1",
      "dataset": "https://rc-gate.dataloop.ai/api/v1/datasets/66f696930998d514b9ee899c",
      "type": "gis",
      "label": "a",
      "attributes": [],
      "metadata": {
        "system": {
          "status": null,
          "startTime": 0,
          "endTime": 0,
          "frame": 0,
          "endFrame": 1,
          "snapshots_": [],
          "promptId": null,
          "parentId": null,
          "clientId": "0e486e5a-d634-4e45-8b69-9210cc322e3c",
          "automated": false,
          "objectId": "3",
          "attributes": {},
          "system": false,
          "itemLinks": [],
          "openAnnotationVersion": "1.82.1-rc.14",
          "recipeId": "66f696940bda130037a247c1"
        },
        "user": {}
      },
      "creator": "emailid@domain.com",
      "createdAt": "2024-10-28T11:22:48.239Z",
      "updatedBy": "emailid@domain.com",
      "updatedAt": "2024-10-28T11:22:48.239Z",
      "hash": "f4c063786bd53b582a56e2e029bb815dab4169c7",
      "source": "ui",
      "coordinates": {
        "geo_type": "box",
        "wgs84_geo_coordinates": [
          [
            [-117.16522551129627, 32.679954349679235],
            [-117.16929932427566, 32.679954349679235],
            [-117.16929932427566, 32.682418606459144],
            [-117.16522551129627, 32.682418606459144],
            [-117.16522551129627, 32.679954349679235]
          ]
        ]
      }
    },
    {
      "id": "671f74087f5d5160439f2e9d",
      "datasetId": "66f696930998d514b9ee899c",
      "itemId": "6710cbb42b0fa56310b7fae1",
      "url": "https://rc-gate.dataloop.ai/api/v1/annotations/671f74087f5d5160439f2e9d",
      "item": "https://rc-gate.dataloop.ai/api/v1/items/6710cbb42b0fa56310b7fae1",
      "dataset": "https://rc-gate.dataloop.ai/api/v1/datasets/66f696930998d514b9ee899c",
      "type": "gis",
      "label": "a",
      "attributes": [],
      "metadata": {
        "system": {
          "status": null,
          "startTime": 0,
          "endTime": 0,
          "frame": 0,
          "endFrame": 1,
          "snapshots_": [],
          "promptId": null,
          "parentId": null,
          "clientId": "0cb425ba-653e-4122-8811-cec17b0bc532",
          "automated": false,
          "objectId": "5",
          "attributes": {},
          "system": false,
          "itemLinks": [],
          "openAnnotationVersion": "1.82.1-rc.14",
          "recipeId": "66f696940bda130037a247c1"
        },
        "user": {}
      },
      "creator": "emailid@domain.com",
      "createdAt": "2024-10-28T11:22:48.239Z",
      "updatedBy": "emailid@domain.com",
      "updatedAt": "2024-10-28T11:22:48.239Z",
      "hash": "8879eaffd73b658a786c6cced603427275cce0a6",
      "source": "ui",
      "coordinates": {
        "geo_type": "polyline",
        "wgs84_geo_coordinates": [
          [-117.17112892041186, 32.67686651651841],
          [-117.16383911248248, 32.674734008261666]
        ]
      }
    },
    {
      "id": "671f74087f5d51fc2b9f2e9e",
      "datasetId": "66f696930998d514b9ee899c",
      "itemId": "6710cbb42b0fa56310b7fae1",
      "url": "https://rc-gate.dataloop.ai/api/v1/annotations/671f74087f5d51fc2b9f2e9e",
      "item": "https://rc-gate.dataloop.ai/api/v1/items/6710cbb42b0fa56310b7fae1",
      "dataset": "https://rc-gate.dataloop.ai/api/v1/datasets/66f696930998d514b9ee899c",
      "type": "gis",
      "label": "a",
      "attributes": [],
      "metadata": {
        "system": {
          "status": null,
          "startTime": 0,
          "endTime": 0,
          "frame": 0,
          "endFrame": 1,
          "snapshots_": [],
          "promptId": null,
          "parentId": null,
          "clientId": "26eafd70-f5fd-46bc-910c-f2e5ef0df827",
          "automated": false,
          "objectId": "6",
          "attributes": {},
          "system": false,
          "itemLinks": [],
          "openAnnotationVersion": "1.82.1-rc.14",
          "recipeId": "66f696940bda130037a247c1"
        },
        "user": {}
      },
      "creator": "emailid@domain.com",
      "createdAt": "2024-10-28T11:22:48.239Z",
      "updatedBy": "emailid@domain.com",
      "updatedAt": "2024-10-28T11:22:48.239Z",
      "hash": "b795d308c23fda7370c1de1156f0b1b91ecd4054",
      "source": "ui",
      "coordinates": {
        "geo_type": "point",
        "wgs84_geo_coordinates": [-117.16739742064368, 32.677908090842784]
      }
    }
  ],
  "_id": "6710cbb42b0fa56310b7fae1",
  "filename": "/Parquet/parquet_xyz (1).json",
  "metadata": {
    "system": {
      "encoding": "7bit",
      "isBinary": false,
      "mimetype": "application/json",
      "originalname": "parquet_xyz (1).json",
      "refs": [],
      "shebang": { "dltype": "gis" },
      "size": 631,
      "taskStatusLog": []
    }
  }
}


GIS JSON Fields Description

Key Name

Definition

Parent Key

annotations

List of annotations

N/A

id

Annotations ID

annotations

datasetId

Dataset ID

annotations

itemId

Item ID

annotations

url

API URL for annotation

annotations

item

API URL for the item

annotations

dataset

API URL for the dataset

annotations

type

Annotation type

annotations

label

The annotations label

annotations

attributes

  • Annotation 1.0 format – list of annotation attributes

  • Annotation 2.0 format – dictionary of annotation attributes

annotations

metadata

This key holds all the annotation information

annotations

system

This key holds all the annotation system information

metadata

status

QA status for annotation

system

startTime

The start time of the annotation in video items

system

endTime

The end time of the annotation in video items

system

frame

The first frame of the annotation in video items

system

endFrame

The end frame of the annotation in video items

system

snapshots_

Snapshot information Relevant for video annotation

system

promptId

The ID of prompt annotation

system

parentId

The ID of parent annotation

system

clientId

The ID of parent annotation

system

automated

If the frame is automated

system

objectId

The annotation Object ID

system

attributes

Snapshots attributes

system

system

True - the system created this specific annotation, False - annotation was created on a different way

system

itemLinks

ItemLinks are the connection between ‘snapshot’ annotation (like snapping a frame from a video) to the newly created image item

system

openAnnotationVersion

product version

system

recipeId

Id of the recipe

system

user

User metadata that can be added by user via SDK

annotations

creator

Annotation creator

annotations

createdAt

Annotation creation date and time

annotations

updatedBy

Annotation edits by username

annotations

updatedAt

Annotation edits date and time

annotations

hash

Used to map the items data to a string of arbitrary size

annotations

source

Where the annotation was created: UI/SDK

annotations

coordinates

Spatial coordinates for the annotation. This will vary based on the geometry type

annotations

geo_type

Type of annotation geometry, such as polygon, point, line, or bounding box

coordinates

wgs84_geo_coordinates

Annotation coordinates on the map

coordinates

_id

Item ID

annotations

filename

Name of the file

annotations

metadata

This key holds all the annotation information

annotations

system

Shows system metadata information.

metadata

encoding

Click https://en.wikipedia.org/wiki/Character_encoding to learn about encoding.

metadata

isBinary

Is the item a binary file?

metadata

mimetype

The mime type of the file

metadata

originalname

The filename of the JSON

metadata

refs

The references of the task

metadata

shebang

It allows the UI to present the annotation as GIS instead of a JSON type.

metadata

size

Size of the file

metadata

taskStatusLog

Logs from the task

metadata