Announcement: On November 13, 2024, all users will need to use a Cloud project in order to access Earth Engine. After this date, continued individual access without a Cloud project will require an exception.

Method: projects.map.export

Initiates a batch process that computes a tiled map and writes the result to Google Cloud Storage.

HTTP request

POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/map:export

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters

Parameters
`project`	`string` The project id or project number of the Google Cloud Platform project that should be treated as the service consumer for this request. Format is `projects/{project-id}`. Authorization requires the following IAM permission on the specified resource `project`: `earthengine.exports.create`

project

string

The project id or project number of the Google Cloud Platform project that should be treated as the service consumer for this request. Format is projects/{project-id}.

Authorization requires the following IAM permission on the specified resource project:

earthengine.exports.create

Request body

The request body contains data with the following structure:

JSON representation

JSON representation
{ "expression": { object (`Expression`) }, "description": string, "tileOptions": { object (`TileOptions`) }, "tileExportOptions": { object (`ImageFileExportOptions`) }, "requestId": string, "workloadTag": string, "priority": integer }

{
  "expression": {
    object (Expression)
  },
  "description": string,
  "tileOptions": {
    object (TileOptions)
  },
  "tileExportOptions": {
    object (ImageFileExportOptions)
  },
  "requestId": string,
  "workloadTag": string,
  "priority": integer
}

Fields
`expression`	`object (Expression)` An expression that evaluates to the image to compute and export. The bounds of the image will be used to determine the set of map tiles to render. To control the exported region, clip the image prior to exporting.
`description`	`string` A human-readable name of the task.
`tileOptions`	`object (TileOptions)` Options describing the map tiles to generate.
`tileExportOptions`	`object (ImageFileExportOptions)` Options for where and in what form to export the map tiles. Cloud Storage is currently the only supported destination for map exports.
`requestId`	`string` A unique string used to detect duplicated requests. If more than one request is made by the same user with the same non-empty `requestId`, only one of those requests may successfully start a long-running operation. `requestId` may contain the characters a..z, A..Z, 0-9, or '-'. `requestId` may be at most 60 characters long.
`workloadTag`	`string` User supplied label to track this computation.
`priority`	`integer` Optional. The priority of the export task within the project. Higher priority tasks are scheduled sooner. Must be an integer between 0 and 9999. Defaults to 100 if not set.

Response body

If successful, the response body contains an instance of Operation.

Authorization scopes

Requires one of the following OAuth scopes:

https://www.googleapis.com/auth/earthengine
https://www.googleapis.com/auth/cloud-platform
https://www.googleapis.com/auth/devstorage.full_control

For more information, see the Authentication Overview.

TileOptions

Options describing image or video map tiles to export.

JSON representation

JSON representation
{ "startZoom": integer, "skipEmpty": boolean, "mapsApiKey": string, "dimensions": { object (`GridDimensions`) }, "stride": integer, "zoomSubset": { object (`ZoomSubset`) }, // Union field `end_zoom_or_scale` can be only one of the following: "endZoom": integer, "scale": number // End of list of possible types for union field `end_zoom_or_scale`. }

{
  "startZoom": integer,
  "skipEmpty": boolean,
  "mapsApiKey": string,
  "dimensions": {
    object (GridDimensions)
  },
  "stride": integer,
  "zoomSubset": {
    object (ZoomSubset)
  },

  // Union field end_zoom_or_scale can be only one of the following:
  "endZoom": integer,
  "scale": number
  // End of list of possible types for union field end_zoom_or_scale.
}

Fields
`startZoom`	`integer` The zoom level to start generating map tiles for export. Defaults to zero.
`skipEmpty`	`boolean` If true, skip writing empty (i.e. fully-transparent) map tiles.
`mapsApiKey`	`string` Optional Google Maps Platform API Key for generated map tile viewer.
`dimensions`	`object (GridDimensions)` The width and height of output video tiles, used only for exporting tiled video pyramids (ExportVideoMap).
`stride`	`integer` Tile row and column stride. (ExportVideoMap) Set to 4 for sparse tiles (WebGL-only) or 1 (default) for maximum compatibility.
`zoomSubset`	`object (ZoomSubset)` A subset of zoom levels for which to generate tiles. May only be specified in a call to `ExportVideoMap`.
Union field `end_zoom_or_scale`. The zoom level or scale at which to stop generating map tiles for. One or the other of these must be specified. `end_zoom_or_scale` can be only one of the following:
`endZoom`	`integer` The zoom level to stop generating map tiles for.
`scale`	`number` The max image resolution in meters per pixel. The scale will be converted to the most appropriate maximum zoom level at the equator.

ZoomSubset

A subset of zoom levels for which to generate tiles (ExportVideoMap), Start and end subsets are double precision values, allowing you to render a zoom level or levels incrementally. To render a whole pyramid with a start zoom of 12: startZoom=0, endZoom=12, don't set this message. To render levels 0-11 and the first 10% of level 12: startZoom=0, endZoom=12, subset = {min=0, max=12.1 } To render the next 10% of level 12: startZoom=0, endZoom=12, subset = {min=12.1, max=12.2 } To render the remaining 80% of level 12: startZoom=0, endZoom=12, subset = {min=12.2, max=13 } Also note that all export shards must have the same (full) pyramid size in start/endZoom.

JSON representation
{ "start": number, "end": number }

Fields

Fields
`start`	`number` Starting zoom level subset for which to generate tiles (ExportVideoMap) Here, subset is a double precision value, allowing you to render a zoom level incrementally, so 12.1 for example is the first 10% of the tiles in zoom 12 in some unspecified but deterministic order.
`end`	`number` Ending zoom level subset for which to generate tiles (ExportVideoMap), allowing you to render a zoom level incrementally, up to but not including the maximum subset (if provided) in some unspecified but deterministic order.

start

number

Starting zoom level subset for which to generate tiles (ExportVideoMap) Here, subset is a double precision value, allowing you to render a zoom level incrementally, so 12.1 for example is the first 10% of the tiles in zoom 12 in some unspecified but deterministic order.

end

number

Ending zoom level subset for which to generate tiles (ExportVideoMap), allowing you to render a zoom level incrementally, up to but not including the maximum subset (if provided) in some unspecified but deterministic order.