Settings reference

Configure the extension through VS Code Settings using the earthengine.* keys below.

Tasks

Setting	Default	Range	Description
earthengine.tasks.maxItems	100	10–1000	Maximum tasks displayed by sidebar and panel tree views.
earthengine.tasks.scanLimit	1000	100–5000	Maximum operations fetched while loading or refreshing tasks.
earthengine.tasks.historyDays	30	1 or more	Number of days of task history to load.

Map basemaps

Basemaps come from the Google Map Tiles API. You must supply your own API key — run Earth Engine: Set Google Maps API Key from the Command Palette. Without a key the map falls back to free tiles: OpenStreetMap for the default and plan views, Esri World Imagery for satellite. The styled light and dark variants are only available with a key.

Setting up the API key

1. In the Google Cloud Console, enable the Map Tiles API on a project with billing enabled.
2. Create a dedicated API key for it. Do not reuse the key of your Earth Engine project.
3. Under API restrictions, restrict the key to the Map Tiles API and nothing else.
4. Set a daily quota cap on the Map Tiles API and configure a budget alert on the project.
5. Run Earth Engine: Set Google Maps API Key and paste the key. It is stored in the VS Code secret store, never in your settings file.

Application restrictions do not apply

VS Code WebViews run under the vscode-webview:// origin and send no Referer header, so HTTP-referrer restrictions cannot be used. The key also appears in the tile URLs the map panel requests. The quota cap and the API restriction are what protect you — treat the key as disposable and rotate it if needed.

Basemap slots

The map has five basemap slots. Two toggles — plan and satellite — plus the VS Code colour theme decide which one is displayed.

Setting	Slot	When it is used
earthengine.map.basemap.light	Light	Default view, light colour theme.
earthengine.map.basemap.dark	Dark	Default view, dark colour theme.
earthengine.map.basemap.planLight	Light plan	Plan toggle active, light colour theme.
earthengine.map.basemap.planDark	Dark plan	Plan toggle active, dark colour theme.
earthengine.map.basemap.satellite	Satellite	Satellite toggle active.

For examples of customizing each default and plan slot, see Customizing map basemaps.

Each setting defaults to {}, meaning the built-in preset is used. Set it to a createSession request body to override the preset. Supported fields: mapType, styles, layerTypes, overlay, scale, highDpi and imageFormat.

"earthengine.map.basemap.planLight": {
  "mapType": "terrain",
  "layerTypes": ["layerRoadmap"]
}

styles is roadmap-only

The Map Tiles API rejects styles on any map type other than roadmap, so the extension strips it when you pick satellite or terrain. Style rules use the same JSON format as the Google Maps styling reference.

Designing a custom style

Use the Styling Wizard to build a palette visually, then export it with Finish → JSON. Paste the resulting array as the styles field of the slot you want to change:

"earthengine.map.basemap.dark": {
  "mapType": "roadmap",
  "styles": [
    { "elementType": "geometry", "stylers": [{ "color": "#212121" }] }
  ]
}

Changing any of these settings refreshes an open map panel immediately.