Method: projects.assets.listImages

이미지 모음 애셋의 이미지를 나열합니다. 이 메서드를 사용하면 호출자가 이미지 모음에 시공간 및 메타데이터 필터를 적용할 수 있습니다.

HTTP 요청

GET https://earthengine.googleapis.com/v1alpha/{parent=projects/*/assets/**}:listImages

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

경로 매개변수

매개변수
parent

string

필수입니다. 표시할 이미지 컬렉션 확장 소재의 이름입니다. parent는 'projects/*/assets/**' 형식입니다(예: "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). 모든 사용자 소유 애셋은 'earthengine-legacy' 프로젝트에 속합니다(예: "projects/earthengine-legacy/assets/users/foo/bar"). 그 밖의 모든 애셋은 'earthengine-public' 프로젝트에 속합니다(예: "projects/earthengine-public/assets/LANDSAT").

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

  • earthengine.assets.get

쿼리 매개변수

매개변수
pageSize

integer

페이지당 최대 결과 수입니다. 서버에서 요청한 것보다 적은 애셋을 반환할 수 있습니다. 지정하지 않으면 페이지 크기 기본값은 EarthEngineAssetView에 따라 달라지며, 제한이 더 많은 뷰의 경우 한도가 더 높습니다.
pageToken

string

서버에서 반환할 결과 페이지를 식별하는 토큰입니다. 일반적으로 이는 assets.listImages 메서드에 대한 이전 호출에서 반환된 ListImagesResponse.next_page_token의 값입니다.
startTime

string (Timestamp format)

이 값이 있는 경우 타임스탬프가 이 값 이상인 결과로 필터링합니다 (양 끝값 포함).

생성된 출력은 항상 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)

이 값이 있으면 타임스탬프가 이 값보다 작은 결과로 필터링됩니다 (제외).

생성된 출력은 항상 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"입니다.
region

string

있는 경우 쿼리 영역을 정의하는 도형으로, GeoJSON 도형 문자열로 지정됩니다 (RFC 7946 참고). 공간 교차는 1미터까지 정확합니다.
filter

string

있는 경우 추가 간단한 속성 필터를 지정합니다.
view

enum (EarthEngineAssetView)

응답에서 반환되어야 하는 Image 리소스 부분을 지정합니다. 설정하지 않으면 기본적으로 모든 속성이 반환됩니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

EarthEngineService.ListImages의 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "images": [
    {
      object (Image)
    }
  ],
  "nextPageToken": string
}
필드
images[]

object (Image)

쿼리와 일치하는 이미지 목록입니다.
nextPageToken

string

결과의 다음 페이지를 검색하는 토큰입니다. 결과의 다음 페이지를 검색하려면 후속 assets.listImages 메서드 호출에서 ListImagesRequest.page_token 필드에 이 값을 전달합니다.

승인 범위

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

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

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

이미지

Earth Engine 이미지에 관한 정보입니다.

JSON 표현 
{
  "name": string,
  "id": string,
  "updateTime": string,
  "title": string,
  "description": string,
  "properties": {
    object
  },
  "startTime": string,
  "endTime": string,
  "geometry": {
    object
  },
  "bands": [
    {
      object (ImageBand)
    }
  ],
  "sizeBytes": string
}
필드
name

string

이미지의 이름입니다(있는 경우). name의 형식은 'projects/*/assets/**'입니다(예: 'projects/earthengine-legacy/assets/users//'). 일반적으로 저장된 이미지에는 이 속성이 있지만 계산된 이미지의 경우 빈 문자열입니다.
id

string

이미지의 ID입니다(있는 경우). 'projects/*/assets/' 접두사가 없는 name와 같습니다 (예: 'users//'). 일반적으로 저장된 이미지에는 이 속성이 있지만 계산된 이미지의 경우 빈 문자열입니다.
updateTime

string (Timestamp format)

이미지의 마지막 수정 시간입니다.

생성된 출력은 항상 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"입니다.
title

string

저작물의 제목입니다.
description

string

저작물에 대한 설명입니다.
properties

object (Struct format)

이미지와 연결된 키/값 속성입니다.
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"입니다.
geometry

object (Struct format)

이미지와 연결된 공간적 풋프린트(있는 경우)를 GeoJSON 도형 객체로 나타냅니다(RFC 7946 참고).
bands[]

object (ImageBand)

이미지의 데이터 밴드에 관한 정보입니다.
sizeBytes

string (int64 format)

리프 애셋(예: 이미지)의 크기(바이트)입니다. 일반적으로 저장된 이미지의 경우 0이 아니어야 하며 계산된 이미지의 경우 0이어야 합니다.