공지사항:
2025년 4월 15일 전에 Earth Engine 사용을 위해 등록된 모든 비상업용 프로젝트는 Earth Engine 액세스를 유지하기 위해
비상업용 자격 요건을 인증해야 합니다.
Method: projects.table.computeFeatures
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
하나 이상의 테이블에 있는 지형지물에 임의의 계산을 적용하여 지형지물 집합을 계산합니다. 결과는 GeoJSON 지형지물 객체의 목록으로 반환됩니다.
HTTP 요청
POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/table:computeFeatures
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 |
project |
string
이 요청의 서비스 소비자로 간주되어야 하는 Google Cloud Platform 프로젝트의 프로젝트 ID 또는 프로젝트 번호입니다. 형식은 projects/{project-id} 입니다.
승인을 처리하려면 지정된 리소스 project 에 대해 다음과 같은 IAM 권한이 필요합니다.
earthengine.computations.create
|
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
{
"expression": {
object (Expression )
},
"pageSize": integer,
"pageToken": string,
"workloadTag": string
} |
필드 |
expression |
object (Expression )
계산할 표현식입니다.
|
pageSize |
integer
페이지당 최대 결과 수입니다. 서버에서 요청한 것보다 적은 지형지물을 반환할 수 있습니다. 지정하지 않으면 페이지 크기 기본값은 페이지당 결과 1, 000개입니다.
|
pageToken |
string
서버에서 반환할 결과 페이지를 식별하는 토큰입니다. 일반적으로 이는 table.computeFeatures 메서드에 대한 이전 호출에서 반환된 ComputeFeaturesResponse.next_page_token 의 값입니다.
|
workloadTag |
string
사용자가 이 계산을 추적하기 위해 제공한 태그입니다.
|
응답 본문
EarthEngineService.ComputeFeatures의 응답 메시지입니다.
성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.
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
결과의 다음 페이지를 검색하는 토큰입니다. 결과의 다음 페이지를 검색하려면 후속 table.computeFeatures 메서드 호출에서 ComputeFeaturesRequest.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를 참고하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eComputes a set of features by applying a computation to features in one or more tables, returning results as a list of GeoJSON feature objects.\u003c/p\u003e\n"],["\u003cp\u003eThe computation is defined by an expression provided in the request body, along with optional parameters for pagination and workload tracking.\u003c/p\u003e\n"],["\u003cp\u003eResults are returned as a GeoJSON FeatureCollection, containing a list of features with their geometry and properties.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires appropriate authorization using OAuth scopes for Earth Engine or Google Cloud Platform.\u003c/p\u003e\n"]]],[],null,["# Method: projects.table.computeFeatures\n\nComputes a set of features by applying an arbitrary computation to features in one or more tables. Results are returned as a list of GeoJSON feature objects.\n\n### HTTP request\n\n`POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/table:computeFeatures`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `project` | `string` The project id or project number of the Google Cloud Platform project that should be treated as the service consumer for this request. Format is `projects/{project-id}`. Authorization requires the following [IAM](https://cloud.google.com/iam/docs/) permission on the specified resource `project`: - `earthengine.computations.create` |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"expression\": { object (/earth-engine/reference/rest/v1alpha/Expression) }, \"pageSize\": integer, \"pageToken\": string, \"workloadTag\": string } ``` |\n\n| Fields ||\n|---------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `expression` | `object (`[Expression](/earth-engine/reference/rest/v1alpha/Expression)`)` The expression to compute. |\n| `pageSize` | `integer` The maximum number of results per page. The server may return fewer features than requested. If unspecified, the page size default is 1000 results per page. |\n| `pageToken` | `string` A token identifying a page of results the server should return. Typically, this is the value of [ComputeFeaturesResponse.next_page_token](/earth-engine/reference/rest/v1alpha/projects.table/computeFeatures#body.ComputeFeaturesResponse.FIELDS.next_page_token) returned from the previous call to the `table.computeFeatures` method. |\n| `workloadTag` | `string` User supplied tag to track this computation. |\n\n### Response body\n\nResponse message for EarthEngineService.ComputeFeatures.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"type\": string, \"features\": [ { object (/earth-engine/reference/rest/v1alpha/Feature) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `type` | `string` Always contains the constant string \"FeatureCollection\", marking this as a GeoJSON FeatureCollection object. |\n| `features[]` | `object (`[Feature](/earth-engine/reference/rest/v1alpha/Feature)`)` The list of features matching the query, as a list of GeoJSON feature objects (see RFC 7946) containing the string \"Feature\" in a field named \"type\", the geometry in a field named \"geometry\", and key/value properties in a field named \"properties\". |\n| `nextPageToken` | `string` A token to retrieve the next page of results. Pass this value in the [ComputeFeaturesRequest.page_token](/earth-engine/reference/rest/v1alpha/projects.table/computeFeatures#body.request_body.FIELDS.page_token) field in the subsequent call to the `table.computeFeatures` method to retrieve the next page of results. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/earthengine`\n- `\n https://www.googleapis.com/auth/earthengine.readonly`\n- `\n https://www.googleapis.com/auth/cloud-platform`\n- `\n https://www.googleapis.com/auth/cloud-platform.read-only`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]