הודעה: כל הפרויקטים הלא מסחריים שנרשמו לשימוש ב-Earth Engine לפני
15 באפריל 2025 חייבים
לאמת את הזכאות לשימוש לא מסחרי כדי לשמור על הגישה. אם לא תאמתו את החשבון עד 26 בספטמבר 2025, יכול להיות שהגישה שלכם תושעה.
ee.Geometry.Polygon.withinDistance
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
הפונקציה מחזירה את הערך true אם ורק אם הצורות הגיאומטריות נמצאות בטווח מרחק שצוין.
שימוש | החזרות |
---|
Polygon.withinDistance(right, distance, maxError, proj) | בוליאני |
ארגומנט | סוג | פרטים |
---|
זה: left | גיאומטריה | הגיאומטריה שמשמשת כאופרנד השמאלי של הפעולה. |
right | גיאומטריה | הגיאומטריה שמשמשת כאופרנד הימני של הפעולה. |
distance | מספר ממשי (float) | סף המרחק. אם מצוינת הקרנה, המרחק הוא ביחידות של מערכת הקואורדינטות המוקרנת. אחרת, הוא במטרים. |
maxError | ErrorMargin, ברירת מחדל: null | הכמות המקסימלית של שגיאות שמותרות כשמבצעים הקרנה מחדש. |
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]]]);
// Define other inputs.
var inputGeom = ee.Geometry.Point(-122.090, 37.423);
// Apply the withinDistance method to the Polygon object.
var polygonWithinDistance = polygon.withinDistance({'right': inputGeom, 'distance': 500, 'maxError': 1});
// Print the result to the console.
print('polygon.withinDistance(...) =', polygonWithinDistance);
// Display relevant geometries on the map.
Map.setCenter(-122.085, 37.422, 15);
Map.addLayer(polygon,
{'color': 'black'},
'Geometry [black]: polygon');
Map.addLayer(inputGeom,
{'color': 'blue'},
'Parameter [blue]: inputGeom');
הגדרת Python
מידע על Python API ועל שימוש ב-geemap
לפיתוח אינטראקטיבי מופיע בדף
Python Environment.
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],
]])
# Define other inputs.
input_geom = ee.Geometry.Point(-122.090, 37.423)
# Apply the withinDistance method to the Polygon object.
polygon_within_distance = polygon.withinDistance(
right=input_geom, distance=500, maxError=1
)
# Print the result.
display('polygon.withinDistance(...) =', polygon_within_distance)
# 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(input_geom, {'color': 'blue'}, 'Parameter [blue]: input_geom')
m
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-26 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-26 (שעון UTC)."],[],["The `withinDistance` method checks if two geometries are within a specified distance. It takes a right geometry, a distance threshold, an optional `maxError` for reprojection, and an optional projection. The method returns `true` if the geometries are within the distance, otherwise `false`. Distance units depend on the projection; meters are used by default. The examples demonstrate how to use `withinDistance` in both JavaScript and Python, showing setting up the parameters and the geometries, then printing the result and showing the geometries in a map.\n"]]