Method: projects.table.import

테이블을 가져옵니다.

HTTP 요청

POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/table:import

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
project

string

이 요청의 서비스 소비자로 간주되어야 하는 Google Cloud Platform 프로젝트의 프로젝트 ID 또는 프로젝트 번호입니다. 형식은 projects/{project-id}입니다.

승인을 처리하려면 지정된 리소스 project에 대해 다음과 같은 IAM 권한이 필요합니다.

  • earthengine.assets.create

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현
{
  "tableManifest": {
    object (TableManifest)
  },
  "description": string,
  "overwrite": boolean,
  "requestId": string
}
필드
tableManifest

object (TableManifest)

테이블 매니페스트입니다.

description

string

사람이 읽을 수 있는 태스크 이름입니다.

overwrite

boolean

기존 저작물 덮어쓰기를 허용할지 여부입니다.

requestId

string

중복 요청을 감지하는 데 사용되는 고유 문자열입니다. 동일한 비어 있지 않은 requestId를 사용하여 동일한 사용자가 두 번 이상 요청하는 경우 이러한 요청 중 하나만 장기 실행 작업을 성공적으로 시작할 수 있습니다. requestId에는 a..z, A..Z, 0~9 또는 '-' 문자가 포함될 수 있습니다. requestId의 길이는 최대 60자(영문 기준)입니다.

응답 본문

성공한 경우 응답 본문에 Operation의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/earthengine
  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 OAuth 2.0 Overview를 참고하세요.

TableManifest

EarthEngine 서비스가 파일 세트에서 테이블을 구성하는 방법을 설명합니다.

JSON 표현
{
  "name": string,
  "properties": {
    object
  },
  "uriPrefix": string,
  "sources": [
    {
      object (TableSource)
    }
  ],
  "startTime": string,
  "endTime": string,
  "csvColumnDataTypeOverrides": {
    string: enum (CsvColumnDataType),
    ...
  },
  "columnDataTypeOverrides": {
    string: enum (ColumnDataType),
    ...
  },
  "memo": string
}
필드
name

string

만들려는 확장 소재의 이름입니다. name의 형식은 'projects/*/assets/**'입니다(예: 'projects/earthengine-legacy/assets/users//'). 모든 사용자 소유 애셋은 'earthengine-legacy' 프로젝트에 속합니다(예: 'projects/earthengine-legacy/assets/users/foo/bar'). 다른 모든 애셋은 'earthengine-public' 프로젝트에 속합니다(예: 'projects/earthengine-public/assets/LANDSAT').

properties

object (Struct format)

저작물의 추가 속성입니다. 'system:time_start' 및 'system:time_end' 속성 이름은 지원 중단되었습니다. 대신 startTimeendTime 필드를 사용하세요.

uriPrefix

string

이 매니페스트에 정의된 모든 uri 앞에 추가되는 선택적 접두사입니다.

sources[]

object (TableSource)

이 표를 구성하는 소스입니다.

startTime

string (Timestamp format)

저작물과 연결된 타임스탬프(있는 경우)입니다(예: 위성 이미지가 촬영된 시간). 한 달 또는 1년 동안의 평균 값과 같이 시간 간격에 해당하는 애셋의 경우 이 타임스탬프는 해당 간격의 시작에 해당합니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 자릿수가 0, 3, 6 또는 9인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

endTime

string (Timestamp format)

한 달 또는 1년 동안의 평균 값과 같이 시간 간격에 해당하는 애셋의 경우 이 타임스탬프는 해당 간격의 끝 (제외)에 해당합니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 자릿수가 0, 3, 6 또는 9인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

csvColumnDataTypeOverrides
(deprecated)

map (key: string, value: enum (CsvColumnDataType))

대신 columnDataTypeOverrides를 사용하세요.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

columnDataTypeOverrides

map (key: string, value: enum (ColumnDataType))

열 이름과 해당 열에 사용할 유형 간의 매핑입니다. 여기에 지정되지 않은 열은 유형이 추론됩니다. 예를 들어 숫자 열은 숫자가 되고 WKT 열은 도형이 됩니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

memo

string

사용자 메모를 저장할 자유 형식 필드입니다. 처리에는 사용되지 않습니다.

TableSource

테이블 파일

JSON 표현
{
  "uris": [
    string
  ],
  "charset": string,
  "maxErrorMeters": number,
  "maxVertices": integer,
  "crs": string,
  "geodesic": boolean,
  "primaryGeometryColumn": string,
  "xColumn": string,
  "yColumn": string,
  "dateFormat": string,
  "csvDelimiter": string,
  "csvQualifier": string
}
필드
uris[]

string

