公告:所有在
2025 年 4 月 15 日之前注册使用 Earth Engine 的非商业项目都必须
验证是否符合非商业性质的资格条件,才能继续使用 Earth Engine。
ee.FeatureCollection.randomPoints
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
在给定几何图形中生成均匀随机的点。如果几何图形是二维(多边形或多边形),则返回的点会均匀分布在球体的给定区域上。如果几何图形是一维的(线串),则返回的点会沿着几何图形的边缘均匀插值。如果几何图形的维度为零(点),则系统会从输入点均匀抽取返回的点。如果给定的是混合维度的多几何图形,则系统会从维度最高的组成几何图形中采样点。
用法 | 返回 |
---|
ee.FeatureCollection.randomPoints(region, points, seed, maxError) | FeatureCollection |
参数 | 类型 | 详细信息 |
---|
region | 几何图形 | 要为其生成点的区域。 |
points | 整数,默认值:1000 | 要生成的点数。 |
seed | 长整数,默认值:0 | 随机数生成器的种子。 |
maxError | ErrorMargin,可选 | 执行任何必要的重新投影时允许的最大误差量。 |
示例
Code Editor (JavaScript)
// An ee.Geometry to constrain the geographic bounds of random points.
var region = ee.Geometry.Rectangle(
{coords: [-113.5, 40.0, -110.2, 41.9], geodesic: false});
// Generate 50 random points with the region.
var randomPoints = ee.FeatureCollection.randomPoints(
{region: region, points: 50, seed: 0, maxError: 1});
print('Random points from within the defined region', randomPoints);
Map.setCenter(-111.802, 40.979, 7);
Map.addLayer(region, {color: 'yellow'}, 'Region');
Map.addLayer(randomPoints, {color: 'black'}, 'Random points');
Python 设置
如需了解 Python API 以及如何使用 geemap
进行交互式开发,请参阅
Python 环境页面。
import ee
import geemap.core as geemap
Colab (Python)
# An ee.Geometry to constrain the geographic bounds of random points.
region = ee.Geometry.Rectangle(
coords=[-113.5, 40.0, -110.2, 41.9], proj='EPSG:4326', geodesic=False
)
# Generate 50 random points with the region.
random_points = ee.FeatureCollection.randomPoints(
region=region, points=50, seed=0, maxError=1
)
display('Random points from within the defined region', random_points)
m = geemap.Map()
m.set_center(-111.802, 40.979, 7)
m.add_layer(region, {'color': 'yellow'}, 'Region')
m.add_layer(random_points, {'color': 'black'}, 'Random points')
m
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[[["\u003cp\u003e\u003ccode\u003eee.FeatureCollection.randomPoints\u003c/code\u003e generates uniformly random points within a specified geometry, such as polygons, linestrings, or points.\u003c/p\u003e\n"],["\u003cp\u003eThe distribution of points varies based on the geometry's dimension: uniform on the surface for polygons, along edges for linestrings, and from input points for point geometries.\u003c/p\u003e\n"],["\u003cp\u003eThe function takes parameters like \u003ccode\u003eregion\u003c/code\u003e (geometry), \u003ccode\u003epoints\u003c/code\u003e (number of points), \u003ccode\u003eseed\u003c/code\u003e (for reproducibility), and \u003ccode\u003emaxError\u003c/code\u003e (for reprojection tolerance).\u003c/p\u003e\n"],["\u003cp\u003eUsers can specify the desired number of random points to generate and provide a seed value for consistent results.\u003c/p\u003e\n"],["\u003cp\u003eIf a mixed-dimension geometry is provided, the function samples points from the highest-dimension component.\u003c/p\u003e\n"]]],["The `ee.FeatureCollection.randomPoints` function generates a specified number of random points within a given geometry. The points are uniformly distributed within the geometry's area if it's two-dimensional, along its edges if one-dimensional, or sampled from the input points if zero-dimensional. For mixed-dimension multi-geometries, points are drawn from the highest-dimension components. The user defines the `region`, the number of `points`, a random `seed`, and an optional `maxError`.\n"],null,["# ee.FeatureCollection.randomPoints\n\nGenerates points that are uniformly random in the given geometry. If the geometry is two-dimensional (polygon or multi-polygon) then the returned points are uniformly distributed on the given region of the sphere. If the geometry is one-dimensional (linestrings), the returned points are interpolated uniformly along the geometry's edges. If the geometry has dimension zero (points), the returned points are sampled uniformly from the input points. If a multi-geometry of mixed dimension is given, points are sampled from the component geometries with the highest dimension.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|-----------------------------------------------------------------------------------|-------------------|\n| `ee.FeatureCollection.randomPoints(region, `*points* `, `*seed* `, `*maxError*`)` | FeatureCollection |\n\n| Argument | Type | Details |\n|------------|------------------------|-----------------------------------------------------------------------------------|\n| `region` | Geometry | The region to generate points for. |\n| `points` | Integer, default: 1000 | The number of points to generate. |\n| `seed` | Long, default: 0 | A seed for the random number generator. |\n| `maxError` | ErrorMargin, optional | The maximum amount of error tolerated when performing any necessary reprojection. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// An ee.Geometry to constrain the geographic bounds of random points.\nvar region = ee.Geometry.Rectangle(\n {coords: [-113.5, 40.0, -110.2, 41.9], geodesic: false});\n\n// Generate 50 random points with the region.\nvar randomPoints = ee.FeatureCollection.randomPoints(\n {region: region, points: 50, seed: 0, maxError: 1});\n\nprint('Random points from within the defined region', randomPoints);\nMap.setCenter(-111.802, 40.979, 7);\nMap.addLayer(region, {color: 'yellow'}, 'Region');\nMap.addLayer(randomPoints, {color: 'black'}, 'Random points');\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# An ee.Geometry to constrain the geographic bounds of random points.\nregion = ee.Geometry.Rectangle(\n coords=[-113.5, 40.0, -110.2, 41.9], proj='EPSG:4326', geodesic=False\n)\n\n# Generate 50 random points with the region.\nrandom_points = ee.FeatureCollection.randomPoints(\n region=region, points=50, seed=0, maxError=1\n)\n\ndisplay('Random points from within the defined region', random_points)\nm = geemap.Map()\nm.set_center(-111.802, 40.979, 7)\nm.add_layer(region, {'color': 'yellow'}, 'Region')\nm.add_layer(random_points, {'color': 'black'}, 'Random points')\nm\n```"]]