Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
GcsDestination
Stay organized with collections
Save and categorize content based on your preferences.
Configuration for a destination in Google Cloud Storage.
| JSON representation |
{
"bucket": string,
"filenamePrefix": string,
"permissions": enum (TilePermissions),
"bucketCorsUris": [
string
]
} |
| Fields |
bucket |
string
The Google Cloud Storage destination bucket.
|
filenamePrefix |
string
The string used as the prefix for each output file. A trailing "/" indicates a path. The filenames of the exported files will be constructed from this prefix, the coordinates of each file in a mosaic (if any), and a file extension corresponding to the file format.
|
permissions |
enum (TilePermissions)
Specifies the permissions to set on the exported tiles. If unspecified, defaults to DEFAULT_OBJECT_ACL.
|
bucketCorsUris[] |
string
Optional list of URIs to whitelist for the CORS settings on the bucket. Used to enable websites to access exported files via JavaScript.
|
TilePermissions
Permissions to set on exported map tiles.
| Enums |
TILE_PERMISSIONS_UNSPECIFIED |
Unspecified. |
PUBLIC |
Write public tiles. Requires the caller to be an OWNER of the bucket. |
DEFAULT_OBJECT_ACL |
Write tiles using the bucket's default object ACL. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-03-06 UTC.
[null,null,["Last updated 2025-03-06 UTC."],[[["\u003cp\u003eDeprecated: This item is no longer in use and should not be utilized for new configurations.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Cloud Storage Destination: This configuration defines where Earth Engine exports will be stored within a Google Cloud Storage bucket.\u003c/p\u003e\n"],["\u003cp\u003eFile Structure: Exported files are organized using a filename prefix, mosaic coordinates (if applicable), and a file extension matching the output format.\u003c/p\u003e\n"],["\u003cp\u003ePermissions and Access: Tile permissions can be set to control access, including public access or using the bucket's default settings, and CORS can be configured for web-based access to the exported files.\u003c/p\u003e\n"]]],[],null,["# GcsDestination\n\n| This item is deprecated!\nConfiguration for a destination in Google Cloud Storage.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"bucket\": string, \"filenamePrefix\": string, \"permissions\": enum (/earth-engine/reference/rest/v1alpha/GcsDestination#TilePermissions), \"bucketCorsUris\": [ string ] } ``` |\n\n| Fields ||\n|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `bucket` | `string` The Google Cloud Storage destination bucket. |\n| `filenamePrefix` | `string` The string used as the prefix for each output file. A trailing \"/\" indicates a path. The filenames of the exported files will be constructed from this prefix, the coordinates of each file in a mosaic (if any), and a file extension corresponding to the file format. |\n| `permissions` | `enum (`[TilePermissions](/earth-engine/reference/rest/v1alpha/GcsDestination#TilePermissions)`)` Specifies the permissions to set on the exported tiles. If unspecified, defaults to DEFAULT_OBJECT_ACL. |\n| `bucketCorsUris[]` | `string` Optional list of URIs to whitelist for the CORS settings on the bucket. Used to enable websites to access exported files via JavaScript. |\n\nTilePermissions\n---------------\n\nPermissions to set on exported map tiles.\n\n| Enums ||\n|--------------------------------|-----------------------------------------------------------------------|\n| `TILE_PERMISSIONS_UNSPECIFIED` | Unspecified. |\n| `PUBLIC` | Write public tiles. Requires the caller to be an OWNER of the bucket. |\n| `DEFAULT_OBJECT_ACL` | Write tiles using the bucket's default object ACL. |"]]