geo_simplify_polygons_array()
Förenklar polygoner genom att ersätta nästan raka kedjor av korta kanter med en enda lång kant på jorden.
Syntax
geo_simplify_polygons_array(
Polygoner,
Tolerans)
Läs mer om syntaxkonventioner.
Parametrar
Namn | Typ | Obligatorisk | Beskrivning |
---|---|---|---|
Polygon | dynamic |
✔️ | Polygon eller multipolygon i GeoJSON-format. |
Tolerans | int, long eller real | Definierar minsta avstånd i meter mellan två hörn. Värden som stöds finns i intervallet [0, ~7 800 000 meter]. Om det är ospecificerat används standardvärdet 10 . |
Returer
Förenklad polygon eller multipolygon i GeoJSON-format och av en dynamisk datatyp, utan två hörn med ett avstånd som är mindre än tolerans. Om polygonen eller toleransen är ogiltig ger frågan ett null-resultat.
Anteckning
- Om indata är en enda polygon kan du läsa geo_polygon_simplify().
- De geospatiala koordinaterna tolkas som de representeras av WGS-84-koordinatreferenssystemet .
- Det geodetiska datum som används för mätningar på jorden är en sfär. Polygonkanter är geodesik på sfären.
- Om indatapolygonkanter är raka kartesiska linjer bör du överväga att använda geo_polygon_densify() för att konvertera plana kanter till geodesik.
- Om indata är en multipolygon och innehåller mer än en polygon blir resultatet området för polygoner.
- Hög tolerans kan leda till att små polygoner försvinner.
Polygondefinition och begränsningar
dynamic({"type": "Polygon","coordinates": [ LinearRingShell, LinearRingHole_1, ..., LinearRingHole_N ]})
dynamic({"type": "MultiPolygon","coordinates": [[ LinearRingShell, LinearRingHole_1, ..., LinearRingHole_N ], ..., [LinearRingShell, LinearRingHole_1, ..., LinearRingHole_M]]})
- LinearRingShell krävs och definieras som en
counterclockwise
ordnad matris med koordinater [[lng_1,lat_1],...,[lng_i,lat_i],...,[lng_j,lat_j],...,[lng_1,lat_1]]. Det kan bara finnas ett gränssnitt. - LinearRingHole är valfritt och definieras som en
clockwise
ordnad matris med koordinater [[lng_1,lat_1],...,[lng_i,lat_i],...,[lng_j,lat_j],...,[lng_1,lat_1]]. Det kan finnas valfritt antal inre ringar och hål. - Linjära hörn måste vara distinkta med minst tre koordinater. Den första koordinaten måste vara lika med den sista. Minst fyra poster krävs.
- Koordinaterna [longitud, latitud] måste vara giltiga. Longitud måste vara ett verkligt tal i intervallet [-180, +180] och latitud måste vara ett verkligt tal i intervallet [-90, +90].
- LinearRingShell omsluter högst hälften av sfären. Linjärring delar upp sfären i två regioner. Den mindre av de två regionerna väljs.
- Linjär Kantlängd måste vara mindre än 180 grader. Den kortaste kanten mellan de två hörnen väljs.
- Linjära linjer får inte korsas och får inte dela kanter. LinearRings kan dela hörn.
Exempel
I följande exempel förenklas polygoner med ömsesidiga gränser (USA-stater) genom att ta bort hörn som ligger inom ett avstånd på 100 meter från varandra.
US_States
| project polygon = features.geometry
| summarize lst = make_list(polygon)
| project polygons = geo_simplify_polygons_array(lst, 100)
Resultat
Polygoner |
---|
{ "type": "MultiPolygon", "coordinates": [ ... ]]} |
Följande exempel returnerar True eftersom en av polygonerna är ogiltig.
datatable(polygons:dynamic)
[
dynamic({"type":"Polygon","coordinates":[[[-73.9495,40.7969],[-73.95807,40.80068],[-73.98201,40.76825],[-73.97317,40.76455],[-73.9495,40.7969]]]}),
dynamic({"type":"Polygon","coordinates":[[[-73.94622,40.79249]]]}),
dynamic({"type":"Polygon","coordinates":[[[-73.97335,40.77274],[-73.9936,40.76630],[-73.97171,40.75655],[-73.97335,40.77274]]]})
]
| summarize arr = make_list(polygons)
| project is_invalid_polygon = isnull(geo_simplify_polygons_array(arr))
Resultat
is_invalid_polygon |
---|
1 |
Följande exempel returnerar True på grund av den ogiltiga toleransen.
datatable(polygons:dynamic)
[
dynamic({"type":"Polygon","coordinates":[[[-73.9495,40.7969],[-73.95807,40.80068],[-73.98201,40.76825],[-73.97317,40.76455],[-73.9495,40.7969]]]}),
dynamic({"type":"Polygon","coordinates":[[[-73.94622,40.79249],[-73.96888,40.79282],[-73.9577,40.7789],[-73.94622,40.79249]]]}),
dynamic({"type":"Polygon","coordinates":[[[-73.97335,40.77274],[-73.9936,40.76630],[-73.97171,40.75655],[-73.97335,40.77274]]]})
]
| summarize arr = make_list(polygons)
| project is_null = isnull(geo_simplify_polygons_array(arr, -1))
Resultat
is_null |
---|
1 |
I följande exempel returneras Sant eftersom hög tolerans gör att polygon försvinner.
datatable(polygons:dynamic)
[
dynamic({"type":"Polygon","coordinates":[[[-73.9495,40.7969],[-73.95807,40.80068],[-73.98201,40.76825],[-73.97317,40.76455],[-73.9495,40.7969]]]}),
dynamic({"type":"Polygon","coordinates":[[[-73.94622,40.79249],[-73.96888,40.79282],[-73.9577,40.7789],[-73.94622,40.79249]]]}),
dynamic({"type":"Polygon","coordinates":[[[-73.97335,40.77274],[-73.9936,40.76630],[-73.97171,40.75655],[-73.97335,40.77274]]]})
]
| summarize arr = make_list(polygons)
| project is_null = isnull(geo_simplify_polygons_array(arr, 10000))
Resultat
is_null |
---|
1 |
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för