إشعار: يجب
إثبات الأهلية للاستخدام غير التجاري لجميع المشاريع غير التجارية المسجّلة لاستخدام Earth Engine قبل
15 أبريل 2025 من أجل الحفاظ على إمكانية الوصول إليها. إذا لم يتم تأكيد حسابك بحلول 26 سبتمبر 2025، قد يتم تعليق إمكانية الوصول إليه.
ee.FeatureCollection.randomPoints
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تُنشئ نقاطًا عشوائية بشكلٍ منتظم في الشكل الهندسي المحدّد. إذا كانت الأشكال الهندسية ثنائية الأبعاد (مضلّع أو مضلّعات متعددة)، يتم توزيع النقاط المعروضة بالتساوي على المنطقة المحدّدة من الكرة الأرضية. إذا كان الشكل الهندسي أحادي البعد (سلاسل خطوط)، يتمّ الاستقراء بين النقاط المعروضة بشكلٍ موحّد على طول حواف الشكل الهندسي. إذا كان الشكل الهندسي له سمة البعد صفر (نقاط)، يتم أخذ عيّنات من النقاط المعروضة بشكل موحّد من نقاط الإدخال. إذا تم تقديم هندسة متعددة ذات أبعاد مختلطة، يتم أخذ عيّنات من الأشكال الهندسية للمكوّنات ذات الأبعاد الأعلى.
| الاستخدام | المرتجعات |
|---|
ee.FeatureCollection.randomPoints(region, points, seed, maxError) | FeatureCollection |
| الوسيطة | النوع | التفاصيل |
|---|
region | هندسة | المنطقة التي يتم إنشاء النقاط لها. |
points | عدد صحيح، الإعداد التلقائي: 1000 | عدد النقاط المطلوب إنشاؤها |
seed | طويلة، الإعداد التلقائي: 0 | قيمة أساسية لأداة إنشاء الأرقام العشوائية |
maxError | ErrorMargin، اختياري | الحد الأقصى المسموح به للخطأ عند إجراء أي عملية إعادة إسقاط ضرورية |
أمثلة
محرِّر الرموز البرمجية (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 للحصول على معلومات عن واجهة برمجة التطبيقات Python API واستخدام IDE
geemap لتطوير التطبيقات التفاعلي.
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
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],["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"]]