geo_intersection_2lines()

Calcula a interseção de duas linhas ou várias linhas.

Syntax

geo_intersection_2lines(lineString1,lineString2)

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
lineString1	dynamic	✔️	Uma linha ou várias linhas no formato GeoJSON.
lineString2	dynamic	✔️	Uma linha ou várias linhas no formato GeoJSON.

Retornos

Interseção no formato GeoJSON e de um tipo de dados dinâmico . Se LineString ou um MultiLineString forem inválidos, a consulta produzirá um resultado nulo.

Observação

• As coordenadas geoespaciais são interpretadas como representadas pelo sistema de referência de coordenadas WGS-84 .
• O datum geodético usado para medir a distância na Terra é uma esfera. As bordas de linha são geodésicas na esfera.
• Se as bordas de linha de entrada forem linhas cartesianas retas, considere usar geo_line_densify() para converter bordas planares em geodésicos.

Definição e restrições de LineString

dynamic({"type": "LineString","coordinates": [[lng_1,lat_1], [lng_2,lat_2],..., [lng_N,lat_N]]})

dynamic({"type": "MultiLineString","coordinates": [[line_1, line_2,..., line_N]]})

• A matriz de coordenadas LineString deve conter pelo menos duas entradas.
• As coordenadas [longitude, latitude] devem ser válidas quando longitude é um número real no intervalo [-180, +180] e latitude é um número real no intervalo [-90, +90].
• O comprimento da borda deve ser inferior a 180 graus. A borda mais curta entre os dois vértices será escolhida.

Dica

Use LineString literal ou MultiLineString para melhorar o desempenho.

Exemplos

O exemplo a seguir calcula a interseção entre duas linhas. Nesse caso, o resultado é um ponto.

Executar a consulta

let lineString1 = dynamic({"type":"LineString","coordinates":[[-73.978929,40.785155],[-73.980903,40.782621]]});
let lineString2 = dynamic({"type":"LineString","coordinates":[[-73.985195,40.788275],[-73.974552,40.779761]]});
print intersection = geo_intersection_2lines(lineString1, lineString2)

Saída

interseção
{"type": "Point","coordinates": [-73.979837116670978,40.783989289772165]}

O exemplo a seguir calcula a interseção entre duas linhas. Nesse caso, o resultado é uma linha.

Executar a consulta

let line = dynamic({"type":"LineString","coordinates":[[-73.978929,40.785155],[-73.980903,40.782621]]});
print intersection = geo_intersection_2lines(line, line)

Saída

interseção
{"type": "LineString","coordinates": [[ -73.978929, 40.785155],[ -73.980903, 40.782621]]}

As duas linhas a seguir não se cruzam.

Executar a consulta

let lineString1 = dynamic({"type":"LineString","coordinates":[[1, 1],[2, 2]]});
let lineString2 = dynamic({"type":"LineString","coordinates":[[3, 3],[4, 4]]});
print intersection = geo_intersection_2lines(lineString1, lineString2)

Saída

interseção
{"type": "GeometryCollection", "geometries": []}

O exemplo a seguir retornará um resultado nulo porque uma das linhas é inválida.

Executar a consulta

let lineString1 = dynamic({"type":"LineString","coordinates":[[1, 1],[2, 2]]});
let lineString2 = dynamic({"type":"LineString","coordinates":[[3, 3]]});
print invalid = isnull(geo_intersection_2lines(lineString1, lineString2))

Saída

inválido
1