Funções de geografia
Uma função de geografia constrói objetos geográficos, analisa dados espaciais e retorna métricas de campos espaciais. Use funções matemáticas somente com tipos de dados numéricos .
As funções de geografia são consistentes com o Open GIS Consortium, Inc. Para obter mais informações, visite http://portal.opengeospatial.org/files/?artifact_id=829 .
Objetos geográficos em fórmulas podem usar os seguintes operadores:
+ (mais)
- (menos)
= (é igual)
!= (não é igual)
ST_Area
ST_Area(object, units)
: retorna a área do objeto geográfico nas unidades especificadas (dados numéricos).
ST_Boundary
ST_Boundary(object)
: retorna os limites do objeto geográfico (objeto geográfico de polilinha indicando o limite do polígono de entrada).
ST_BoundingRectangle
ST_BoundingRectangle(object, ...)
: retorna o retângulo delimitador do objeto geográfico (objeto geográfico de polígono).
Exemplo
ST_Centroid
ST_Centroid(object)
: retorna o centroide do objeto geográfico (objeto geográfico de ponto).
ST_CentroidX
ST_CentroidX(object)
: retorna a longitude do centroide do objeto geográfico (dados numéricos).
ST_CentroidY
ST_CentroidY(object)
: retorna a latitude do centroide do objeto geográfico (dados numéricos).
ST_Combine
ST_Combine(object1, object2,...)
: combina os objetos geográficos (objeto geográfico).
Exemplo
ST_Contains
ST_Contains(object1,object2)
: retorna verdadeiro se o objeto1 contiver o objeto2 (valor booleano).
ST_ConvexHull
ST_ConvexHull(object1,...)
: retorna a envoltória convexa dos objetos geográficos (objeto geográfico).
Exemplo
ST_CreateLine
ST_CreateLine(point1, point2...)
: cria uma linha ao conectar os pontos e linhas especificados em uma sequência (objeto geográfico).
ST_CreatePoint
ST_CreatePoint(x,y)
: retorna um objeto geográfico contendo as coordenadas especificadas de longitude e latitude (objeto geográfico).
ST_CreatePolygon
ST_CreatePolygon(obj1, obj2...)
: cria um polígono ao conectar os pontos e linhas especificados em uma sequência (objeto geográfico).
ST_Cut
ST_Cut(object1,object2)
: retorna o resultado de recortar o objeto1 do objeto2 (objeto geográfico).
Exemplo
ST_Dimension
ST_Dimension(object)
: retorna a dimensão do objeto geográfico. A dimensão espacial é o número mínimo de coordenadas necessárias para especificar cada ponto que compõe o objeto geográfico (dados numéricos).
Objetos de ponto retornam um valor de 0.
Objetos de linha retornam um valor de 1.
Objetos de polígono retornam um valor de 2.
ST_Distance
ST_Distance(object1, object2, units)
: retorna a distância do objeto1 ao objeto2 nas unidades especificadas. As unidades compatíveis são milhas ("miles"), quilômetros ("kilometers"), metros ("meters") e pés ("feet") (dados numéricos).
ST_EndPoint
ST_EndPoint(object)
: retorna o último ponto do objeto geográfico (objeto geográfico de ponto).
ST_Intersection
ST_Intersection(object1, object2, ...)
: retorna a interseção dos objetos geográficos especificados (objeto geográfico).
ST_Intersects
ST_Intersects(object1, object2...)
: retorna verdadeiro se houver interseção entre os objetos geográficos (valor booleano).
ST_InverseIntersection
ST_InverseIntersection(object1, object2...)
: retorna a interseção inversa dos objetos geográficos especificados (objeto geográfico).
ST_Length
ST_Length(object, units)
: retorna o comprimento linear do objeto geográfico nas unidades especificadas (dados numéricos).
ST_MD5
ST_MD5(object)
: calcula o hash MD5 do objeto geográfico.
ST_MaxX
ST_MaxX(object)
: retorna a longitude máxima do objeto geográfico (dados numéricos).
ST_MaxY
ST_MaxY(object)
: retorna a latitude máxima do objeto geográfico (dados numéricos).
ST_MinX
ST_MinX(object)
: retorna a longitude mínima do objeto geográfico (dados numéricos).
ST_MinY
ST_MinY(object)
: retorna a latitude mínima do objeto geográfico (dados numéricos).
ST_NumParts
ST_NumParts(object)
: retorna o número de partes no objeto geográfico (dados numéricos).
ST_NumPoints
ST_NumPoints(object)
: retorna o número de pontos no objeto geográfico (dados numéricos).
ST_ObjectType
ST_ObjectType(object)
: retorna o tipo do objeto geográfico como um valor de cadeia de caracteres (dados de cadeia de caracteres).
ST_PointN
ST_PointN(object, n)
: retorna o enésimo (n) ponto do objeto geográfico (objeto geográfico de ponto).
ST_RandomPoint
ST_RandomPoint(object)
: retorna um ponto aleatório do objeto geográfico (objeto geográfico de ponto).
ST_Relate
ST_Relate(object1,object2,relation)
: retorna verdadeiro se os objetos satisfizerem a relação DE-9IM fornecida (valor booleano).
ST_StartPoint
ST_StartPoint(object)
: retorna o primeiro ponto do objeto geográfico (objeto geográfico).
ST_Touches
ST_Touches(object1, object2)
: retorna verdadeiro se o objeto1 tocar o objeto2 (valor booleano).
ST_TouchesOrIntersects
ST_TouchesOrIntersects(object1, object2)
: retorna verdadeiro se o objeto1 tocar ou interceptar o objeto2 (valor booleano).
ST_Within
ST_Within(object1, object2)
: retorna verdadeiro se o objeto1 estiver contido no objeto2 (valor booleano).