Skip To Content

Upload an imagery project definition file

An advanced option allows you to create an imagery project by uploading an imagery project definition file through a single step. A properly formatted .json file must be provided to successfully create an imagery project.

Upload an imagery project definition file

To upload an imagery project definition file, complete the following steps:

  1. From the Imagery Project List page, click Upload.

    A new view opens to begin the upload process.

  2. Click Browse for an Imagery Project Definition File and browse to the properly formatted .json file.

    You can also drag the file to complete the workflow.

    Click Close to return to the Imagery Project List.

  3. Once the .json file uploads, click Open Imagery Project to open a project, Edit Imagery Project Details to edit your project, or Create Another to upload another file.

The examples below provide sample JSON correctly formatted for a single image layer and observation layers.

Projects with a single focus image layer

All projects have a single focus image layer. However, a subset of images from a service can be displayed if it is supported. Projects with a single focus layer include ArcGIS Image Services with all images displayed or a subset of images displayed, WMS services with all layers displayed or a subset of layers displayed, and WMTS services.

The following services can display a subset of images:

  • ArcGIS Image Service—A subset of rasters that form the mosaic can be displayed.
  • WMS Service—A subset of layers can be displayed.

Services that do not support display of a subset of images:

  • ArcGIS Image Service that cannot form a mosaic, is cached, or is tiled
  • WMTS Service

ArcGIS Image Service with all images displayed JSON

The formatted JSON example of an ArcGIS Image Service with all images displayed includes the following:

  • Project details
  • Project instructions
  • Image service connection information
{
  {
  "title": "A simple imagery project",
  "summary": "A simple project with just a focus image layer",
  "description": "",
  "instructions": "Look for damage",
  "focusImageLayer": {
    "serviceType": "arcgis",
    "serviceUrl": "https://server/service-name/ImageServer",
    "rasterIds": [],
    "layerNames": []
  }
}

ArcGIS Image Service with a subset of images displayed JSON

The formatted JSON example of an ArcGIS Image Service with a subset of images displayed includes the following:

  • Project details
  • Project instructions
  • Image service connection information
    • IDs of the individual images
{
  {
  "title": "A simple imagery project",
  "summary": "A simple project with just a focus image layer",
  "description": "",
  "instructions": "Look for damage",
  "focusImageLayer": {
    "serviceType": "arcgis",
    "serviceUrl": "https://server/service-name/ImageServer",
    "rasterIds": [1, 2, 3],
    "layerNames": []
  }
}

WMS Service with all layers displayed JSON

The formatted JSON example of an WMS Service with all layers displayed includes the following:

  • Project details
  • Project instructions
  • Image service connection information for the WMS Service
{
  "title": "A simple imagery project",
  "summary": "A simple project with a WMS layer",
  "description": "",
  "instructions": "Look for damage",
  "focusImageLayer": {
    "serviceType": "wms",
    "serviceUrl": "https://server/service-name",
    "rasterIds": [],
    "layerNames": []
  }
}

WMS Service with a subset of layers displayed JSON

The formatted JSON example of an WMS Service with a subset of layers displayed includes the following:

  • Project details
  • Project instructions
  • Connection information and the names of the layers
{
  "title": "A simple imagery project",
  "summary": "A simple project with a WMS layer",
  "description": "",
  "instructions": "Look for damage",
  "focusImageLayer": {
    "serviceType": "wms",
    "serviceUrl": "https://server/service-name",
    "rasterIds": []
    "layerNames": ["damage0102", "damage0104"]
  }
}

WMTS Service JSON

The formatted JSON example of an WMTS Service includes the following:

  • Project details
  • Project instructions
  • Connection information for the WMTS Service
Note:

WMTS service layers are cached and only one layer can be displayed as the focus image layer in a project. The layerNames property can only have one layer name.

{
  "title": "A simple imagery project",
  "summary": "A simple project with a WMTS layer",
  "description": "",
  "instructions": "Look for weather",
  "focusImageLayer": {
    "serviceType": "wmts",
    "serviceUrl": "https://server/service-name",
    "rasterIds": []
    "layerNames": ["radar-base-reflectivity"]
  }
}

Projects with observation layers

Projects with observation layers include using single or multiple observation layers.

Single observation layer JSON

The formatted JSON example of single observation layer includes the following:

  • Project details
  • Project instructions
  • Image service connection information
  • Connection information for an editable feature service registered with the portal
{
  "title": "Imagery project with observations",
  "summary": "A project with an observation layer",
  "description": "",
  "instructions": "Add a point on top of anything of interest and enter comments",
  "focusImageLayer": {
    "serviceType": "arcgis",
    "serviceUrl": "https://server/service-name/ImageServer",
    "rasterIds": [1, 2, 3],
    "layerNames": []
  },
  "observationLayers": [
    {
      "itemId": "123456789abcdefg"
    }
  ]
}

Multiple observation layers JSON

The formatted JSON example of multiple observation layers includes the following:

  • Project details
  • Project instructions
  • Image service connection information
  • Connection information for an editable feature service registered with the portal
{
  "title": "Imagery project with observations",
  "summary": "A project with an observation layer",
  "description": "",
  "instructions": "Add a point on top of anything of interest and enter comments",
  "focusImageLayer": {
    "serviceType": "arcgis",
    "serviceUrl": "https://server/service-name/ImageServer",
    "rasterIds": [1, 2, 3],
    "layerNames": []
  },
  "observationLayers": [
    {
      "itemId": "123456789abcdefg"
    },
    {
      "itemId": "hijklmnop9876543",
      "url": "https://server/service-name/FeatureServer/2"
    }
  ],
  "webmapId": "12345678"
}

Observation layer with enrichment definition JSON

The formatted JSON example of multiple observation layers includes the following:

  • Project details
  • Project instructions
  • Image service connection information
  • Connection information for an editable feature service registered with the portal
  • An enrichment definition that describes the source data and target data
{
  "title": "Imagery project with observations getting data from another layer",
  "summary": "A project with an observation layer that gets its 'parcelid' field calculated from the parcel boundary polygon layer's 'id' field",
  "description": "",
  "instructions": "Add a point on top of anything of interest and enter comments",
  "webmapId": "12345678",
  "focusImageLayer": {
    "serviceType": "arcgis",
    "serviceUrl": "https://server/service-name/ImageServer",
    "rasterIds": [
      1,
      2,
      3
    ],
    "layerNames": []
  },
  "observationLayers": [
    {
      "itemId": "ead6deb3d93848c4a7fd58025cc2cdaa",
      "title": "Abandoned Building Locations with Parcel id",
      "url": "https://my.domain.name/arcgis/rest/services/Hosted/abandoned_buildings/FeatureServer",
      "enrichmentDefinition": {
        "title": "Building Parcel Info",
        "layers": [
          {
            "itemId": "fghijklmnop123456xyz",
            "sourceUrl": "https://path/to/parcel/boundaries/FeatureServer/0",
            "fields": [
              {
                "source": "id",
                "destination": "parcelid"
              }
            ]
          }
        ]
      }
    }
  ]
}