As funções descritas abaixo são as quais o usuário de PostGIS utiliza. Existem outras funções que são requeridas como suporte de funções aos objetos de PostGIS que não são de uso para um usuário comum.
Sintaxe: AddGeometryColumn(<schema_name>, <table_name>, <column_name>, <srid>, <type>, <dimension>). Acrescenta uma coluna geométrica a uma tabela existente de atributos. O dbname é o nome do exemplo de banco de dados. O srid devem ser uma referência de valor inteiro a uma entrada dentro da tabela SPATIAL_REF_SYS. O tipo deve ser uma string maiúscula que corresponde ao tipo de geometria , eg, ' POLÍGONO' ou ' MULTILINESTRING '.
Sintaxe: DropGeometryColumn(<schema_name>, <table_name>, <column_name>). Remove uma coluna geométrica de uma tabela espacial. Note que o schema_name necessitará combinar o campo do f_schema_name da linha da tabela na tabela dos geometry_columns.
Atribui o SRID em uma geometria para um valor de inteiro particular. É utilizado na construção de caixas de salto para "queries".
Retorna a distancia cartesiana entre duas geometrias em unidades projetadas.
Retorna1 (VERDADEIRO) se esta geometria é que
"spatially equal" (espacialmente iguais) a uma outra geometria. Use ' =
' para uma melhor resposta .
equals (' LINESTRING(0 0, 10 10) ', ' LINESTRING(0 0, 5 5, 10 10) ')
é verdade.
Executado pelo módulo de GEOS
OGC SPECs2.1.1.2
Retorna 1 (VERDADEIRO) se esta Geometria é que
"spatially disjoint" (desloca espacialmente) de outra geometria.
Executado pelo módulo de GEOS
Não chame "GeometryCollection" como um argumento
NOTA: esta é a versão "allowable"
(permissível) que retorna uma boolean
(condição verdadeira ou falsa), e não
um inteiro.
OGC SPEC s2.1.1.2 / / s2.1.13.3 - a.Relate(b, ' FF*FF * * * * ')
Retorna 1 (VERDADEIRO) se esta geometria "spatially
intersects" (cruza espacialmente) outra geometria.
Executado pelo módulo de GEOS
Não chame GeometryCollection como um argumento
NOTA: esta é a versão "allowable"
(permissível) que retorna uma boolean
(condição verdadeira ou falsa), e não
um inteiro.
OGC SPEC s2.1.1.2 / / s2.1.13.3 - Intersects(g1, g2)-Not (Disjoint(g1,
g2))
Retorna 1 (VERDADEIRO) se esta geometria "spatially
touches" (toca espacialmente) de outra geometria.
Executado pelo módulo de GEOS
Não chame GeometryCollection como um argumento
NOTA: esta é a versão "allowable"
(permissível) que retorna uma boolean
(condição verdadeira ou falsa), e não
um inteiro.
OGC SPEC s2.1.1.2 / / s2.1.13.3 - a.Touches(b) - (I(a) intersection
I(b) = {empty set}) e (a intersection b) não vazio
Retorna 1 (VERDADEIRO) se esta geometria "spatially
crosses" de outras geometrias.
Executado pelo módulo de GEOS
Não chame GeometryCollection como um argumento
NOTA: esta é a versão "allowable"
(permissível) que retorna uma boolean
(condição verdadeira ou falsa), e não
um inteiro.
OGC SPEC s2.1.1.2 / / s2.1.13.3 - a.Relate(b, ' T*T * * * * * * ')
Retorna 1 (VERDADEIRO) se a geometria A
é "spatially within" a geometria B.
Executado pelo módulo de GEOS
Não chame GeometryCollection como um argumento
NOTA: esta é a versão "allowable"
(permissível) que retorna uma boolean, e não um
inteiro.
OGC SPEC s2.1.1.2 / / s2.1.13.3 - a.Relate(b, ' T*F**F * * * ')
Retorna 1 (VERDADEIRO) se Geometria é
"spatially overlaps" (sobrepõe espacialmente).
Executado pelo módulo de GEOS
Não chame GeometryCollection como um argumento
NOTA: esta é a versão "allowable"
(permissível) que retorna uma boolean, e não um
inteiro.
OGC SPEC s2.1.1.2 / / s2.1.13.3
Retorna 1 (VERDADEIRO) se a geometria
A "spatially contains" (contem espacialmente) a geometria B.
Executado pelo módulo de GEOS
Não chame GeometryCollection como um argumento
NOTA: esta é a versão "allowable"
(permissível) que retorna uma boolean, e não um
inteiro.
OGC SPEC s2.1.1.2 / / s2.1.13.3 - mesmo como within(geometry,geometry)
Retorna 1 (VERDADEIRO) se a geometria é
"spatially intersects".
Executado pelo módulo de GEOS
Não chame GeometryCollection como um argumento
NOTA: esta é a versão "allowable"
(permissível) que retorna uma boolean, e não um
inteiro.
OGC SPEC s2.1.1.2 / / s2.1.13.3 - NOT disjoint(geometry,geometry)
Retorna 1 (VERDADEIRO) se esta geometria é
espacialmente
relatada para outra geometria, testando
interesecção
entre o interior, o limite e o exterior de duas geometrias como
especificado pelos valores em umaintersectionPatternMatrix.
Executado pelo módulo de GEOS
Não chame GeometryCollection como um argumento
NOTA: esta é a versão "allowable"
(permissível) que retorna uma boolean, e não um
inteiro.
OGC SPEC s2.1.1.2 / / s2.1.13.3 - NOT disjoint(geometry,geometry)
Retorna o DE-9IM (dimensionally extended nine-intersection
matrix)
Executado pelo módulo de GEOS
Não chame GeometryCollection como um argumento
Não em especificação OGC, mas
sub-entendido. veja s2.1.13.2
Retorna o identificador de centro da geometria como um
ponto.
Computação será mais precisa que se
executado pelo módulo de GEOS (ocorreu em tempo de
compilação).
Retorna a área da geometria, se é um polígono ou multi-polígono.
O comprimento desta curva em sua referência
espacial associada.
sinônimo para length2d ()
OGC SPEC 2.1.5.1
Retorna um ponto garantido estar na superfície
Implementado usando GEOS
OGC SPEC 3.2.14.2 e 3.2.18.2 -
Retorna o fechamento do limite combinatorial desta
geometria. O limite combinatorial é definido como descrito
na seção 3.12.3.2 da OGC SPEC. Porque o resultado
desta função é um fechamento, e
conseqüentemente fecharam topologicamente, o limite resultante
pode ser representado usando representação de
primitivas geométricas como discutido na OGC SPEC,
seção 3.12.2.
Executado pelo módulo de GEOS
OGC SPEC s2.1.1.1
Retorna uma geometria que represente todos os pontos que
distanciam desta geometria é menor ou igual a distancia.
Cálculos estão em um Spacial Reference System
desta
geometria. O terceiro parametro opcional atribui o
número
de segmentos usados para aproximar um quarto de círculo
(padrão para 8).
Executado pelo módulo de GEOS
Não chame GeometryCollection como um argumento
OGC SPEC s2.1.1.3
Retorna uma geometria que representa a casca convexa desta
geometria.
Executado pelo módulo de GEOS
OGC SPECs2.1.1.3
Retorna uma geometria que representa a
interseção atribuída do ponto das
Geometrias.
Executado pelo módulo de GEOS
Não chame GeometryCollection como um argumento
OGC SPEC s2.1.1.3
Retorna uma geometria que representa a
diferença
simétrica atribuída do ponto da geometria A
com geometria B.
Executado pelo módulo de GEOS
Não chame GeometryCollection como um argumento
OGC SPEC s2.1.1.3
Retorna uma geometria que representa a
diferença atribuída do ponto da
geometria A com geometria B.
Executado pelo módulo de GEOS
Não chame GeometryCollection como um argumento
OGC SPEC s2.1.1.3
Retorna uma geometria que representa a união
atribuída do ponto das geometrias.
Executado pelo módulo de GEOS
Não chame GeometryCollection como um argumento
NOTA: este é renomeado de "union" porque união
é uma palavra reservada SQL
OGC SPEC s2.1.1.3
Retorna uma geometria que representa a união
atribuída do ponto de todas as geometrias em dado
conjunto.
Executado pelo módulo de GEOS
Não chame GeometryCollection no conjunto de
argumento
Nada definido em OGC SPEC
Mesmo que o anterior, só que com "memory-friendly" (memória-amigável - usa menos memória e mais tempo de processamento)
Retorna a representação de
Well-Known Text (WKT) da geometria. Por exemplo: POLYGON(0 0,0 1,1 1,1
0,0 0)
OGC SPEC s2.1.1.1
Retorna a geometria no OGC formato
"well-known-bynary", usando a
codificação endian do
usuário em que o banco de dados está
funcionando.
É utilizado em cursores binários para extrair
dados do
banco de dados sem convertê-la a uma
representação
string.
OGC SPEC s2.1.1.1 - also see asBinary(<geometry>,'XDR')
and asBinary(<geometry>,'NDR')
Retornos de números inteiros SRID do sistema de
referência espacial da geometria.
OGC SPEC s2.1.1.1
A dimensão inerente deste objeto de geometria, que deve ser menor ou igual à dimensão coordenada. OGC SPEC s2.1.1.1 - retorna 0 para pontos, 1 para linhas, 2 para polígonos, e a maior dimensão dos componentes de um GEOMETRYCOLLECTION.
select dimension('GEOMETRYCOLLECTION(LINESTRING(1 1,0 0),POINT(0 0)');
|
Retorna um polígono representando a caixa
delimitada da geometria.
OGC SPEC s2.1.1.1 - A caixa delimitada mínima para esta
geometria, retornou como uma geometria. O polígono
está definido por pontos de curva da caixa delimitada
((MINX, MINY), (MAXX, MINY), (MAXX, MAXY), (MINX, MAXY), (MINX, MINY)).
NOTA:PostGIS acrescentará uma coordenada de Zmin/Zmax
também.
Retorna 1 (VERDADEIRO) se esta geometria
é a
geometria vazia. Se for verdade, então esta geometria
representa
o conjunto de ponto vazio-i.e.GEOMETRYCOLLECTION (EMPTY).
OGC SPEC s2.1.1.1
Retorna 1 (VERDADEIRO) se esta geometria não
tem nenhum ponto geométrico anômalo, como
intersecção própria ou
tangência própria.
Executado pelo módulo de GEOS
OGC SPECs2.1.1.1
Retornos verdadeiros do começo de geometria e pontos finais são coincidentes.
Retorna 1 (VERDADEIRO) se esta Curva está
fechada (StartPoint () = EndPoint ()) e esta Curva é simples
(não atravesse o mesmo ponto mais de uma vez).
Executado por GEOS
OGC spec 2.1.5.1
Se geometria é um GEOMETRYCOLLECTION (ou MULTI *) retorna o número de geometrias. Caso contrário, retorna NULO.
Retorna a enésima geometria se a geometria
é uma GEOMETRYCOLLECTION, MULTIPOINT, MULTILINESTRING ou
MULTIPOLYGON. Caso contrário, retorna NULO.
Indice é 1-based como para especificações OGC desde a versão 0.8.0. As versões anteriores executaram esta como 0-based preferivelmente.
Encontra e Retorna o número de pontos na primeira linha na geometria. Retorna NULO se não há nenhuma linha na geometria.
Retorna o enésimo ponto na primeira linha na geometria. Retorna NULO se não há nenhuma linha na geometria.
Retorna o anel exterior do primeiro polígono na geometria. Retorna NULO se não há nenhum polígono na geometria.
Retorna o número de anéis interiores do primeiro polígono na geometria. Retorna NULO se não há nenhum polígono na geometria.
Retorna o enésimo anel interior do polígono na geometria. Retorna NULO se não há nenhum polígono na geometria ou o N dado é fora da escala(1 baseado).
Indice is 1-based como especificações para OGC desde a versão 0.8.0. As versões anteriores implementaram esta como 0-based preferivelmente.
Retorna o último ponto da geometria de "LineString" como um ponto.
Retorna o primeiro ponto da geometria de "LineString" como um ponto.
Retorna o tipo da geometria como uma string. Eg:
' LINESTRING ', ' POLYGON ', ' MULTIPOINT ', etc.
OGC SPEC s2.1.1.1 - Retorna o nome do sub-tipo imediato de geometria de
qual neste caso de geometria é um membro. O nome do sub-tipo
imediato de geometria é devolvido como uma string.
Encontra e retorna a coordenada de X do primeiro ponto na geometria. Retorna NULO se não há nenhum ponto na geometria.
Encontra e retorna a coordenada de Y do primeiro ponto na geometria. Retorna NULO se não há nenhum ponto na geometria.
Encontra e retorna a coordenada de Z do primeiro ponto na geometria. Retorna NULO se não há nenhum ponto na geometria.
Retorna uma coordenada M do ponto, ou NULO se não disponível. A entrada deve ser um ponto.
This is not (yet) part of the OGC spec, but is listed here to complete the point coordinate extractor function list.
Converte uma geometria de WKT com o dado SRID.
OGC SPEC 3.2.6.2 - a opção SRID está
de conformidade.
Faz uma geometria de WKT com o dado SRID. Caso SRID
não der, padroniza-se -1.
OGC SPEC 3.2.6.2 - opção SRID está de
conformidade.
Mostra um erro se o WKT não é um Ponto
Faz uma geometria de WKT com o dado SRID. Caso SRID
não der, padroniza-se -1.
OGC SPEC 3.2.6.2 - opção SRID está de
conformidade.
Mostra um erro se o WKT não é uma Linha
Faz uma geometria de WKT com o dado SRID. Caso SRID
não der, padroniza-se -1.
OGC SPEC 3.2.6.2 - opção SRID está de
conformidade.
Mostra um erro se o WKT não é uma Linha
Faz uma Geometria de WKT com o SRID dado . Caso SRID
não der, padroniza-se -1.
OGC SPEC 3.2.6.2 - opção SRID está de
conformidade.
Mostra um erro se o WKT não é um
Polígono
Faz uma geometria de WKT com o SRID dado. Caso
SRID não der, padroniza-se -1.
OGC SPEC 3.2.6.2 - opção SRID está de
conformidade.
Mostra um erro se o WKT não é um
Polígono
Faz uma geometria de WKT com o SRID dado. Caso
SRID não der, padroniza-se -1.
OGC SPEC 3.2.6.2 - opção SRID está de
conformidade.
Mostra um erro se o WKT não é um MULTIPOINT
Faz uma geometria de WKT com o SRID dado. Caso
SRID não der, padroniza-se -1.
OGC SPEC 3.2.6.2 - opção SRID está de
conformidade.
Mostra um erro se o WKT não é um MULTILINESTRING
Faz uma Geometria de WKT com o SRID dado. Caso
SRID não der, padroniza-se -1.
OGC SPEC 3.2.6.2 - opção SRID está de
conformidade.
Mostra um erro se o WKT não é um MULTIPOLYGON
Faz uma geometria de WKT com o SRID dado. Caso
SRID não der, padroniza-se -1.
OGC SPEC 3.2.6.2 - opção SRID está de
conformidade.
Mostra um erro se o WKT não é um
GEOMETRYCOLLECTION
Faz uma geometria de WKB com o SRID dado. Caso
SRID não der,
padroniza-se -1.
OGC SPEC 3.2.6.2 - opção SRID está de
conformidade.
Faz uma geometria de WKB com o SRID dado. Caso
SRID não der,
padroniza-se -1.
OGC SPEC 3.2.6.2 - opção SRID está de
conformidade.
Faz uma geometria de WKB com o SRID dado. Caso
SRID não der,
padroniza-se -1.
OGC SPEC 3.2.6.2 - opção SRID está de
conformidade.
Mostra um erro se o WKT não é um PONTO
Faz uma geometria de WKB com o SRID dado. Caso
SRID não der, padroniza-se -1.
OGC SPEC 3.2.6.2 - opção SRID está de
conformidade.
Mostra um erro se o WKT não é um LINESTRING
Faz uma geometria de WKB com o SRID dado. Caso
SRID não der, padroniza-se -1.
OGC SPEC 3.2.6.2 - opção SRID está de
conformidade.
Mostra um erro se o WKT não é um LINESTRING
Faz uma geometria de WKB com o SRID dado. Caso
SRID não der, padroniza-se -1.
OGC SPEC 3.2.6.2 - opção SRID está de
conformidade.
Mostra um erro se o WKT não é um
POLÍGONO
Faz uma geometria de WKB com o SRID dado. Caso
SRID não der, padroniza-se -1.
OGC SPEC 3.2.6.2 - opção SRID está de
conformidade.
Faz uma geometria de WKB com o SRID dado. Caso
SRID não der, padroniza-se -1.
OGC SPEC 3.2.6.2 - opção SRID está de
conformidade.
Mostra um erro se o WKT não é um MULTIPOINT
Faz uma geometria de WKB com o SRID dado. Caso
SRID não der, padroniza-se -1.
OGC SPEC 3.2.6.2 - opção SRID está de
conformidade.
Mostra um erro se o WKT não é um MULTILINESTRING
Faz uma Geometria de WKB com o SRID dado. Caso
SRID não der, padroniza-se -1.
OGC SPEC 3.2.6.2 - opção SRID está de
conformidade.
Mostra um erro se o WKT não é um MULTIPOLYGON
Faz uma Geometria de WKB com o SRID dado. Caso
SRID não der, padroniza-se -1.
OGC SPEC 3.2.6.2 - opção SRID está de
conformidade.
Mostra um erro se o WKT não é um
GEOMETRYCOLLECTION
Construir um Polygon dada uma
coleção arbitrária de linhas fechadas
como uma representação do
texto MultiLineString. Lança um erro se
WKT não for um MULTILINESTRING. Lança um erro se
a saída for um
MULTIPOLYGON; usa BdMPolyFromText
neste caso ou vê BuildArea()
para
um acesso específico de postgis.
OGC SFSQL 1.1 - 3.2.6.2
Disponibilidade: 1.1.0 - requer GEOS >= 2.1.0.
Construir um MultiPolygon dada uma
coleção
arbitrária de linha fechada como uma
respresentação do texto de MultiLineString.
Lança
um
erro se WKT não for um MULTILINESTRING. Força
saída MULTIPOLYGON mesmo quando o resultado
é
composto somente por um único
POLYGON; usa BdPolyFromText
se você estiver certo que um único POLYGON
resultará da operação ou veja BuildArea() para
um acesso específico de postgis.
OGC SFSQL 1.1 - 3.2.6.2
Disponibilidade: 1.1.0 - requer GEOS >= 2.1.0.
Destrói uma tabela e todas suas referências nas colunas geométricas. Nota: usa o current_schema() em instalações do pgsql schema-aware se o schema não for fornecido.
Atualiza o SRID de todas as características em uma coluna da geometria que atualiza confinamente e referência nas colunas geométricas. Nota: usa o current_schema() em instalações do pgsql schema-aware se o schema não for fornecido.
Atualiza estatisticas sobre tabelas espaciais para o uso pelo operador da seleção. Precisará também rodar o "VACUUM ANALYZE [ table_name ] [ column_name ]" para as estatisticas que recolhem o processo para estar completo. Nota: começando com PostgreSQL 8.0 que analisando estatisticas é automaticamente executado rodando "VACUUM ANALYZE".
Retorna o número de versão de PostGIS e opções de tempo de compilação. Nota: Antes da versão 1.1.0 esta era uma função procedural, assim possivelmente não estará retornando a informação exata (em caso dos melhoramentos incompletos do banco de dados).
Retorna o número de versão da
biblioteca de PostGIS.
Disponível: 0.9.0
Retorna data da construção da
biblioteca PostGIS.
Disponível: 1.0.0RC1
Retorna data da construção
de scripts PostGIS.
Disponível: 1.0.0RC1
Retorna a versão do script postgis
instalado neste banco de dados. Nota: Se a
saída desta função não
combinasse com a saída de postgis_scripts_released()
provavelmente faltou promover
corretamente um banco de dados existente. Veja a
seção Upgrading para
mais informações.
Disponibilidade: 0.9.0
Retorna o número da versão
do script
de lwpostgis.sql
liberado com o instalado na biblioteca do postgis. Nota: Começar
com versão 1.1.0 esta função, retorna
o mesmo valor do postgis_lib_version().
Conservar para a compatibilidade inversa.
Disponível: 0.9.0
Retorna o número da versão da
biblioteca de GEOS ou NULO se o suporte a GEOS não
for permitida.
Disponível: 0.9.0
Retorna o número da versão da
biblioteca PROJ4 ou NULo se o suporte a PROJ4 não for
permitida.
Disponível: 0.9.0
Retorna verdadeiro se o uso do STATS for permitido,caso
contrário retorna falso.
Disponível: 0.9.0
Retorna a versão postgis completa e
constrói informações de
configuração.
Disponível: 0.9.0
O operador "&<" retorna verdadeiro se a caixa delimitada sobrepor o próprio A ou está à esquerda da caixa delimitada do próprio B.
O operador "&>" retorna verdadeiro se a caixa delimitada sobrepor o próprio A ou está à direita da caixa delimitada do próprio B.
O operador "<<" retorna verdadeiro se a caixa delimitada for estritamente à esquerda da caixa delimitada do próprio B.
O operador ">>" retorna verdadeiro se o salto de caixa do próprio A for estritamente à direita do salto de caixa do próprio B.
O operador "&<|" returna verdadeiro se a caixa delimitada do próprio A for abaixo da caixa delimitada do próprio B.
O operador "|&>" returna verdadeiro se a caixa delimitada de A for acima da caixa delimitada do próprio B.
O operador "<<|" retorna verdadeiro se a caixa delimitada de A for estritamente abaixo da caixa delimitada do próprio B.
O operador "|>>" retorna verdadeiro se a caixa delimitada A for esttritamente acima da caixa delimitada do próprio B.
O operador "~ = " é o operador "same as". Testa igualdade geométrica atual de duas características. Assim, se A e B são de mesma característica, o operador retorna verdadeiro.
O operador "@ " retorna verdadeiro se a caixa delimitada do próprio A estiver completamente contido na caixa delimitada do próprio B.
O operador "~" retorna verdadeiro se a caixa delimitada estiver completamente contida na caixa delimitada do próprio B.
O operador "&& " é o operador sobreposto. Se a caixa delimitada do prórpio A sobrepor a caixa delimitada do próprio B, o operador retorna verdadeiro.
Retorna a área da geometria, se é um polígono ou multi-polígono.
Retorna a distância linear nos medidores entre dois pontos de lat/lon. Usa uma terra e um raio esféricos de 6370986 medidores. Mais rapidamente do que distance_spheroid(), mas menos exato. Atualmente só se implementou para pontos.
Retorna a distância linear entre dois pontos latitude/longitude dando um esferóide particular. Veja a explicação de esferóides dados para length_spheroid(). Atualmente só se implementou para pontos.
Retorna o comprimento 2-dimensional da geometria se é um linestring ou multi-linestring.
Retorna o comprimento 3-dimensional da geometria se é um linestring ou multi-linestring.
Calcula o comprimento de uma geometria em um ellipsoid. É utilizada se as coordenadas da geometria está em latitude/longitude e um comprimento é desejado sem reprojecções O ellipsoid é um tipo de banco de dados separado e pode ser construído como segue:
SPHEROID[<NAME>,<SEMI-MAJOR AXIS>,<INVERSE FLATTENING>]
Outra forma:
SPHEROID["GRS_1980",6378137,298.257222101]
Um exemplo de cálculo poderia ser:
SELECT length_spheroid(
geometry_column,
'SPHEROID["GRS_1980",6378137,298.257222101]'
)
FROM geometry_table;
Calcula o comprimento de uma geometria em um ellipsoid, pegando a elevação dentro da conta. É exatamente igual a length_spheroid excluindo as coordenadas verticais (expressado nas mesmas unidades como os spheroid axes) são usados para calcular a soma de deslocamento da distância extra vertical.
Retorna a distância menor entre duas geometrias..
Retorna a distância maior entre duas linhas de string.
Retorna o perímetro da geometria, se é um polígono ou multi-polígono.
Retorna o perímetro 2-dimensional da geometria, se é um polígono ou multi-polígono.
Retorna o perímetro 3-dimensional da geometria, se é um polígono ou multi-polígono.
Retorna a geometria no formato OGC "well-known-bynary", usando "little-endian" (NDR) ou big-endian (XDR) . É utilizado em cursores binários para extrair dados do banco de dados sem convertê-la a uma representação string.
Retorna uma Geometria em formato EWKT (como texto).
Retorna uma geometria em formato EWKB (como o "bytea") usando outra codificação "little-endian" (NDR) ou "big-endian".
Retorna a geometria como um dado do trajeto de SVG. Usa 1 como segundo argumento e tem o trajeto dos dados implementados nos termos de movimentos relativos, o default (ou 0) usa movimentos absolutos. O terceiro argumento pode ser usado para reduzir o número máximo dos dígitos decimais usados na saída ("default" para 15). Pontos de geometrias serão rendidos como cx/cy quando arg 'rel' é 0, x/y quando 'rel' é 1.
Retorna a geometria como um elemento GML. O segundo argumento pode ser usado para reduzir o número máximo dos dígitos significativos usados na saída (defaults para 15).
Retorna a geometria como um elemento KML. O segundo argumento pode ser usado para reduzir o número máximo de dígitos significativos usados na saída ( defaults para 15).
Faz a geometria de EWKT.
Faz a geometria de EWKB.
Cria um ponto 2d,3dz or 4d geométrico.
Cria um ponto 3dm geométrico.
Cria um BOX2D definido dados os pontos geométricos.
Cria um BOX3D definido dados os pontos geométricos.
Cria um Linestring de um conjunto de pontos de geometrias. Poderá usar um subselect para ordenar os pontos antes de alimentá-los a este agregado.
Cria um Linestring dados dois pontos geométricos.
Cria um LineString de uma geometria MultiPoint.
Cria um polígono formado pela proteção dada e pelo conjunto de regras. Poderá construir um conjunto de geometria usando Accum. Entradas geométricas devem ser LINESTRINGS fechadas (veja IsClosed e GeometryType).
Agregado. Cria um GeometryCollection que contem os
polígonos possíveis formados de
componentes de linhas de trabalho de um conjunto de
geometrias.
Disponível 1.0.0RC1 - requer GEOS >= 2.1.0.
Esta função retorna um GEOMETRYCOLLECTION ou um objeto MULTI de um conjunto de geometrias. A função collect() é uma função "agregada" na terminologia de PostgreSQL. Isso significa que operadores em listas de dados, na mesma maneira de funções de sum() e de mean(). Para o exemplo, "SELECT COLLECT(GEOM) FROM GEOMTABLE GROUP BY ATTRCOLUMN" retornará um GEOMETRYCOLLECTION separado para cada valor distinto de ATTRCOLUMN.
Esta função retorna uma geometria, sendo uma coleção de duas saídas geométricas. O tipo de saída pode ser um MULTI* ou um GEOMETRYCOLLECTION.
Esta é uma função de um conjunto de retornos (set-returning function-SRF). Retorna um conjunto de linhas geometry_dump, formada por uma geometria (geom) e por um conjunto de inteiros (path). Quando a entrada geometrica é um tipo simples (POINT,LINESTRING,POLYGON) um único registro será retornado com um conjunto de caminhos vazios e a entrada geométrica como geom. Quando a entrada geométrica é uma coleção ou multi retornará um registro para cada um dos componentes da coleção, e o caminho expressará a posição do componente dentro da coleção.
Disponibilidade: PostGIS 1.0.0RC1. Requer PostgreSQL 7.3 ou superiores.
Esta é uma função de um conjunto de retornos (set-returning function-SRF). Retorna um conjunto de linhas geometry_dump, formado por uma geometria (geom) e por uma conjunto de inteiros (path). O campo “path” carrega o índice do anel do polígono, contem um único elemento: 0 para o escudo, número do furo para regras. O campo do “geom” contem o anel correspondente como um polígono.
Disponibilidade: PostGIS 1.1.3. Requer PostgreSQL 7.3 ou superiores.
Adiciona caixa delimitada à geometria. Isto fará na caixa delimitada baseada em seleções mais rápidas, mas aumentará o tamanho da geometria.
Destrói a caixa delimitada da geometria. Isto reduz o tamanho da geometria, mas as caixa delimitada baseada em seleções mais lentas.
Adiciona um ponto a um LineString na posição <pos> (índice 0-based). O terceiro parâmetro pode ser omitido ou ajustado a -1.
Remove ponto de uma linestring. Offset é 0-based.
Disponível: 1.1.0
Replace point N of linestring with given point. Index is 0-based.
Substitue o ponto N de linestring com o ponto dado. O índice é 0-based.
Disponível: 1.1.0
Converte a geometria em um GEOMETRYCOLLECTION. É utilizado para simplificar a respresentação de WKB.
Força as geometrias dentro de um "2-dimensional mode" (modo bi-dimensional) de forma que todas as representações de saída só terão as coordenadas X e Y. É utilizado para forçar a saída OGC-compliant (desde que OGC especifica somente geometrias 2-D).
Força as geometrias dentro de um modo XYZ.
Força as geometrias dentro de um modo XYM.
Força as geometrias dentro de um modo XYZM.
Retorna a geometria como uma geometria MULTI*. Se a geometria já é uma MULTI*, esta retornará inalterada.
Retorna uma nova geometria com suas coordenadas transformadas ao SRID referenciado pelo parâmetro inteiro. O destino SRID tem que existir na tabela SPATIAL_REF_SYS.
Aplica uma trasformação 3d affine para a geometria. A chamada
Affine(geom, a, b, c, d, e, f, g, h, i,
xoff, yoff, zoff)
representa a matriz da transformação
/ a b c xoff \ | d e f
yoff | | g h i zoff | \ 0 0 0 1 /
x' = a*x + b*y + c*z + xoff y' = d*x +
e*y + f*z + yoff z' = g*x + h*y + i*z + zoff
Todas funções de tradução / escala abaixo são expressados através de uma transformação affine.
Disponível: 1.1.2.
Aplica uma transformação 2d affine para a geometria. A chamada
Affine(geom, a, b, d, e, xoff, yoff)
representa a matriz da transformação
/ a b 0 xoff \ / a b xoff \ | d e 0 yoff | rsp.
| d e yoff | | 0 0 1 0 | \ 0 0 1 / \ 0 0 0 1 /
e os vertices são transformados como segue:
x' = a*x + b*y + xoff y' = d*x + e*y +
yoff z' = z
Este método é um subcaso do método 3D acima.
Disponível: 1.1.2.
Traduz a geometria a um novo local que usa os parâmetros numéricos como recompensa. Isto é: translate(geom,X,Y,Z).
Escala a geometria a um novo tamanho, multiplicando as ordenadas com os parâmetros. Isto é: scale (geom, Xfactor, Yfactor, Zfactor).
Disponível: 1.1.0
Gira a geometria em torno da linha central de Z, X ou Y por dado ângulo dado nos radianos. Seguir a regra right-hand.
Disponível: 1.1.2.
First, translates the geometry using the first two floats, then scales it using the second two floats, working in 2D only. Using transscale(geom, X, Y, XFactor, YFactor) internally calls affine(geom, XFactor, 0, 0, 0, YFactor, 0, 0, 0, 1, X*XFactor, Y*YFactor, 0).
Primeiro, traduz a geometria usando os primeiros dois floats, a seguir escala-o, usando os segundos dois floats, trabalhando somente em 2D. Usando transscale(geom, X, Y, XFactor, YFactor) internamente chama affine(geom, XFactor, 0, 0, 0, YFactor, 0, 0, 0, 1, X*XFactor, Y*YFactor, 0).
Disponível: 1.1.0.
Retorna a geometria com a ordem do vértice invertida.
Força polígono da coleção a obedecer Right-Hand-Rule.
Retorna uma versão "simplified" da geometria dada usando o algoritmo de Douglas-Peuker. Desta forma, fará realmente algo com (multi)linhas e (multi)polígonos, mas você pode estar seguro de chama-lo com qualquer tipo da geometria. Desde que a simplificação ocorra em uma base "object-by-object" e você pode também alimentar um GeometryCollection a esta função. Note que a geometria retornada pode perder sua simplicidade. (veja IsSimple)
Pega todos os pontos de entrada da geometria à definição de grade por seu tamanho de origem e de célula. Remove os pontos consecutivos que caem na mesma célula, retornando eventualmente o NULO, se os pontos da saída não forem bastante para definir uma geometria do tipo dado. As geometrias derrubadas em uma coleção são desfeitas dela.
A geometria retornada pode perder sua simplicidade (veja IsSimple).
Antes da liberação 1.1.0
esta
função retornou sempre uma geometria 2d .
Começando por 1.1.0 a geometria retornada terá
mesmo
dimensionalidade
que
a entrada, uma com dimensão mais elevada valor
não tocado. Usar a versão
pegando um segundo argumento de
geometria
para definir todas
as dimensões da grade.
Disponível: 1.0.0RC1
Pega todos os pontos de entrada da geometria a definição de grade por seu tamanho de origem (o segundo argumento, deve ser um ponto) e por seu tamanho de célula. Especificar 0 como tamanho para alguma dimensão que você não quiser pegar para uma grade.
Disponível: 1.1.0
Retorna uma geometria modificada que não tem nenhum segmento mais por muito tempo então à distância dada. Os pontos interpolados terão os valores de Z e de M (se necessário) ajustados a 0. A computação da distância é executada em somente em 2d.
Retorna um (ou conjunto) LineString(s) formado por unindo a linha de trabalho (linework) constituinte da entrada.
Disponível: 1.1.0 - requer GEOS >= 2.1.0
Retorna um ponto interpolado ao longo de uma linha. O
primeiro
argumento deve ser um LINESTRING.
O segundo argumento é um float8 entre
0 e 1 representando fração do
total 2d
length o ponto tem
que ser encontrado.
Veja line_locate_point()
para computar a posição da linha o mais
próximo a um Point.
Desde a liberação 1.1.1 esta função tambem interpola valores M e Z (quando presente), quando que as liberações anteriores ajustam-nas para 0.0.
Disponível: 0.8.2
Retorna um linestring sendo um substring da entrada uma que começa e que termina nas frações do total 2d length. Os segundo e terceiro argumentos são os valores float8 entre 0 e 1.
Se o 'start' e 'end' tiverem o mesmo valor, este é equivalente ao line_interpolate_point().
Veja line_locate_point() para computar a posição da linha o mais próximo a um ponto.
Desde a liberação 1.1.1 esta função também interpola valores M e Z (quando presente), quando que as liberações anteriores ajustam-nas aos valores não especificados.
Disponível: 1.1.0
Retorna um valor derivado da coleção
da geometria com elementos que
combinam a escala especificada das medidas inclusive. Os elementos Polygonal
não são suportados.
Semântica é especificado por: ISO/IEC CD
13249-3:200x(E) - Text for Continuation CD Editing Meeting
Disponível: 1.1.0
Retorna um resumo de texto dos conteúdos da geometria.
Retorna um BOX2D representando as extensões máximas da geometria.
Retorna um BOX3D representando as extensões máximas da geometria.
A função extent() é uma
função "aggregate" (agregada) na terminologia de
PostgreSQL. Isso significa que os operadores em listas de dados, fazem
o mesmo caminho que as funções sum() e mean(). Por
exemplo,
"SELECT EXTENT(GEOM) FROM GEOMTABLE" retornará um BOX3D
dando a extensão máxima de todas as
características na tabela. Semelhantemente, "SELECT
EXTENT(GEOM) FROM GEOMTABLE GROUP BY CATEGORY" retornará um
resultado de extensão para cada categoria.
Returna ZM (semântica da dimensão) flag de geometrias como um inteiro.Valores são: 0=2d, 1=3dm, 2=3dz, 3=4d.
Retorna VERDADEIRO se o bbox desta geometria é armazenada, FALSO caso contrário.Usa addBBOX() e dropBBOX() para armazenamento.
Retorna o número das dimensões da geometria como um inteiro. Valores são: 2,3 ou 4.
Se a geometria for um polígono ou um multi-polígono, retorna o número de anéis.
Retorna o número de pontos na geometria.
Retorna verdadeiro se esta geometria for válida.
Esta função retorna uma caixa delimitada expandida em todos os sentidos da caixa delimitada da entrada da geometria, por uma quantidade especificada no segundo argumento. Muito usada para selecionar distance() , para adicionar um filtro do índice à seleção.
Retorna a extensão estimada da tabela
espacial dada. O estimado é feito de estatisticas de colunas
geométricas. O "schema"
atual será usado se não especificado.
Para estatística PostgreSQL>=8.0.0 são
recolhidos por VACUUM
ANALYZE e a extensão resultante será
aproximadamente 95% do real.
Para estatística PostgreSQL<8.0.0 são
recolhidos por update_geometry_stats()
e a extensão resultante será exata.
A sintaxe é find_srid(<db/schema>, <tabela>, <coluna>) e a função retorna o inteiro SRID da coluna especificada procurando através da tabela GEOMETRY_COLUMNS. Se a coluna da geometria não for adicionada corretamente com a função de AddGeometryColumns(), esta função não trabalhará tampouco.
Retorna a quantia de espaços (em bytes) encontrados na geometria.
Retorna o número dos objetos armazenados na geometria. Isto é utilizado para MULTI-geometrias e GEOMETRYCOLLECTIONs.
A sintaxe para esta função
é point_inside_circle
(<geometry>, <circle_center_x>,
<circle_center_y>, <radius>).
Retorna verdadeiro se a geometria é um ponto e
está dentro do círculo. Caso
contrário, retorna falso.
Retorna o mínimo solicitado de uma caixa delimitada.
Retorna o máximo solicitado de uma caixa delimitada.
Este módulo e funções associadas de pl/pgsql foram implementados para fornecer suporte a grandes bloqueios requerido por especificação Web Feature Service.
Os usuários devem usar serializable transaction level que caso contrário o mecanismo de bloqueio quebraria.
Permite suporte a transações grandes. Esta função cria as tabelas requeridas dos metadados, necessita ser chamada uma vez antes de usar as outras funções nesta seção. Chamá-la duas vezes é inofensivo.
Disponível: 1.1.3
Desabilita suporte a transações grandes. Esta função remove as tabelas metadados de suporte a transações grandes, e apaga todos os gatilhos às tabelas lock-checked.
Disponível: 1.1.3
Verifica atualizações e deleções das linhas em dada tabela, sendo autorizada. Identifica linhas usando a coluna <rowid_col>.
Disponível: 1.1.3
Ajuste de bloqueio/autorização para linha específica na tabela <authid> é um valor de texto, <expires> é um timestamp padronizado para now() +1hour. Retorna 1 se o bloqueio for assinado, 0 caso contrário (já bloqueado pelo outro auth)
Disponível: 1.1.3
Remove todos os bloqueios carregados por id de autorização especificada. Retorna o número dos bloqueios liberados.
Adiciona um símbolo da autorização a ser usado na transação atual.
Disponível: 1.1.3
Esta é uma listagem das funções definidas SQL-MM que PostGIS suporta atualmente. As implementações destas funções seguem a implementação ArcSDE e assim desviar-se um pouco das especificações. Estes desvios serão notados.
As of version 1.2.0, these functions have been implemented by wrapping existing PostGIS functions. As a result, full support for curved geometries may not be in place for many functions.
Até à data da versão 1.2.0, estas funções foram implementadas envolvendo funções existentes no PostGIS. Em conseqüência, o suporte cheio para geometrias curvadas para muitas funções não pode estar no lugar.
SQL-MM define o padrão SRID de todos construtores de geometrias como 0. PostGIS usa um padrão SRID de -1.
Return the area measurement of an ST_Surface or ST_MultiSurface value.
Retorna a medida da área de um valor ST_Surface ou ST_MultiSurface.
SQL-MM 3: 8.1.2, 9.5.3
Retorna a representação binária well-known de um valor ST_Geometry.
SQL-MM 3: 5.1.37
Retorna a representação de texto well-known de um valor ST_Geometry.
SQL-MM 3: 5.1.25
Retorna o limite do valor ST_Geometry.
SQL-MM 3: 5.1.14
Retorna um buffer em torno do valor ST_Geometry.
SQL-MM 3: 5.1.17
Retorna centroid matemático do valor ST_Surface ou ST_MultiSurface.
SQL-MM 3: 8.1.4, 9.5.5
Testa se um valor ST_Geometry espacialmente contem um outro valor ST_Geometry.
SQL-MM 3: 5.1.31
Retorna o hull convexo do valor ST_Geometry.
SQL-MM 3: 5.1.16
Returna a dimensão da coordenada do valor ST_Geometry.
SQL-MM 3: 5.1.3
Testa se um valor ST_Geometry espacialmente atravessa outro valor ST_Geometry.
SQL-MM 3: 5.1.29
Returna um valor ST_Geometry que representa a diferença do conjunto de pontos de dois valores ST_Geometry.
SQL-MM 3: 5.1.20
Returna a dimensão do valor ST_Geometry.
SQL-MM 3: 5.1.2
Testa se um valor ST_Geometry é espacialmente desconecta de outro valor ST_Geometry.
SQL-MM 3: 5.1.26
Returna a distancia entre duas geometrias.
SQL-MM 3: 5.1.23
Returna um valor ST_Point que é o ponto final de um valor ST_Curve.
SQL-MM 3: 7.1.4
Returna o retângulo delimitado para o valor ST_Geometry.
SQL-MM 3: 5.1.15
Testa se um valor ST_Geometry é espacialmente igual a outro valor ST_Geometry.
SQL-MM 3: 5.1.24
Returna o anel exterior de um ST_Surface.
SQL-MM 3: 8.2.3, 8.3.3
Returna a indicação do valor ST_Geometry de um ST_GeomCollection.
SQL-MM 3: 9.1.5
Returna o tipo geométrico do valor ST_Geometry.
SQL-MM 3: 5.1.4
Returna uma especificação do valor ST_Geometry.
SQL-MM 3: 5.1.40
Returna uma especificação do valor ST_Geometry.
SQL-MM 3: 5.1.41
Returna o anel interior especificado de um valor ST_Surface.
SQL-MM 3: 8.2.6, 8.3.5
Returna um valor ST_Geometry que representa a interseção do conjunto de pontos de dois valores ST_Geometry.
SQL-MM 3: 5.1.18
Testa se um valor ST_Geometry intercepta espacialmente outro valor ST_Geometry.
SQL-MM 3: 5.1.27
Testa se um valor ST_Curve ou um valor ST_MultiCurve está fechado.
SQL-MM define o resultado de ST_IsClosed(NULL) para ser 0, quando PostGIS returna NULO.
SQL-MM 3: 7.1.5, 9.3.3
Testa se um valor ST_Geometry corresponde à um conjunto vazio.
SQL-MM define o resultado de ST_IsEmpty(NULL) para ser 0, quando PostGIS returna NULO.
SQL-MM 3: 5.1.7
Testa se um valor ST_Curve é um anel.
SQL-MM define o resultado de ST_IsRing(NULL) para ser 0, quando PostGIS returna NULO.
SQL-MM 3: 7.1.6
Testa se um valor ST_Geometry não tem pontos geométricos anomalos, como própria interseção ou própria tangência.
SQL-MM define o resultado de ST_IsSimple(NULL) para ser 0, qunado PostGIS returna NULO.
SQL-MM 3: 5.1.8
Testa se um valor ST_Geometry está bem formado.
SQL-MM define o resultado de ST_IsValid(NULL) para ser 0, quando PostGIS returna NULO.
QL-MM define o resultado de ST_IsValid(NULL) para ser 1.
SQL-MM 3: 5.1.9
Returna a medida do comprimento de um valor
ST_Curve ou um valor ST_MultiCurve.
SQL-MM 3: 7.1.2, 9.3.4
Returna uma especificação do valor ST_LineString.
SQL-MM 3: 7.2.8
Returna uma especificação de valor ST_LineString.
SQL-MM 3: 7.2.9
Returna uma espeficiação de valor ST_MultiLineString.
SQL-MM 3: 9.4.4
Returna uma especificação de valor ST_MultiLineString.
SQL-MM 3: 9.4.5
Returna uma especificação de valor ST_MultiPoint.
SQL-MM 3: 9.2.4
Returna uma especificação de valor ST_MultiPoint.
SQL-MM 3: 9.2.5
Returna uma especificação de valor ST_MultiPolygon.
SQL-MM 3: 9.6.4
Returna uma especificação de valor ST_MultiPolygon.
SQL-MM 3: 9.6.5
Returna o número de geometrias em um ST_GeomCollection.
SQL-MM 3: 9.1.4
Returna o número de asnéis interiores em um ST_Surface.
SQL-MM 3: 8.2.5
Returna o número de pontos em um valor ST_LineString ou um valor ST_CircularString.
SQL-MM 3: 7.2.4
ST_OrderingEquals compara duas geometrias e t (TRUE) se as geometrias são iguais e as coordenadas estão na mesma ordem; caso contrário retorna f (FALSE).
Esta implementação é feita como especificação ArcSDE SQL melhor que SQL-MM. http://edndoc.esri.com/arcsde/9.1/sql_api/sqlapi3.htm#ST_OrderingEquals
SQL-MM 3: 5.1.43
Testa se um valor ST_Geometry sobrepõe camadas espacialmente a outro valor ST_Geometry.
SQL-MM 3: 5.1.32
Returna a medida do comprimento do limite de um valor ST_Surface ou de um valor ST_MultiRSurface.
SQL-MM 3: 8.1.3, 9.5.4
Returna um ST_Point com os valores de coordenadas dadas.
SQL-MM 3: 6.1.2
Returna uma especificação de valor ST_Point.
SQL-MM 3: 6.1.8
Returna uma especificação de valor ST_Point.
SQL-MM 3: 6.1.9
Returna uma especificação de valor ST_Point em um ST_LineString ou ST_CircularString.
SQL-MM 3: 7.2.5, 7.3.5
Returna um valor ST_Point garantido para interseção espacialmente do valor ST_Surface ou ST_MultiSurface.
SQL-MM 3: 8.1.5, 9.5.6
Returna uma especificação de valor ST_Polygon.
SQL-MM 3: 8.3.6
Returna uma especificação de valor ST_Polygon.
SQL-MM 3: 8.3.7
Returna uma construção de polígono de uma linestring especificada e SRID.
SQL-MM 3: 8.3.2
Testa se um valor ST_Geometry é relatado espacialmente à outro valor ST_Geometry.
SQL-MM 3: 5.1.25
Returna o identificador de sistema de referência espacial do valor ST_Geometry.
SQL-MM 3: 5.1.5
Returna um valor ST_Point que é o ponto inicial de um valor ST_Curve.
SQL-MM 3: 7.1.3
Returna um valor ST_Geometry que representa a diferença simétrica de um conjunto de pontos de dois valores ST_Geometry.
SQL-MM 3: 5.1.21
Testa se um valor ST_Geometry tocado espacialmente por outro valor ST_Geometry.
SQL-MM 3: 5.1.28
Returna um valor ST_Geometry transformado para sistema de referência espacial especificado.
SQL-MM 3: 5.1.6
Returna um valor ST_Geometry que representa a união de um conjunto de pontos de dois valores ST_Geometry.
SQL-MM 3: 5.1.19
Testa se um valor ST_Geometry é espacialmente dentro de outro valor ST_Geometry.
SQL-MM 3: 5.1.30
Returna um valor ST_Geometry para uma dada representação binária well-known.
SQL-MM 3: 5.1.36
Returna um valor ST_Geometry para uma dada representação de texto well-known.
SQL-MM 3: 5.1.34
Returna o valor da coordenada x de um valor ST_Point.
SQL-MM 3: 6.1.3
Returna o valor da coordenada y de um valoST_Point.
SQL-MM 3: 6.1.4
As funções adicionais foram acrescidas para melhorar o suporte a uma interface de estilo ArcSDE.
Returna t (TRUE) se os envelopes de duas interseções de geometrias; caso contrário, returna f (FALSE).
Testa se um valor de geometria tem valores de coordenada z.
Testa se um valor de geometria tem valores de coordenada m.
Returna um valor de coleção de geometria derivada com elementos que combinam a medida especificada.
Returna um valor de coleção de geometria derivada com elementos que combinam a escala especificada das medidas inclusive.
Returna o valor da coordenada m de um valor ST_Point.
Returna o valor da coordenada z de um valor ST_Point.