Method: projects.image.import

이미지를 가져옵니다.

HTTP 요청

POST https://earthengine.googleapis.com/v1/{project=projects/*}/image:import

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

경로 매개변수

매개변수
project

string

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

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

  • earthengine.imports.create

요청 본문

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

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

object (ImageManifest)

이미지 매니페스트
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를 참고하세요.

ImageManifest

EarthEngine 서비스가 파일 집합에서 이미지를 구성하는 방법을 설명합니다.

JSON 표현 
{
  "name": string,
  "properties": {
    object
  },
  "uriPrefix": string,
  "tilesets": [
    {
      object (Tileset)
    }
  ],
  "bands": [
    {
      object (TilesetBand)
    }
  ],
  "maskBands": [
    {
      object (TilesetMaskBand)
    }
  ],
  "footprint": {
    object (PixelFootprint)
  },
  "missingData": {
    object (MissingData)
  },
  "pyramidingPolicy": enum (PyramidingPolicy),
  "startTime": string,
  "endTime": string,
  "skipMetadataRead": boolean,
  "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' 속성 이름은 지원 중단되었습니다. 대신 startTime 및 endTime 필드를 사용하세요.
uriPrefix

string

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

object (Tileset)

tilesets 각 tileset에는 고유한 ID가 있어야 합니다.
bands[]

object (TilesetBand)

밴드 저작물의 밴드 순서는 bands의 순서와 동일합니다.
maskBands[]

object (TilesetMaskBand)

마스크 밴드
footprint

object (PixelFootprint)

픽셀 좌표 (위도/경도 좌표가 아님)의 풋프린트입니다. 비어 있으면 풋프린트는 기본적으로 전체 이미지입니다. 픽셀 좌표에 관한 자세한 내용은 PixelGrid를 참고하세요.
missingData

object (MissingData)

이미지의 모든 밴드에 데이터가 없음을 나타내는 값입니다. 자체 missingData를 지정하지 않는 모든 밴드에 적용됩니다.
pyramidingPolicy

enum (PyramidingPolicy)

피라미드식 구조 정책 지정하지 않으면 기본적으로 MEAN 정책이 적용됩니다. 자체 pyramidingPolicy를 지정하지 않는 모든 밴드에 적용됩니다.
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"입니다.
skipMetadataRead

boolean

GDAL을 사용하여 파일에서 메타데이터 읽기를 건너뛰는지 여부입니다. 이 필드가 true이면 tileset에 데이터 유형, crs, 변환, 파일 크기, 데이터 값 없음 등 완전한 GDAL 메타데이터가 포함되어야 합니다.
memo

string

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

TilesetBand

tileset에서 가져온 단일 밴드를 나타냅니다.

JSON 표현 
{
  "id": string,
  "tilesetId": string,
  "tilesetBandIndex": integer,
  "missingData": {
    object (MissingData)
  },
  "pyramidingPolicy": enum (PyramidingPolicy)
}
필드
id

string

밴드의 ID입니다.
tilesetId

string

밴드에 해당하는 tileset의 ID입니다.
tilesetBandIndex

integer

밴드에 해당하는 tileset의 0부터 시작하는 밴드 색인입니다. 예를 들어 1이면 밴드의 픽셀은 ImageManifest.tilesets의 tileset 색상 지형지물 자료의 색인 1에 있는 밴드의 픽셀 (ID tilesetId)입니다.
missingData

object (MissingData)

밴드에 데이터가 없음을 나타내는 값입니다. MissingData가 values 없이 설정된 경우 이 TilesetBand에 해당하는 파일에 있는 nodata 값은 무시됩니다.
pyramidingPolicy

enum (PyramidingPolicy)

피라미드식 구조 정책

TilesetMaskBand

tileset에서 가져온 단일 마스크 밴드를 나타냅니다.

JSON 표현 
{
  "tilesetId": string,
  "bandIds": [
    string
  ]
}
필드
tilesetId

string

마스크 밴드에 해당하는 티저 세트의 ID입니다. 카드 세트의 마지막 밴드는 항상 마스크 밴드로 사용됩니다.
bandIds[]

string

마스크 밴드가 적용되는 밴드의 ID입니다. 비어 있으면 마스크 밴드가 저작물의 모든 밴드에 적용됩니다. 각 밴드에는 해당하는 마스크 밴드가 하나만 있을 수 있습니다. 이러한 대역 중 하나에 내부 마스크가 있는 경우 내부 마스크는 무시되고 이 마스크 대역이 사용됩니다.

PixelFootprint

이미지의 모든 유효한 픽셀의 풋프린트입니다.

JSON 표현 
{
  "points": [
    {
      object (GridPoint)
    }
  ],
  "bandId": string
}
필드
points[]

object (GridPoint)

이미지의 모든 유효한 픽셀의 중심을 포함해야 하는 단순 다각형의 외부를 형성하는 원입니다. 선형 링이어야 합니다. 즉, 마지막 지점은 첫 번째 지점과 같아야 합니다. 좌표는 bandId로 지정된 밴드의 투영에 있습니다.

참고: 픽셀 (1x1 직사각형)이 풋프린트를 교차하는 경우에만 풋프린트에 픽셀이 포함되는 것으로 간주되므로 각 픽셀의 중심과 같은 비정수 좌표를 사용하세요. 실수로 인접한 픽셀을 선택하지 않으려면 정수 값 좌표를 사용하지 마세요. 정수 값 좌표는 픽셀 간의 경계이기 때문입니다. 픽셀 중심을 따라 풋프린트를 그리면 의도하지 않은 픽셀이 포함되지 않아 의도한 픽셀이 반메리디언이나 극점과 같은 지도 경계에 접촉할 때 오류가 발생할 수 있습니다.

예를 들어 유효한 픽셀이 모두 4개인 2x2 이미지의 경우 다음과 같은 링이 있을 수 있습니다. [{"x": 0.5, "y": 0.5}, {"x": 0.5, "y": 1.5}, {"x": 1.5, "y": 1.5}, {"x": 1.5, "y": 0.5}, {"x": 0.5, "y": 0.5}]
bandId

string

CRS가 풋프린트의 좌표를 정의하는 밴드의 ID입니다. 비어 있으면 첫 번째 밴드가 사용됩니다.

GridPoint

2차원 점 또는 벡터입니다.

JSON 표현 
{
  "x": number,
  "y": number
}
필드
x

number

x 좌표 값입니다.
y

number

y 좌표 값입니다.