GIS JSON Format
  • 01 Jan 2025
  • Dark
    Light
  • PDF

GIS JSON Format

  • Dark
    Light
  • PDF

Article summary

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 NameDefinitionParent Key
annotationsList of annotationsN/A
idAnnotations IDannotations
datasetIdDataset IDannotations
itemIdItem IDannotations
urlAPI URL for annotationannotations
itemAPI URL for the itemannotations
datasetAPI URL for the datasetannotations
typeAnnotation typeannotations
labelThe annotations labelannotations
attributes
  • Annotation 1.0 format – list of annotation attributes
  • Annotation 2.0 format – dictionary of annotation attributes
annotations
metadataThis key holds all the annotation informationannotations
systemThis key holds all the annotation system informationmetadata
statusQA status for annotationsystem
startTimeThe start time of the annotation in video itemssystem
endTimeThe end time of the annotation in video itemssystem
frameThe first frame of the annotation in video itemssystem
endFrameThe end frame of the annotation in video itemssystem
snapshots_Snapshot information Relevant for video annotationsystem
promptIdThe ID of prompt annotationsystem
parentIdThe ID of parent annotationsystem
clientIdThe ID of parent annotationsystem
automatedIf the frame is automatedsystem
objectIdThe annotation Object IDsystem
attributesSnapshots attributessystem
systemTrue - the system created this specific annotation, False - annotation was created on a different waysystem
itemLinksItemLinks are the connection between ‘snapshot’ annotation (like snapping a frame from a video) to the newly created image itemsystem
openAnnotationVersionproduct versionsystem
recipeIdId of the recipesystem
userUser metadata that can be added by user via SDKannotations
creatorAnnotation creatorannotations
createdAtAnnotation creation date and timeannotations
updatedByAnnotation edits by usernameannotations
updatedAtAnnotation edits date and timeannotations
hashUsed to map the items data to a string of arbitrary sizeannotations
sourceWhere the annotation was created: UI/SDKannotations
coordinatesSpatial coordinates for the annotation. This will vary based on the geometry typeannotations
geo_typeType of annotation geometry, such as polygon, point, line, or bounding boxcoordinates
wgs84_geo_coordinatesAnnotation coordinates on the mapcoordinates
_idItem IDannotations
filenameName of the fileannotations
metadataThis key holds all the annotation informationannotations
systemShows system metadata information.metadata
encodingClick https://en.wikipedia.org/wiki/Character_encoding to learn about encoding.metadata
isBinaryIs the item a binary file?metadata
mimetypeThe mime type of the filemetadata
originalnameThe filename of the JSONmetadata
refsThe references of the taskmetadata
shebangIt allows the UI to present the annotation as GIS instead of a JSON type.metadata
sizeSize of the filemetadata
taskStatusLogLogs from the taskmetadata