- URL:
- https://<imageservice-url>/add
- Methods:
POST
- Required Capability:
- Edit
- Version Introduced:
- 10.1
Description
This operation is supported at 10.1 and later.
The Add
operation is performed on an image service resource.
The Add
operation adds new rasters to an image service (POST only).
The added rasters can be either uploaded items, using the item
parameter, or published services, using the service
parameter.
If item
is specified, uploaded rasters are copied to the image service's dynamic image workspace location; if the service
is specified, the image service adds the URL to the mosaic dataset—no raster files are copied. The service
is required input for the following raster types: Image Service, Map Service, WCS, and WMS.
You can provide arguments to the add
operation as query parameters defined in the following parameters table.
Request parameters
Parameter | Details |
---|---|
|
The response format. The default response format is Values: |
| Description: The upload items (raster files) to be added. Either Syntax: Example: |
| Description: The URL of the service to be added. The image service will add this URL to the mosaic dataset. Either Example: |
| Required Description: The type of raster files being added. Raster types define the metadata and processing template for raster files to be added. Allowed values are listed in image service resource. Example: |
| Description: If Values: |
| Description: If Values: |
| Description: If Values: |
| Description: The factor (times raster resolution) used to populate the MinPS field (maximum cell size above which the raster is visible). Syntax: Example: |
| Description: The factor (times raster resolution) used to populate MaxPS field (maximum cell size below which raster is visible). Syntax: Example: |
| Description: Any attribute for the added rasters. Syntax:
Example:
|
| Description: The geodata transformations applied on the added rasters. A geodata transformation is a mathematical model that performs a geometric transformation on a raster; it defines how the pixels will be transformed when displayed or accessed. Polynomial, projective, identity, and other transformations are available. The geodata transformations are applied to the dataset that is added. Syntax:
The syntax of the |
| Description: This parameter defines how to apply the provided geodataTransform. The default is Values: |
Example usage
Add two jpeg2000 images to an image service through https
, post content:
item
Add one JPEG image with polynomial transformation to an image service through https
, post request content:
item
JSON Response syntax
{
"addResults" : [
{
"rasterId" : <rasterId1>,
"success" : <true | false>,
"error" : { //only if success is false
"code" : <code1>,
"description" : "",
}
},
{
"rasterId" : <rasterId2>,
"success" : <true | false>,
"error" : { //only if success is false
"code" : <code1>,
"description" : "",
}
}
]
}
JSON Response example
{"addResults": [
{
"rasterId": 13,
"success": true
},
{
"rasterId": 14,
"success": true
}
]}