geo_polygon_area()
Oblicza obszar wielokąta lub wielokąta na Ziemi.
Składnia
geo_polygon_area(
Wielokąt)
Dowiedz się więcej o konwencjach składniowych.
Parametry
Nazwa | Typ | Wymagane | Opis |
---|---|---|---|
Wielokąt | dynamic |
✔️ | Wielokąt lub multipolygon w formacie GeoJSON. |
Zwraca
Obszar wielokąta lub wielopolygonu, w metrach kwadratowych, na Ziemi. Jeśli wielokąt lub multipolygon jest nieprawidłowy, zapytanie spowoduje wygenerowanie wyniku null.
Uwaga
- Współrzędne geoprzestrzenne są interpretowane jako reprezentowane przez system odniesienia współrzędnych WGS-84 .
- Geodetyczne datum używane do pomiarów na Ziemi jest sferą. Krawędzie wielokątne to geodesy na sferze.
- Jeśli krawędzie wielokąta wejściowe są liniami kartezjańskimi, rozważ użycie geo_polygon_densify(), aby przekonwertować krawędzie planarne na geodesy.
- Jeśli dane wejściowe to wielokąt i zawiera więcej niż jeden wielokąt, wynik będzie obszarem unii wielokątów.
Definicja i ograniczenia wielokąta
dynamic({"type": "Polygon","współrzędne": [ LinearRingShell, LinearRingHole_1, ..., LinearRingHole_N ]})
dynamic({"type": "MultiPolygon","współrzędne": [[ LinearRingShell, LinearRingHole_1, ..., LinearRingHole_N ], ..., [LinearRingShell, LinearRingHole_1, ..., LinearRingHole_M]})
- Program LinearRingShell jest wymagany i zdefiniowany jako uporządkowana
counterclockwise
tablica współrzędnych [[lng_1,lat_1],...,[lng_i,lat_i],...,[lng_j,lat_j],...,[lng_1,lat_1]]. Może istnieć tylko jedna powłoka. - LinearRingHole jest opcjonalny i zdefiniowany jako uporządkowana
clockwise
tablica współrzędnych [[lng_1,lat_1],...,[lng_i,lat_i],...,[lng_j,lat_j],...,[lng_1,lat_1]]. Może istnieć dowolna liczba pierścieni i otworów wewnętrznych. - Wierzchołki liniowe muszą być różne z co najmniej trzema współrzędnymi. Pierwsza współrzędna musi być równa ostatniej. Wymagane są co najmniej cztery wpisy.
- Współrzędne [długość geograficzna, szerokość geograficzna] muszą być prawidłowe. Długość geograficzna musi być liczbą rzeczywistą w zakresie [-180, +180] i szerokość geograficzna musi być liczbą rzeczywistą w zakresie [-90, +90].
- LinearRingShell otacza co najwyżej połowę kuli. Funkcja LinearRing dzieli sferę na dwa regiony. Zostanie wybrana mniejsza z dwóch regionów.
- Długość krawędzi liniowej musi być mniejsza niż 180 stopni. Zostanie wybrana najkrótsza krawędź między dwoma wierzchołkami.
- Linijki nie mogą przekraczać i nie mogą udostępniać krawędzi. Wierzchołki liniowe mogą udostępniać wierzchołki.
Przykłady
Poniższy przykład oblicza obszar NYC Central Park.
let central_park = dynamic({"type":"Polygon","coordinates":[[[-73.9495,40.7969],[-73.95807266235352,40.80068603561921],[-73.98201942443848,40.76825672305777],[-73.97317886352539,40.76455136505513],[-73.9495,40.7969]]]});
print area = geo_polygon_area(central_park)
Dane wyjściowe
obszar |
---|
3475207.28346606 |
Poniższy przykład wykonuje unii wielokątów w wielokącie i oblicza obszar na ujednoliconym wielokącie.
let polygons = dynamic({"type":"MultiPolygon","coordinates":[[[[-73.9495,40.7969],[-73.95807266235352,40.80068603561921],[-73.98201942443848,40.76825672305777],[-73.97317886352539,40.76455136505513],[-73.9495,40.7969]]],[[[-73.94262313842773,40.775991804565585],[-73.98107528686523,40.791849155467695],[-73.99600982666016,40.77092185281977],[-73.96150588989258,40.75609977566361],[-73.94262313842773,40.775991804565585]]]]});
print polygons_union_area = geo_polygon_area(polygons)
Dane wyjściowe
polygons_union_area |
---|
10889971.5343487 |
Poniższy przykład oblicza 5 największych stanów USA według obszaru.
US_States
| project name = features.properties.NAME, polygon = geo_polygon_densify(features.geometry)
| project name, area = geo_polygon_area(polygon)
| top 5 by area desc
Dane wyjściowe
name | obszar |
---|---|
Alaska | 1550934810070.61 |
Teksas | 693231378868.483 |
Kalifornia | 410339536449.521 |
Montana | 379583933973.436 |
New Mexico | 314979912310.579 |
Poniższy przykład zwraca wartość True z powodu nieprawidłowego wielokąta.
print isnull(geo_polygon_area(dynamic({"type": "Polygon","coordinates": [[[0,0],[10,10],[10,10],[0,0]]]})))
Dane wyjściowe
print_0 |
---|
Prawda |
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla