公告:所有在
2025 年 4 月 15 日之前注册使用 Earth Engine 的非商业项目都必须
验证是否符合非商业性质的资格条件,才能继续使用 Earth Engine。
ee.Geometry.buffer
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
返回按指定距离缓冲的输入。如果距离为正值,则几何图形会扩大;如果距离为负值,则几何图形会缩小。
用法 | 返回 |
---|
Geometry.buffer(distance, maxError, proj) | 几何图形 |
参数 | 类型 | 详细信息 |
---|
此:geometry | 几何图形 | 要缓冲的几何图形。 |
distance | 浮点数 | 缓冲的距离,可能为负值。如果未指定投影,则单位为米。否则,单位将采用投影的坐标系。 |
maxError | ErrorMargin,默认值:null | 在近似计算缓冲区圆和执行任何必要的重新投影时,可容忍的最大误差量。如果未指定,则默认为距离的 1%。 |
proj | 投影,默认值:null | 如果指定,则缓冲将在此投影中执行,并且距离将解释为此投影的坐标系单位。否则,距离将被解读为米,并且缓冲将在球面坐标系中执行。 |
示例
代码编辑器 (JavaScript)
// Define a Geometry object.
var geometry = ee.Geometry({
'type': 'Polygon',
'coordinates':
[[[-122.081, 37.417],
[-122.086, 37.421],
[-122.084, 37.418],
[-122.089, 37.416]]]
});
// Apply the buffer method to the Geometry object.
var geometryBuffer = geometry.buffer({'distance': 100});
// Print the result to the console.
print('geometry.buffer(...) =', geometryBuffer);
// Display relevant geometries on the map.
Map.setCenter(-122.085, 37.422, 15);
Map.addLayer(geometry,
{'color': 'black'},
'Geometry [black]: geometry');
Map.addLayer(geometryBuffer,
{'color': 'red'},
'Result [red]: geometry.buffer');
Python 设置
如需了解 Python API 和如何使用 geemap
进行交互式开发,请参阅
Python 环境页面。
import ee
import geemap.core as geemap
Colab (Python)
# Define a Geometry object.
geometry = ee.Geometry({
'type': 'Polygon',
'coordinates': [[
[-122.081, 37.417],
[-122.086, 37.421],
[-122.084, 37.418],
[-122.089, 37.416],
]],
})
# Apply the buffer method to the Geometry object.
geometry_buffer = geometry.buffer(distance=100)
# Print the result.
display('geometry.buffer(...) =', geometry_buffer)
# Display relevant geometries on the map.
m = geemap.Map()
m.set_center(-122.085, 37.422, 15)
m.add_layer(geometry, {'color': 'black'}, 'Geometry [black]: geometry')
m.add_layer(
geometry_buffer, {'color': 'red'}, 'Result [red]: geometry.buffer'
)
m
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-26。
[null,null,["最后更新时间 (UTC):2025-07-26。"],[[["\u003cp\u003e\u003ccode\u003ebuffer()\u003c/code\u003e returns a modified Geometry that is expanded or contracted by a specified distance.\u003c/p\u003e\n"],["\u003cp\u003ePositive distances expand the geometry outwards, while negative distances contract it inwards.\u003c/p\u003e\n"],["\u003cp\u003eThe buffering can be performed using meters or a projected coordinate system by specifying the \u003ccode\u003eproj\u003c/code\u003e parameter.\u003c/p\u003e\n"],["\u003cp\u003eAn optional \u003ccode\u003emaxError\u003c/code\u003e parameter controls the accuracy of the buffer approximation.\u003c/p\u003e\n"]]],[],null,["# ee.Geometry.buffer\n\nReturns the input buffered by a given distance. If the distance is positive, the geometry is expanded, and if the distance is negative, the geometry is contracted.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|------------------------------------------------------|----------|\n| Geometry.buffer`(distance, `*maxError* `, `*proj*`)` | Geometry |\n\n| Argument | Type | Details |\n|------------------|----------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| this: `geometry` | Geometry | The geometry being buffered. |\n| `distance` | Float | The distance of the buffering, which may be negative. If no projection is specified, the unit is meters. Otherwise the unit is in the coordinate system of the projection. |\n| `maxError` | ErrorMargin, default: null | The maximum amount of error tolerated when approximating the buffering circle and performing any necessary reprojection. If unspecified, defaults to 1% of the distance. |\n| `proj` | Projection, default: null | If specified, the buffering will be performed in this projection and the distance will be interpreted as units of the coordinate system of this projection. Otherwise the distance is interpereted as meters and the buffering is performed in a spherical coordinate system. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// Define a Geometry object.\nvar geometry = ee.Geometry({\n 'type': 'Polygon',\n 'coordinates':\n [[[-122.081, 37.417],\n [-122.086, 37.421],\n [-122.084, 37.418],\n [-122.089, 37.416]]]\n});\n\n// Apply the buffer method to the Geometry object.\nvar geometryBuffer = geometry.buffer({'distance': 100});\n\n// Print the result to the console.\nprint('geometry.buffer(...) =', geometryBuffer);\n\n// Display relevant geometries on the map.\nMap.setCenter(-122.085, 37.422, 15);\nMap.addLayer(geometry,\n {'color': 'black'},\n 'Geometry [black]: geometry');\nMap.addLayer(geometryBuffer,\n {'color': 'red'},\n 'Result [red]: geometry.buffer');\n```\nPython setup\n\nSee the [Python Environment](/earth-engine/guides/python_install) page for information on the Python API and using\n`geemap` for interactive development. \n\n```python\nimport ee\nimport geemap.core as geemap\n```\n\n### Colab (Python)\n\n```python\n# Define a Geometry object.\ngeometry = ee.Geometry({\n 'type': 'Polygon',\n 'coordinates': [[\n [-122.081, 37.417],\n [-122.086, 37.421],\n [-122.084, 37.418],\n [-122.089, 37.416],\n ]],\n})\n\n# Apply the buffer method to the Geometry object.\ngeometry_buffer = geometry.buffer(distance=100)\n\n# Print the result.\ndisplay('geometry.buffer(...) =', geometry_buffer)\n\n# Display relevant geometries on the map.\nm = geemap.Map()\nm.set_center(-122.085, 37.422, 15)\nm.add_layer(geometry, {'color': 'black'}, 'Geometry [black]: geometry')\nm.add_layer(\n geometry_buffer, {'color': 'red'}, 'Result [red]: geometry.buffer'\n)\nm\n```"]]