공지사항: 
2025년 4월 15일 전에 Earth Engine 사용을 위해 등록된 모든 비상업용 프로젝트는 액세스 권한을 유지하기 위해 
비상업용 자격 요건을 인증해야 합니다. 2025년 9월 26일까지 인증하지 않으면 액세스가 보류될 수 있습니다.
  
        
 
       
     
  
  
  
    
  
  
  
    
      Map.addLayer
    
    
      
    
    
      
      컬렉션을 사용해 정리하기
    
    
      
      내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
    
  
  
      
    
  
  
  
  
  
    
  
  
    
    
    
  
  
지정된 EE 객체를 지도에 레이어로 추가합니다.
새 지도 레이어를 반환합니다.
| 사용 | 반환 값 | 
|---|
| Map.addLayer(eeObject, visParams, name, shown, opacity) | ui.Map.Layer | 
| 인수 | 유형 | 세부정보 | 
|---|
| eeObject | Collection|Feature|Image|RawMapId | 지도에 추가할 객체입니다. | 
| visParams | FeatureVisualizationParameters|ImageVisualizationParameters(선택사항) | 시각화 매개변수입니다. 이미지 및 ImageCollection의 경우 유효한 매개변수는 ee.data.getMapId를 참고하세요. Features 및 FeatureCollections의 경우 지원되는 키는 CSS 3.0 색상 문자열 또는 'RRGGBB' 형식의 16진수 문자열인 'color'뿐입니다. eeObject가 지도 ID인 경우 무시됩니다. | 
| name | 문자열, 선택사항 | 레이어의 이름입니다. 기본값은 'Layer N'입니다. | 
| shown | 불리언, 선택사항 | 레이어가 기본적으로 사용 설정되어야 하는지 여부를 나타내는 플래그입니다. | 
| opacity | 숫자, 선택사항 | 레이어의 불투명도를 0~1 사이의 숫자로 나타냅니다. 기본값은 1입니다. | 
  
  
  예
  
    
  
  
    
    
  
  
  
  
    
    
    
      코드 편집기 (JavaScript)
    
    
  // A Sentinel-2 surface reflectance image.
var image = ee.Image('COPERNICUS/S2_SR/20210109T185751_20210109T185931_T10SEG');
Map.setCenter(-121.87, 37.44, 9);
// Set multi-band RGB image visualization parameters. If the "bands" parameter
// is not defined, the first three bands are used.
var rgbVis = {
  bands: ['B11', 'B8', 'B3'],
  min: 0,
  max: 3000
};
Map.addLayer(image, rgbVis, 'Multi-band RGB image');
// Set band-specific "min" and "max" properties.
var rgbVisBandSpec = {
  bands: ['B11', 'B8', 'B3'],
  min: [0, 75, 150],
  max: [3500, 3000, 2500]
};
Map.addLayer(image, rgbVisBandSpec, 'Band-specific min/max');
// If you don't specify "min" and "max" properties, they will be determined
// from the data type range, often resulting in an ineffective color stretch.
Map.addLayer(image.select('B8'), null, 'Default visParams');
// If an image layer has already been styled, set "visParams" as null.
var imageRgb = image.visualize(rgbVis);
Map.addLayer(imageRgb, null, 'Pre-styled image');
// Use the "palette" parameter with single-band image inputs to define the
// linear color gradient to stretch between the "min" and "max" values.
var singleBandVis = {
  min: 0,
  max: 3000,
  palette: ['blue', 'yellow', 'green']
};
Map.addLayer(image.select('B8'), singleBandVis, 'Single-band palette');
// Images within ImageCollections are automatically mosaicked according to mask
// status and image order. The last image in the collection takes priority,
// invalid pixels are filled by valid pixels in preceding images.
var imageCol = ee.ImageCollection('COPERNICUS/S2_SR')
                   .filterDate('2021-03-01', '2021-04-01');
Map.addLayer(imageCol, rgbVis, 'ImageCollection mosaic');
// FeatureCollection, Feature, and Geometry objects can be styled using the
// "color" parameter.
var featureCol = ee.FeatureCollection('WCMC/WDPA/current/polygons');
Map.addLayer(featureCol, {color: 'purple'}, 'FeatureCollection');
  
    
  
  
    
  
  
  
  
  
  
  
 
  
    
    
      
       
    
    
  
  
  달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
  최종 업데이트: 2025-07-26(UTC)
  
  
  
    
      [null,null,["최종 업데이트: 2025-07-26(UTC)"],[],["The `Map.addLayer` function adds an Earth Engine object to a map as a layer, returning the new `ui.Map.Layer`. It accepts an `eeObject` (Collection, Feature, Image, or RawMapId), optional `visParams` for visualization, `name` for the layer's label, `shown` (boolean) to set default visibility, and `opacity` (0-1). Visualization parameters vary by object type; `color` is the only supported parameter for Features, while Images support `bands`, `min`, `max`, and `palette`. ImageCollections are mosaicked, and the last images take precedence.\n"]]