ee.Geometry.MultiLineString.cutLines

تحوّل هذه الدالة الأشكال الهندسية LineString وMultiLineString وLinearRing إلى MultiLineString من خلال تقسيمها إلى أجزاء لا يزيد طولها عن المسافة المحدّدة على طولها. سيتم تحويل جميع أنواع الأشكال الهندسية الأخرى إلى MultiLineString فارغ.

الاستخدام	المرتجعات
MultiLineString.cutLines(distances, maxError, proj)	هندسة

الوسيطة	النوع	التفاصيل
هذا: geometry	هندسة	يقطع خطوط هذا الشكل الهندسي.
distances	قائمة	المسافات على طول كل LineString لتقسيم الخط إلى أجزاء منفصلة، ويتم قياسها بوحدات نظام الإسقاط المحدد، أو بالمتر إذا لم يتم تحديد نظام الإسقاط.
maxError	ErrorMargin، القيمة التلقائية: null	الحدّ الأقصى لمقدار الخطأ المسموح به عند إجراء أي عملية إعادة إسقاط ضرورية.
proj	التوقّع، القيمة التلقائية: null	إسقاط النتائج وقياسات المسافة، أو EPSG:4326 إذا لم يتم تحديدها

أمثلة

محرّر الرموز البرمجية (JavaScript)

// Define a MultiLineString object.
var multiLineString = ee.Geometry.MultiLineString(
   [[[-122.088, 37.418], [-122.086, 37.422], [-122.082, 37.418]],
    [[-122.087, 37.416], [-122.083, 37.416], [-122.082, 37.419]]]);

// Apply the cutLines method to the MultiLineString object.
var multiLineStringCutLines = multiLineString.cutLines({'distances': [10, 100], 'maxError': 1});

// Print the result to the console.
print('multiLineString.cutLines(...) =', multiLineStringCutLines);

// Display relevant geometries on the map.
Map.setCenter(-122.085, 37.422, 15);
Map.addLayer(multiLineString,
             {'color': 'black'},
             'Geometry [black]: multiLineString');
Map.addLayer(multiLineStringCutLines,
             {'color': 'red'},
             'Result [red]: multiLineString.cutLines');

إعداد Python

راجِع صفحة بيئة Python للحصول على معلومات حول واجهة برمجة التطبيقات Python واستخدام geemap للتطوير التفاعلي.

import ee
import geemap.core as geemap

Colab (Python)

# Define a MultiLineString object.
multilinestring = ee.Geometry.MultiLineString([
    [[-122.088, 37.418], [-122.086, 37.422], [-122.082, 37.418]],
    [[-122.087, 37.416], [-122.083, 37.416], [-122.082, 37.419]],
])

# Apply the cutLines method to the MultiLineString object.
multilinestring_cut_lines = multilinestring.cutLines(
    distances=[10, 100], maxError=1
)

# Print the result.
display('multilinestring.cutLines(...) =', multilinestring_cut_lines)

# Display relevant geometries on the map.
m = geemap.Map()
m.set_center(-122.085, 37.422, 15)
m.add_layer(
    multilinestring, {'color': 'black'}, 'Geometry [black]: multilinestring'
)
m.add_layer(
    multilinestring_cut_lines,
    {'color': 'red'},
    'Result [red]: multilinestring.cutLines',
)
m