계산 결과를 보여주는 지도 타일을 렌더링하는 데 사용할 수 있는 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
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-25(UTC)"],[[["Creates a map ID for rendering map tiles based on computations using the `maps.create` function."],["This ID is used with `GetTile` requests to retrieve image data for specific locations and zoom levels within the computed map."],["Output data needs to be compatible with JPEG or PNG format, such as having 1-3 bands with values between 0-255."],["Map IDs are temporary and valid for a few hours, generally used to display visualizations within a map viewport."],["Authorization is required and can be obtained using various OAuth scopes including earthengine, cloud-platform, and their readonly counterparts."]]],["This outlines the `maps.create` process for generating map tiles. It involves sending a POST request to create a map ID, specifying an expression and output options. This ID represents a computed image. Subsequent `GetTile` requests use this ID to retrieve image data for specific tiles at any zoom level. The map ID remains valid for a limited period. The process requires specific IAM permissions, a user-supplied tag, and OAuth scopes, output format should be compatible with JPEG or PNG format.\n"]]