Method: projects.assets.listFeatures

테이블 애셋의 지형지물을 나열합니다. 이 메서드를 사용하면 호출자가 시공간 및 속성 필터를 테이블에 적용할 수 있습니다. 결과는 GeoJSON 지형지물 객체의 목록으로 반환됩니다.

HTTP 요청

GET https://earthengine.googleapis.com/v1beta/{asset=projects/*/assets/**}:listFeatures

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

경로 매개변수

매개변수
asset

string

필수입니다. 표시할 테이블 애셋의 이름입니다. asset는 '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").

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

  • earthengine.assets.get

쿼리 매개변수

매개변수
pageSize

integer

페이지당 최대 결과 수입니다. 서버에서 요청한 것보다 적은 애셋을 반환할 수 있습니다. 지정하지 않으면 페이지 크기 기본값은 페이지당 결과 1, 000개입니다.
pageToken

string

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

string

있는 경우 쿼리 영역을 정의하는 도형으로, GeoJSON 도형 문자열로 지정됩니다 (RFC 7946 참고).
filter

string

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

요청 본문

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

응답 본문

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

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

JSON 표현 
{
  "type": string,
  "features": [
    {
      object (Feature)
    }
  ],
  "nextPageToken": string
}
필드
type

string

항상 상수 문자열 'FeatureCollection'을 포함하여 이를 GeoJSON FeatureCollection 객체로 표시합니다.
features[]

object (Feature)

쿼리와 일치하는 지형지물 목록입니다. 'type'이라는 필드에 'Feature' 문자열, 'geometry'라는 필드에 도형, 'properties'라는 필드에 키/값 속성이 포함된 GeoJSON 지형지물 객체 목록 (RFC 7946 참고)입니다.
nextPageToken

string

결과의 다음 페이지를 검색하는 토큰입니다. 결과의 다음 페이지를 검색하려면 후속 assets.listFeatures 메서드 호출에서 ListFeaturesRequest.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를 참고하세요.