geo_intersects_line_with_polygon()
Oblicza, czy linia lub wielowierszowa przecinają się wielokątem, czy wielokątem.
Składnia
geo_intersects_line_with_polygon(
Linestring,
Wielokąt)
Dowiedz się więcej o konwencjach składniowych.
Parametry
Nazwa | Typ | Wymagane | Opis |
---|---|---|---|
Linestring | dynamic |
✔️ | LineString lub MultiLineString w formacie GeoJSON. |
Wielokąt | dynamic |
✔️ | Wielokąt lub MultiPolygon w formacie GeoJSON. |
Zwraca
Wskazuje, czy linia lub wielowierszowa przecina się z wielokątem, czy wielokątem. Jeśli ciąg lineString lub multiLineString lub wielokąt lub wielokąt są nieprawidłowe, 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 mierzenia odległości na Ziemi jest sferą. Krawędzie linii są geodesics na sferze.
- Jeśli linia wejściowa lub krawędzie wielokątne są liniami kartezjańskimi, rozważ użycie geo_line_densify() lub geo_polygon_densify(), aby przekonwertować krawędzie planarne na geodesy.
Definicja i ograniczenia lineString
dynamic({"type": "LineString","współrzędne": [[lng_1,lat_1], [lng_2,lat_2], ..., [lng_N,lat_N]]})
dynamic({"type": "MultiLineString","współrzędne": [[line_1, line_2, ..., line_N]})
- Tablica współrzędnych LineString musi zawierać co najmniej dwa wpisy.
- Współrzędne [długość geograficzna, szerokość geograficzna] muszą być prawidłowe, gdzie długość geograficzna jest liczbą rzeczywistą w zakresie [-180, +180], a szerokość geograficzna jest liczbą rzeczywistą w zakresie [-90, +90].
- Długość krawędzi musi być mniejsza niż 180 stopni. Zostanie wybrana najkrótsza krawędź między dwoma wierzchołkami.
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.
- Wielokąt nie musi zawierać wierzchołków.
Porada
Aby uzyskać lepszą wydajność, użyj literału LineString lub MultiLineString.
Przykłady
Poniższy przykład sprawdza, czy literał LineString przecina się z wielokątem.
let lineString = dynamic({"type":"LineString","coordinates":[[-73.985195,40.788275],[-73.974552,40.779761]]});
let polygon = dynamic({"type":"Polygon","coordinates":[[[-73.9712905883789,40.78580561168767],[-73.98004531860352,40.775276834803655],[-73.97000312805176,40.77852663535664],[-73.9712905883789,40.78580561168767]]]});
print intersects = geo_intersects_line_with_polygon(lineString, polygon)
Dane wyjściowe
Przecina |
---|
Prawda |
Poniższy przykład znajduje wszystkie drogi w tabeli dróg GeoJSON NYC, która przecina się z obszarem zainteresowania literału wielokątnego.
let area_of_interest = dynamic({"type":"Polygon","coordinates":[[[-73.95768642425537,40.80065354924362],[-73.9582872390747,40.80089719667298],[-73.95869493484497,40.80050736035672],[-73.9580512046814,40.80019873831593],[-73.95768642425537,40.80065354924362]]]});
NY_Manhattan_Roads
| project name = features.properties.Label, road = features.geometry
| where geo_intersects_line_with_polygon(road, area_of_interest)
| project name
Dane wyjściowe
name |
---|
Central Park W |
Frederick Douglass Cir |
W 110 st |
West Dr |
Poniższy przykład znajduje wszystkie powiaty w USA, które przecinają się z obszarem zainteresowania literału LineString.
let area_of_interest = dynamic({"type":"LineString","coordinates":[[-73.97159099578857,40.794513338780895],[-73.96738529205322,40.792758888618756],[-73.96978855133057,40.789769718601505]]});
US_Counties
| project name = features.properties.NAME, county = features.geometry
| where geo_intersects_line_with_polygon(area_of_interest, county)
| project name
Dane wyjściowe
name |
---|
Nowy Jork |
Poniższy przykład zwróci wynik o wartości null, ponieważ element LineString jest nieprawidłowy.
let lineString = dynamic({"type":"LineString","coordinates":[[-73.985195,40.788275]]});
let polygon = dynamic({"type":"Polygon","coordinates":[[[-73.95768642425537,40.80065354924362],[-73.9582872390747,40.80089719667298],[-73.95869493484497,40.80050736035672],[-73.9580512046814,40.80019873831593],[-73.95768642425537,40.80065354924362]]]});
print isnull(geo_intersects_2lines(lineString, polygon))
Dane wyjściowe
print_0 |
---|
Prawda |
Poniższy przykład zwróci wynik o wartości null, ponieważ wielokąt jest nieprawidłowy.
let lineString = dynamic({"type":"LineString","coordinates":[[-73.97159099578857,40.794513338780895],[-73.96738529205322,40.792758888618756],[-73.96978855133057,40.789769718601505]]});
let polygon = dynamic({"type":"Polygon","coordinates":[]});
print isnull(geo_intersects_2lines(lineString, polygon))
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