إشعار: يجب
إثبات أهلية جميع المشاريع غير التجارية المسجّلة لاستخدام Earth Engine قبل
15 أبريل 2025 من أجل الحفاظ على إمكانية الوصول إلى Earth Engine.
ee.Geometry.Rectangle
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تنشئ هذه الدالة ee.Geometry تصف مضلّعًا مستطيلاً.
لتسهيل الأمر، يمكن استخدام الوسيط المتغيّر عندما تكون جميع الوسيطات أرقامًا. يتيح ذلك إنشاء مضلّعات EPSG:4326 باستخدام أربع إحداثيات بالضبط، مثل ee.Geometry.Rectangle(minLng, minLat, maxLng, maxLat).
الاستخدام | المرتجعات |
---|
ee.Geometry.Rectangle(coords, proj, geodesic, evenOdd) | Geometry.Rectangle |
الوسيطة | النوع | التفاصيل |
---|
coords | List<Geometry>|List<List<Number>>|List<Number> | الحد الأدنى والحد الأقصى لأركان المستطيل، وذلك على شكل قائمة من نقطتين لكل ركن بالتنسيق GeoJSON "نقطة" للإحداثيات، أو قائمة من عنصرَين من عناصر ee.Geometry يصفان نقطة، أو قائمة من أربعة أرقام بالترتيب xMin وyMin وxMax وyMax |
proj | التوقّعات، اختيارية | إسقاط هذا الشكل الهندسي إذا لم يتم تحديد نظام الإسقاط، سيكون نظام الإسقاط التلقائي هو نظام إسقاط ee.Geometry للإدخال، أو EPSG:4326 إذا لم تكن هناك مدخلات ee.Geometry. |
geodesic | قيمة منطقية، اختيارية | إذا كانت القيمة false، تكون الحواف مستقيمة في العرض. إذا كانت القيمة هي true، تكون الحواف منحنية لتتّبع أقصر مسار على سطح الأرض. القيمة التلقائية هي الحالة الجيوديسية للمدخلات، أو "صحيح" إذا كانت المدخلات أرقامًا. |
evenOdd | قيمة منطقية، اختيارية | إذا كانت القيمة صحيحة، سيتم تحديد الأجزاء الداخلية للمضلّع حسب قاعدة الزوجي/الفردي، حيث تكون النقطة داخل المضلّع إذا كانت تعبر عددًا فرديًا من الحواف للوصول إلى نقطة في اللانهاية. وفي الحالات الأخرى، تستخدم المضلّعات قاعدة "اليسار-الداخل"، حيث تكون الأجزاء الداخلية على الجانب الأيسر من حواف الشكل عند التنقّل بين الرؤوس بالترتيب المحدّد. إذا لم يتم تحديد هذه السمة، تكون القيمة التلقائية هي "صحيح". |
أمثلة
محرّر الرموز البرمجية (JavaScript)
// Coordinates for the bounds of a rectangle.
var xMin = -122.09;
var yMin = 37.42;
var xMax = -122.08;
var yMax = 37.43;
// Construct a rectangle from a list of GeoJSON 'point' formatted coordinates.
var rectangleGeoJSON = ee.Geometry.Rectangle(
[
[xMin, yMin],
[xMax, yMax] // max x and y
]
);
Map.addLayer(rectangleGeoJSON, {}, 'rectangleGeoJSON');
// Construct a rectangle from a list of ee.Geometry.Point objects.
var rectanglePoint = ee.Geometry.Rectangle(
[
ee.Geometry.Point(xMin, yMin), // min x and y
ee.Geometry.Point(xMax, yMax) // max x and y
]
);
Map.addLayer(rectanglePoint, {}, 'rectanglePoint');
// Construct a rectangle from a list of bounding coordinates.
var rectangleBounds = ee.Geometry.Rectangle(
[xMin, yMin, xMax, yMax]
);
Map.addLayer(rectangleBounds, {}, 'rectangleBounds');
Map.setCenter(-122.085, 37.422, 15);
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eDefines a rectangular polygon geometry in Earth Engine.\u003c/p\u003e\n"],["\u003cp\u003eAccepts coordinates as GeoJSON points, Earth Engine points, or bounding numbers.\u003c/p\u003e\n"],["\u003cp\u003eAllows specifying projection, geodesic nature, and polygon interior rules.\u003c/p\u003e\n"],["\u003cp\u003eProvides a convenient way to create EPSG:4326 polygons with four coordinates directly.\u003c/p\u003e\n"]]],[],null,["# ee.Geometry.Rectangle\n\n\u003cbr /\u003e\n\nConstructs an ee.Geometry describing a rectangular polygon.\n\n\u003cbr /\u003e\n\nFor convenience, varargs may be used when all arguments are numbers. This allows creating EPSG:4326 Polygons given exactly four coordinates, e.g. ee.Geometry.Rectangle(minLng, minLat, maxLng, maxLat).\n\n| Usage | Returns |\n|------------------------------------------------------------------------|--------------------|\n| `ee.Geometry.Rectangle(coords, `*proj* `, `*geodesic* `, `*evenOdd*`)` | Geometry.Rectangle |\n\n| Argument | Type | Details |\n|------------|----------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `coords` | List\\\u003cGeometry\\\u003e\\|List\\\u003cList\\\u003cNumber\\\u003e\\\u003e\\|List\\\u003cNumber\\\u003e | The minimum and maximum corners of the rectangle, as a list of two points each in the format of GeoJSON 'Point' coordinates, or a list of two ee.Geometry objects describing a point, or a list of four numbers in the order xMin, yMin, xMax, yMax. |\n| `proj` | Projection, optional | The projection of this geometry. If unspecified, the default is the projection of the input ee.Geometry, or EPSG:4326 if there are no ee.Geometry inputs. |\n| `geodesic` | Boolean, optional | If false, edges are straight in the projection. If true, edges are curved to follow the shortest path on the surface of the Earth. The default is the geodesic state of the inputs, or true if the inputs are numbers. |\n| `evenOdd` | Boolean, optional | If true, polygon interiors will be determined by the even/odd rule, where a point is inside if it crosses an odd number of edges to reach a point at infinity. Otherwise polygons use the left- inside rule, where interiors are on the left side of the shell's edges when walking the vertices in the given order. If unspecified, defaults to true. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// Coordinates for the bounds of a rectangle.\nvar xMin = -122.09;\nvar yMin = 37.42;\nvar xMax = -122.08;\nvar yMax = 37.43;\n\n// Construct a rectangle from a list of GeoJSON 'point' formatted coordinates.\nvar rectangleGeoJSON = ee.Geometry.Rectangle(\n [\n [xMin, yMin],\n [xMax, yMax] // max x and y\n ]\n);\nMap.addLayer(rectangleGeoJSON, {}, 'rectangleGeoJSON');\n\n// Construct a rectangle from a list of ee.Geometry.Point objects.\nvar rectanglePoint = ee.Geometry.Rectangle(\n [\n ee.Geometry.Point(xMin, yMin), // min x and y\n ee.Geometry.Point(xMax, yMax) // max x and y\n ]\n);\nMap.addLayer(rectanglePoint, {}, 'rectanglePoint');\n\n// Construct a rectangle from a list of bounding coordinates.\nvar rectangleBounds = ee.Geometry.Rectangle(\n [xMin, yMin, xMax, yMax]\n);\nMap.addLayer(rectangleBounds, {}, 'rectangleBounds');\n\nMap.setCenter(-122.085, 37.422, 15);\n```"]]