Compartilhar via


ST_INTERSECTS (consulta NoSQL)

APLICA-SE A: NoSQL

Retorna um booleano indicando se o objeto GeoJSON (Point, Polygon, MultiPolygon ou LineString) especificado no primeiro argumento intercepta o objeto GeoJSON no segundo argumento.

Sintaxe

ST_INTERSECTS(<spatial_expr_1>, <spatial_expr_2>)  

Argumentos

Descrição
spatial_expr_1 Qualquer expressão GeoJSON Point, Polygon, MultiPolygon ou LineString válida.
spatial_expr_2 Qualquer expressão GeoJSON Point, Polygon, MultiPolygon ou LineString válida.

Tipos de retorno

Retorna um valor booliano.

Exemplos

O exemplo a seguir mostra como descobrir se dois polígonos se interceptam.

SELECT VALUE {
    highWayAndCampusIntersect: ST_INTERSECTS({
        "type": "Polygon",
        "coordinates": [ [
            [
              -122.13693695285855,
              47.64996065621003
            ],
            [
              -122.1351662656516,
              47.64627863318731
            ],
            [
              -122.13488295569863,
              47.646326350048696
            ],
            [
              -122.1366182291613,
              47.650016321952904
            ],
            [
              -122.13693695285855,
              47.64996065621003
            ]
        ] ]
    }, {  
        "type": "Polygon",
        "coordinates": [ [
            [
              -122.14034847687708,
              47.6494835188378
            ],
            [
              -122.14014779899375,
              47.64625477474044
            ],
            [
              -122.13256925774829,
              47.646207057813655
            ],
            [
              -122.13254564858545,
              47.64941990019193
            ],
            [
              -122.14034847687708,
              47.6494835188378
            ]
        ] ]
    })
}
[
  {
      "highWayAndCampusIntersect": true
  }
]

Comentários

  • Essa função do sistema se beneficiará de um índice geoespacial, exceto em consultas com agregações.
  • A especificação GeoJSON requer que os pontos em um polígono sejam especificados no sentido anti-horário. Um Polígono especificado no sentido horário representa o inverso da região dentro dele.