가져올 데이터의 URI입니다. 현재 Google Cloud Storage URI만 지원됩니다. 각 URI는 'gs://bucket-id/object-id' 형식으로 지정해야 합니다. 기본 객체는 목록의 첫 번째 요소여야 하며, 사이드카 파일은 기본 객체의 파일 경로에서 추론됩니다. 현재 하나의 URI만 지원됩니다. URI가 두 개 이상 지정되면 INALID_ARGUMENT 오류가 반환됩니다.

charset

string

문자열 디코딩에 사용할 기본 문자 집합의 이름입니다. 비어 있으면 기본적으로 문자 집합 'utf-8'이 가정됩니다.

maxErrorMeters

number

좌표계 간에 도형을 변환할 때 허용되는 최대 오류(미터)입니다. 비워 두면 기본적으로 최대 오류는 1미터입니다.

maxVertices

integer

최대 정점 수입니다. 0이 아닌 경우 도형이 공간적으로 서로 연결되지 않은 조각으로 각각 이 한도 미만으로 세분화됩니다.

crs

string

지오메트리의 좌표 참조 시스템을 지정하지 않은 경우 이를 지정하는 기본 CRS 코드 또는 WKT 문자열입니다. 비워 두면 기본값은 EPSG:4326: https://epsg.io/4326입니다. CSV/TFRecord 소스에서만 사용할 수 있습니다.

geodesic

boolean

달리 지정되지 않은 도형의 가장자리를 해석하기 위한 기본 전략입니다. false인 경우 투영에서 가장자리가 직선입니다. 이 값이 true이면 지구 표면에서 가장 짧은 경로를 따라 모서리가 굴곡됩니다. 비워 두면 'crs'가 투영된 좌표계인 경우 기본값은 false입니다. CSV/TFRecord 소스에서만 사용할 수 있습니다.

primaryGeometryColumn

string

도형 열이 2개 이상인 경우 행의 기본 도형으로 사용할 도형 열입니다.

비워두고 도형 열이 두 개 이상 있는 경우 처음 발견된 도형 열이 사용됩니다. CSV/TFRecord 소스에서만 사용할 수 있습니다.

xColumn

string

점 도형을 추론하기 위한 숫자 x 좌표 열의 이름입니다. yColumn도 지정되어 있고 두 열에 모두 숫자 값이 포함된 경우 'crs'에 지정된 좌표계의 x,y 값으로 점 도형 열이 구성됩니다. 비워두고 'crs'가 투영된 좌표계를 지정하지 않으면 기본값은 'longitude'입니다. 비워두고 'crs'가 투영 좌표계를 지정하지 않으면 기본값은 ''이고 점 도형이 생성되지 않습니다.

생성된 점 도형 열의 이름은 {xColumn}_{yColumn}_N으로 지정되며, {xColumn}_{yColumn}이라는 열이 이미 있는 경우 {xColumn}_{yColumn}_N이 고유하도록 N이 추가됩니다. CSV/TFRecord 소스에서만 사용할 수 있습니다.

yColumn

string

점 도형을 추론하기 위한 숫자 y 좌표 열의 이름입니다. xColumn도 지정되어 있고 두 열에 모두 숫자 값이 포함된 경우 'crs'에 지정된 좌표계의 x,y 값으로 점 도형 열이 구성됩니다. 비워두고 'crs'가 투영된 좌표계를 지정하지 않으면 기본값은 'latitude'입니다. 비워두고 'crs'가 투영 좌표계를 지정하지 않으면 기본값은 ''이고 점 도형이 생성되지 않습니다.

생성된 점 도형 열의 이름은 {xColumn}_{yColumn}_N으로 지정되며, {xColumn}_{yColumn}이라는 열이 이미 있는 경우 {xColumn}_{yColumn}_N이 고유하도록 N이 추가됩니다. CSV/TFRecord 소스에서만 사용할 수 있습니다.

dateFormat

string

날짜를 인코딩하는 필드를 파싱하는 형식입니다. 형식 패턴은 http://joda-time.sourceforge.net/apidocs/org/joda/time/format/DateTimeFormat.html에 설명된 대로여야 합니다. 비워 두면 날짜가 문자열로 가져옵니다. CSV/TFRecord 소스에서만 사용할 수 있습니다.

csvDelimiter

string

CSV 파일을 처리할 때 행의 열 값 간에 구분자로 사용되는 단일 문자입니다. 공백으로 두면 기본값은 ','입니다. CSV 소스만 해당합니다.

csvQualifier

string

CSV 파일을 처리할 때 열 값을 묶는 문자('따옴표 문자'라고도 함)입니다. 비워두면 기본값은 '"'입니다. CSV 소스만 해당합니다.

열 값이 한정자로 묶이지 않으면 선행 및 후행 공백이 잘립니다. 예: ..., test,... <== 이 값은 한정되지 않으며 문자열 값 'test'가 됩니다. <== 공백이 제거됩니다.

where: ...," test",... <== 이 값은 따옴표로 표시되어 문자열 값이 됩니다. " test" <== 공백은 유지됩니다.