公告:所有在
2025 年 4 月 15 日之前注册使用 Earth Engine 的非商业项目都必须
验证是否符合非商业性质的资格条件,才能继续使用 Earth Engine。
ee.Geometry.Polygon.buffer
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
返回按指定距离缓冲的输入。如果距离为正值,则几何图形会扩大;如果距离为负值,则几何图形会缩小。
用法 | 返回 |
---|
Polygon.buffer(distance, maxError, proj) | 几何图形 |
参数 | 类型 | 详细信息 |
---|
此:geometry | 几何图形 | 要缓冲的几何图形。 |
distance | 浮点数 | 缓冲的距离,可能为负值。如果未指定投影,则单位为米。否则,单位将采用投影的坐标系。 |
maxError | ErrorMargin,默认值:null | 在近似计算缓冲区圆和执行任何必要的重新投影时,可容忍的最大误差量。如果未指定,则默认为距离的 1%。 |
proj | 投影,默认值:null | 如果指定,则缓冲将在此投影中执行,并且距离将解释为此投影的坐标系单位。否则,距离将被解读为米,并且缓冲将在球面坐标系中执行。 |
示例
代码编辑器 (JavaScript)
// Define a Polygon object.
var polygon = ee.Geometry.Polygon(
[[[-122.092, 37.424],
[-122.086, 37.418],
[-122.079, 37.425],
[-122.085, 37.423]]]);
// Apply the buffer method to the Polygon object.
var polygonBuffer = polygon.buffer({'distance': 100});
// Print the result to the console.
print('polygon.buffer(...) =', polygonBuffer);
// Display relevant geometries on the map.
Map.setCenter(-122.085, 37.422, 15);
Map.addLayer(polygon,
{'color': 'black'},
'Geometry [black]: polygon');
Map.addLayer(polygonBuffer,
{'color': 'red'},
'Result [red]: polygon.buffer');
Python 设置
如需了解 Python API 和如何使用 geemap
进行交互式开发,请参阅
Python 环境页面。
import ee
import geemap.core as geemap
Colab (Python)
# Define a Polygon object.
polygon = ee.Geometry.Polygon([[
[-122.092, 37.424],
[-122.086, 37.418],
[-122.079, 37.425],
[-122.085, 37.423],
]])
# Apply the buffer method to the Polygon object.
polygon_buffer = polygon.buffer(distance=100)
# Print the result.
display('polygon.buffer(...) =', polygon_buffer)
# Display relevant geometries on the map.
m = geemap.Map()
m.set_center(-122.085, 37.422, 15)
m.add_layer(polygon, {'color': 'black'}, 'Geometry [black]: polygon')
m.add_layer(polygon_buffer, {'color': 'red'}, 'Result [red]: polygon.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 Geometry that is the input geometry expanded or contracted by a given distance.\u003c/p\u003e\n"],["\u003cp\u003ePositive distance values expand the geometry while negative values contract it.\u003c/p\u003e\n"],["\u003cp\u003eThe distance is in meters unless a projection (\u003ccode\u003eproj\u003c/code\u003e) is specified, in which case the distance is in the units of that projection's coordinate system.\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.Polygon.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| Polygon.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 Polygon object.\nvar polygon = ee.Geometry.Polygon(\n [[[-122.092, 37.424],\n [-122.086, 37.418],\n [-122.079, 37.425],\n [-122.085, 37.423]]]);\n\n// Apply the buffer method to the Polygon object.\nvar polygonBuffer = polygon.buffer({'distance': 100});\n\n// Print the result to the console.\nprint('polygon.buffer(...) =', polygonBuffer);\n\n// Display relevant geometries on the map.\nMap.setCenter(-122.085, 37.422, 15);\nMap.addLayer(polygon,\n {'color': 'black'},\n 'Geometry [black]: polygon');\nMap.addLayer(polygonBuffer,\n {'color': 'red'},\n 'Result [red]: polygon.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 Polygon object.\npolygon = ee.Geometry.Polygon([[\n [-122.092, 37.424],\n [-122.086, 37.418],\n [-122.079, 37.425],\n [-122.085, 37.423],\n]])\n\n# Apply the buffer method to the Polygon object.\npolygon_buffer = polygon.buffer(distance=100)\n\n# Print the result.\ndisplay('polygon.buffer(...) =', polygon_buffer)\n\n# Display relevant geometries on the map.\nm = geemap.Map()\nm.set_center(-122.085, 37.422, 15)\nm.add_layer(polygon, {'color': 'black'}, 'Geometry [black]: polygon')\nm.add_layer(polygon_buffer, {'color': 'red'}, 'Result [red]: polygon.buffer')\nm\n```"]]