/export: Export Item

URL:
https://[root]/content/users/[userName]/export
Methods:
POST

Example Usage

URL for Export Item

Use dark colors for code blocksCopy
1
2
3
4
5
https://www.arcgis.com/sharing/rest/content/users/jsmith/export
itemId=345313e619df46f387f9ededbe15ac56
title:"MyExportedFeatures"
exportFormat="Shapefile"
exportParameters={"layers": [ {"id" : 0 } ] }

Description

Exports a service item (POST only) to the specified output format. Available only to users with an organizational subscription. Invokable only by the service item owner or an administrator.

Request Parameters

ParameterDetails

[Common Parameters]

For a complete listing, see Common parameters.

itemId

The ID of the item to be exported.

Example: itemId=345313e619df46f387f9ededbe15ac56

exportFormat

The output format for the export.

Values: Shapefile | CSV | File Geodatabase | Feature Collection | GeoJson | Scene Package | KML | Excel

Example: exportFormat=Shapefile

exportParameters

A JSON object describing the layers to be exported and the export parameters for each layer.

Example: exportParameters= {"layers" : [ { "id" : 0 } ] }

Export Parameters JSON Object

The exportParameters JSON object is described below.

PropertyDescription

layers

(Required) An array of exportLayerInfo JSON objects that controls which layers are exported. Described in the table below.

targetSR

The target spatial reference for the exported features.

Export Layer Info JSON Object

The exportLayerInfo JSON object is described below.

PropertyDescription

id

(Required) The ID of the layer within the service to be exported.

where

A where clause used to filter features for the layer.

includeGeometry

Controls if feature geometries are included in the export results. The default is 'true'.

xColumnName

Only applies to CSV exportFormat. The name of the field in the CSV file that will contain the x coordinate of exported point geometries. The default value is 'x'.

yColumnName

Only applies to CSV exportFormat. The name of the field in the CSV file that will contain the y coordinate of exported point geometries. The default value is 'y'.

A sample exportParameters JSON object is as follows:

Use dark colors for code blocksCopy
1
2
3
4
5
{
   "layers" :[ {"id" : 0 },
               {"id" : 1, "where" : "POP1999 > 100000"}
             ]
}

Response Properties

The response object is described below.

PropertyDetails

type

The type of the resulting item.

size

The size of the resulting item.

jobId

The job ID of the export job.

exportItemId

The ID of the result item of the export.

serviceItemId

The ID of the service item that was exported.

exportFormat

The format of the export.

JSON Response Syntax

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
{
    "type":<type of the exported  item>,
    "size":<size of the exported item>,
    "jobId":<jobId for the export job>
    "exportItemId":<id of the exported item that is created>,
    "serviceItemId": <id  of the hosted feature service item that was exported>,
    "exportFormat": <exportFormat>
}

JSON Response Example

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
{
    "type" : "Shapefile",
    "size" : 656325,
    "jobId" : "340f0f98-a5d2-48c0-b8ab-a1b418529024",
    "exportItemId" : "4e37b0b8550a40709f02a695cd9fc4fc",
    "serviceItemId":"2e39b0b9550a40709f02a697cd9fc4fb",
    "exportFormat" : "Shapefile"
}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.