테이블 데이터 가져오기

테이블 애셋 업로드

애셋 관리자 또는 명령줄 인터페이스 (CLI)를 사용하여 Shapefile 또는 CSV 형식의 데이터 세트를 업로드할 수 있습니다. 코드 편집기 또는 CLI를 사용하여 래스터를 가져오는 방법에 관한 자세한 내용은 래스터 데이터 가져오기를 참고하세요. 업로드한 저작물은 처음에는 비공개이지만 저작물 공유 섹션에 설명된 대로 공유할 수 있습니다.

Shapefile 업로드

Code Editor에서 Shapefile을 업로드하려면 버튼을 클릭한 다음 표 업로드 섹션에서 Shapefile을 선택합니다. 그림 1과 유사한 업로드 대화상자가 표시됩니다. 선택 버튼을 클릭하고 로컬 파일 시스템에서 Shapefile 또는 Shapefile이 포함된 Zip 파일로 이동합니다. .shp 파일을 선택할 때 관련 .dbf, .shx, .prj 파일도 선택해야 합니다. .prj 파일이 제공되지 않으면 Earth Engine은 기본적으로 WGS84 (경도, 위도) 좌표를 사용합니다. Zip 파일을 업로드하는 경우 셰이프파일(.shp, .dbf, .shx, .prj 등의 집합)이 하나만 포함되어 있고 중복된 파일 이름이 없어야 합니다. 파일 이름에 마침표나 점은 추가로 포함되어 있지 않아야 합니다. 파일 이름의 확장자 앞에 마침표 1개가 포함됩니다.

사용자 폴더에서 테이블에 적절한 애셋 ID (아직 존재하지 않음)를 지정합니다. 업로드를 클릭하여 업로드를 시작합니다.

애셋
그림 1. 애셋 관리자 셰이프파일 업로드 대화상자 .shp, .dbf, .shx 파일이 필요합니다. 다른 사이드카 파일은 선택사항입니다. .prj 파일이 제공되지 않으면 WGS84로 가정합니다.

CSV 파일 업로드

Code Editor에서 CSV를 업로드하려면 애셋 탭을 활성화한 다음 버튼을 클릭하고 표 업로드 섹션에서 CSV 파일을 선택합니다. 그림 2와 유사한 업로드 대화상자가 표시됩니다. SELECT 버튼을 클릭하고 로컬 파일 시스템의 .csv 파일로 이동합니다. 테이블에 고유하고 관련성 있는 애셋 ID 이름을 지정합니다. '확인'을 클릭하여 업로드를 시작합니다.

애셋
그림 2. 애셋 관리자 CSV 파일 업로드 대화상자

CSV 파일에는 지형지물마다 행이 하나씩 있고 지형지물 세트의 속성 또는 변수가 있는 만큼 열이 있어야 합니다. 지형지물이 지리적 위치인 경우 도형 문자열 (GeoJSON, WKT) 또는 x 및 y 위치 속성으로 정의된 위치 정보가 있어야 합니다. CSV 파일이 GDAL/OGR과 같은 GIS 또는 지리 공간 데이터 도구에서 내보낸 파일인 경우 올바른 형식과 이름이 지정된 도형 열이 이미 있어야 합니다. 또는 점 위치를 나타내는 x 및 y 좌표의 두 열을 스프레드시트 애플리케이션에 정의하고 다른 변수와 함께 CSV 형식으로 내보낼 수 있습니다.

고급 옵션

업로드 대화상자의 고급 옵션 섹션에서 기본 설정을 확인하고 변경합니다. 정점이 많은 도형을 분할하면 Earth Engine의 성능을 개선할 수 있습니다. Earth Engine은 정점이 100만 개를 초과하는 지형지물을 허용하지 않습니다. 테이블 업로드 중에 Earth Engine은 정점이 100만 개를 초과하는 도형을 자동으로 분할합니다. 값을 낮게 지정하여 벡터 렌더링 성능을 개선할 수 있습니다.

Earth Engine은 기본 도형 열을 감지하려고 시도하며 달리 지정하지 않는 한 데이터 투영이 WGS84라고 가정합니다. 도형의 측지선 상태는 지정된 투영의 기본 에지 해석에 따라 결정됩니다 (예: WGS84는 측지선 도형을 사용함). 하지만 고급 설정 메뉴에서 재정의할 수 있습니다. 데이터의 도형이 x 및 y 열로 정의된 점인 경우 각 열의 이름을 '경도' 및 '위도'로 지정하거나 고급 설정에서 x 및 y 열 이름을 지정해야 합니다.

업로드 진행률 추적

테이블 업로드를 시작하면 Code Editor 오른쪽의 Tasks 탭 아래에 있는 Task Manager에 'Asset ingestion' 작업이 추가됩니다. ? 아이콘을 클릭하여 업로드 상태를 확인합니다. 작업 위로 마우스를 가져가면 표시되는 아이콘입니다. 업로드를 취소하려면 작업 옆에 있는 회전 아이콘 을 클릭합니다. 처리가 완료되면 작업 셀이 파란색으로 바뀌고 저작물이 사용자 폴더의 애셋 탭에 아이콘과 함께 표시됩니다.

테이블 업로드 한도

테이블을 업로드할 때 테이블의 최대 지형지물 수는 1억 개입니다. 지형지물의 최대 속성 수는 1,024개입니다. 이러한 제한을 통해 결과 저작물을 효율적으로 쿼리할 수 있습니다. 또한 각 지형지물에는 위의 '고급 옵션' 섹션에 설명된 대로 최대 정점 수가 있습니다.

스크립트에 표 애셋 로드

테이블 애셋에서 스크립트로 FeatureCollection를 만들려면 애셋 관리 페이지에 설명된 대로 가져옵니다.