geo_intersection_2polygons()

  • Artykuł

Oblicza przecięcie dwóch wielokątów lub wielobiegunów.

Składnia

geo_intersection_2polygons(wielokąt1,wielokąt1)

Dowiedz się więcej o konwencjach składniowych.

Parametry

Nazwa Typ Wymagane Opis
wielokąt1 dynamic ✔️ Wielokąt lub multipolygon w formacie GeoJSON.
wielokąt2 dynamic ✔️ Wielokąt lub multipolygon w formacie GeoJSON.

Zwraca

Skrzyżowanie w formacie GeoJSON i dynamicznym typie danych . Jeśli wielokąt lub MultiPolygon są nieprawidłowe, zapytanie zwróci wynik null.

Uwaga

  • Współrzędne geoprzestrzenne są interpretowane jako reprezentowane przez system odniesienia współrzędnych WGS-84 .
  • Geodetic datum używane do pomiarów na Ziemi jest sferą. Krawędzie wielokątne są geodesykami na sferze.
  • Jeśli krawędzie wielokąta wejściowe są prostymi liniami kartezjańskimi, rozważ użycie geo_polygon_densify() w celu przekonwertowania krawędzi planarnych na geodesyki.

Definicja i ograniczenia wielokątne

dynamic({"type": "Polygon","coordinates": [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 tablica współrzędnych counterclockwise [[lng_1,lat_1],...,[lng_i,lat_i],...,[lng_j,lat_j],...,[lng_1,lat_1]]. Może istnieć tylko jedna powłoka.
  • Element LinearRingHole jest opcjonalny i zdefiniowany jako uporządkowana tablica współrzędnych clockwise [[lng_1,lat_1],...,[lng_i,lat_i],...,[lng_j,lat_j],...,[lng_1,lat_1]]. Może istnieć dowolna liczba wewnętrznych pierścieni i otworów.
  • 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], a szerokość geograficzna musi być liczbą rzeczywistą w zakresie [-90, +90].
  • LinearRingShell otacza najwyżej połowę kuli. Funkcja LinearRing dzieli sferę na dwa regiony. Zostaną wybrane mniejsze 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ą być krzyżowe i nie mogą współdzielić krawędzi. Wierzchołki liniowe mogą udostępniać wierzchołki.
  • Wielokąt zawiera swoje wierzchołki.

Porada

  • Użycie wielokąta literału lub wielopolygonu może spowodować lepszą wydajność.

Przykłady

Poniższy przykład oblicza przecięcie między dwoma wielokątami. W tym przypadku wynikiem jest wielokąt.

Uruchamianie zapytania

let polygon1 = dynamic({"type":"Polygon","coordinates":[[[-73.9630937576294,40.77498840732385],[-73.963565826416,40.774383111780914],[-73.96205306053162,40.773745311181585],[-73.96160781383514,40.7743912365898],[-73.9630937576294,40.77498840732385]]]});
let polygon2 = dynamic({"type":"Polygon","coordinates":[[[-73.96213352680206,40.775045280447145],[-73.9631313085556,40.774578106920345],[-73.96207988262177,40.77416780398293],[-73.96213352680206,40.775045280447145]]]});
print intersection = geo_intersection_2polygons(polygon1, polygon2)

Dane wyjściowe

Przecięcia
{"type": "Polygon", "coordinates": [[[-73.962105776437156,40.774591360999679],[-73.962642403166868,40.774807020251778],[-73.9631313085556,40.774578106920352],[-73.962079882621765,40.774167803982927],[-73.962105776437156,40.774591360999679]]]}

Poniższy przykład oblicza przecięcie między dwoma wielokątami. W tym przypadku wynik jest punktem.

Uruchamianie zapytania

let polygon1 = dynamic({"type":"Polygon","coordinates":[[[2,45],[0,45],[1,44],[2,45]]]});
let polygon2 = dynamic({"type":"Polygon","coordinates":[[[3,44],[2,45],[2,43],[3,44]]]});
print intersection = geo_intersection_2polygons(polygon1, polygon2)

Dane wyjściowe

Przecięcia
{"type": "Point","coordinates": [2,45]}

Następujące dwa wielokąty są kolekcją.

Uruchamianie zapytania

let polygon1 = dynamic({"type":"Polygon","coordinates":[[[2,45],[0,45],[1,44],[2,45]]]});
let polygon2 = dynamic({"type":"MultiPolygon","coordinates":[[[[3,44],[2,45],[2,43],[3,44]]],[[[1.192,45.265],[1.005,44.943],[1.356,44.937],[1.192,45.265]]]]});
print intersection = geo_intersection_2polygons(polygon1, polygon2)

Dane wyjściowe

Przecięcia
{"type": "GeometryCollection","geometrie": [
{ "type": "Point", "coordinates": [2, 45]},
{ "type": "Polygon", "współrzędne": [[1.3227075526410679,45.003909145068739],[1.0404565374899824,45.004356403066552],[1.005,44.943],[1.356,44.937],[1.3227075526410679,45.003909145068739]]]}]}

Poniższe dwa wielokąty nie przecinają się.

Uruchamianie zapytania

let polygon1 = dynamic({"type":"Polygon","coordinates":[[[2,45],[0,45],[1,44],[2,45]]]});
let polygon2 = dynamic({"type":"Polygon","coordinates":[[[3,44],[3,45],[2,43],[3,44]]]});
print intersection = geo_intersection_2polygons(polygon1, polygon2)

Dane wyjściowe

Przecięcia
{"type": "GeometryCollection", "geometrie": []}

Poniższy przykład znajduje wszystkie powiaty w USA, które przecinają się z obszarem zainteresowania wielokąta.

Uruchamianie zapytania

let area_of_interest = dynamic({"type":"Polygon","coordinates":[[[-73.96213352680206,40.775045280447145],[-73.9631313085556,40.774578106920345],[-73.96207988262177,40.77416780398293],[-73.96213352680206,40.775045280447145]]]});
US_Counties
| project name = features.properties.NAME, county = features.geometry
| project name, intersection = geo_intersection_2polygons(county, area_of_interest)
| where array_length(intersection.geometries) != 0

Dane wyjściowe

name Przecięcia
Nowy Jork {"type": "Polygon","coordinates": [[[-73.9621352680206, 40.775045280447145], [-73.963131308556, 40.774578106920345], [-73.96207988262177,40.77416780398293],[-73.96213352680206, 40.775045280447145]]]}

Poniższy przykład zwróci wynik o wartości null, ponieważ jeden z wielokątów jest nieprawidłowy.

Uruchamianie zapytania

let central_park_polygon = dynamic({"type":"Polygon","coordinates":[[[-73.9495,40.7969],[-73.95807266235352,40.80068603561921],[-73.98201942443848,40.76825672305777],[-73.97317886352539,40.76455136505513],[-73.9495,40.7969]]]});
let invalid_polygon = dynamic({"type":"Polygon"});
print isnull(geo_intersection_2polygons(invalid_polygon, central_park_polygon))

Dane wyjściowe

print_0
1