创建一个 ID,用于渲染显示计算结果的地图图块。生成的 ID 应作为 GetTile
请求的一部分使用。
此属性与 GetTile
结合使用。调用 maps.create
会提供一个表达式和一些输出选项。maps.create
的结果是一个地图 ID,表示的是评估该表达式并应用这些选项后得到的图片。随后,可以调用 GetTile
来获取生成图片的任意位置和缩放级别下的某个图块的图片数据。地图 ID 的有效期为中等时间(几个小时)。
这对端点最常见的用例是使用某些计算输出的可视化结果填充地图视口。为此,计算输出必须满足对请求的图片格式的一些合理要求。具体而言,JPEG 或 PNG 格式要求有 1 个或 3 个输出波段,并且剪裁值超出 0-255 范围。
HTTP 请求
POST https://earthengine.googleapis.com/v1alpha/{parent=projects/*}/maps
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
parent |
必需。映射集合的父级(例如“projects/*”)。 必须对指定的资源
|
查询参数
参数 | |
---|---|
workloadTag |
用户提供的用于跟踪此计算的代码。 |
请求正文
请求正文包含一个 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。