Method: projects.locations.maps.create

계산 결과를 보여주는 지도 타일을 렌더링하는 데 사용할 수 있는 ID를 만듭니다. 결과 ID는 GetTile 요청의 일부로 사용해야 합니다.

GetTile와 함께 사용됩니다. maps.create 호출은 표현식과 일부 출력 옵션을 제공합니다. maps.create의 결과는 해당 표현식을 평가하고 이러한 옵션을 적용한 결과인 이미지를 나타내는 지도 ID입니다. 그런 다음 GetTile를 호출하여 원하는 위치와 확대/축소 수준에서 결과 이미지의 타일 이미지 데이터를 가져올 수 있습니다. 지도 ID는 몇 시간 동안 유효합니다.

이 엔드포인트 쌍의 가장 일반적인 사용 사례는 지도 뷰포인트에 일부 계산의 출력 시각화를 채우는 것입니다. 이를 위해서는 계산 출력이 요청된 이미지 형식에 대한 몇 가지 합리적인 요구사항을 충족해야 합니다. 특히 JPEG 또는 PNG 형식의 경우 출력 밴드가 1개 또는 3개여야 하며 0~255 범위를 벗어나는 클립 값이 있어야 합니다.

HTTP 요청

POST https://earthengine.googleapis.com/v1beta/{parent=projects/*/locations/*}/maps

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

경로 매개변수

매개변수
parent

string

필수입니다. 지도 컬렉션의 상위 요소입니다 (예: 'projects/*')를 사용합니다.

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

  • earthengine.maps.create

쿼리 매개변수

매개변수
workloadTag

string

사용자가 이 계산을 추적하기 위해 제공한 태그입니다.

요청 본문

요청 본문에 EarthEngineMap의 인스턴스가 포함됩니다.

응답 본문

성공한 경우 응답 본문에 새로 생성된 EarthEngineMap의 인스턴스가 포함됩니다.

승인 범위

다음 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를 참고하세요.