Earth Engine is introducing noncommercial quota tiers to safeguard shared compute resources and ensure reliable performance for everyone. All noncommercial projects will need to select a quota tier by April 27, 2026 or will use the Community Tier by default. Tier quotas will take effect for all projects (regardless of tier selection date) on April 27, 2026 . Learn more.

ee.Dictionary.toImage

Page Summary

The toImage() method creates an image of constants from values in a dictionary.
The order and naming of the image bands can be controlled by the names argument.
If no names are specified, the bands are sorted alpha-numerically.

Creates an image of constants from values in a dictionary. The bands of the image are ordered and named according to the names argument. If no names are specified, the bands are sorted alpha-numerically.

Usage	Returns
`Dictionary. toImage ( names )`	Image

Argument	Type	Details
this: `dictionary`	Dictionary	The dictionary to convert.
`names`	List, default: null	The order of the output bands.

Examples

Code Editor (JavaScript)

 // A dictionary (e.g. results of ee.Image.reduceRegion of an S2 image). 
 var 
  
 dict 
  
 = 
  
 ee 
 . 
 Dictionary 
 ({ 
  
 B1 
 : 
  
 182 
 , 
  
 B2 
 : 
  
 219 
 , 
  
 B3 
 : 
  
 443 
 }); 
 var 
  
 selectedKeysImg 
  
 = 
  
 dict 
 . 
 toImage 
 ([ 
 'B1' 
 , 
  
 'B2' 
 ]); 
 print 
 ( 
 'Selected keys image band names' 
 , 
  
 selectedKeysImg 
 . 
 bandNames 
 ()); 
 var 
  
 allKeysImg 
  
 = 
  
 dict 
 . 
 toImage 
 (); 
 print 
 ( 
 'All keys image band names' 
 , 
  
 allKeysImg 
 . 
 bandNames 
 ());

Python setup

See the Python Environment page for information on the Python API and using geemap for interactive development.

 import 
  
 ee 
 import 
  
 geemap.core 
  
 as 
  
 geemap

Colab (Python)

 # A dictionary (e.g. results of ee.Image.reduceRegion of an S2 image). 
 dic 
 = 
 ee 
 . 
 Dictionary 
 ({ 
 'B1' 
 : 
 182 
 , 
 'B2' 
 : 
 219 
 , 
 'B3' 
 : 
 443 
 }) 
 selected_keys_img 
 = 
 dic 
 . 
 toImage 
 ([ 
 'B1' 
 , 
 'B2' 
 ]) 
 display 
 ( 
 'Selected keys image band names:' 
 , 
 selected_keys_img 
 . 
 bandNames 
 ()) 
 all_keys_img 
 = 
 dic 
 . 
 toImage 
 () 
 display 
 ( 
 'All keys image band names:' 
 , 
 all_keys_img 
 . 
 bandNames 
 ())

ee.Dictionary.toImage Stay organized with collections Save and categorize content based on your preferences.

Page Summary

Examples

Code Editor (JavaScript)

Colab (Python)

ee.Dictionary.toImage