Compartilhar via

ST_WITHIN (consulta NoSQL)

  • Artigo

APLICA-SE A: NoSQL

Retorna uma expressão booliana que indica se o objeto GeoJSON (expressão GeoJSON Point, Polygon ou LineString) especificado no primeiro argumento está dentro do objeto GeoJSON no segundo argumento.

Sintaxe

ST_WITHIN(<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 um Ponto está dentro de um Polígono.

SELECT VALUE {
    isHeadquartersWithinCampus: ST_WITHIN({
        "type": "Point",
        "coordinates": [
            -122.12824857332558,
            47.6395516675712
        ]
    }, {            
        "type": "Polygon",
        "coordinates": [ [
            [
              -122.13236581015025,
              47.64606476313813
            ],
            [
              -122.13221982500913,
              47.633757091363975
            ],
            [
              -122.11840598103835,
              47.641749416109235
            ],
            [
              -122.12061400629656,
              47.64589264786028
            ],
            [
              -122.13236581015025,
              47.64606476313813
            ]
        ] ]
    })
}

[
  {
    "isHeadquartersWithinCampus": 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.

Conteúdo relacionado