Upload
valeriambc
View
358
Download
1
Embed Size (px)
Citation preview
5/16/2018 PostGIS - Fun es e Extens es - slidepdf.com
http://slidepdf.com/reader/full/postgis-funcoes-e-extensoes 1/31
Capítulo 6. Referências PostGISAnterior Próxima
Capítulo 6. Referências PostGIS
Índice6.1. Funções OpenGIS
6.1.1. Funções de Gerenciamento6.1.2. Funções de Relacionamento da Geometria6.1.3. Funções de Processamento da Geometria6.1.4. Assessores Geométricos6.1.5. Construtores Geométricos
6.2. Extensões PostGIS6.2.1. Funções de Gerenciamento6.2.2. Operadores
6.2.3. Funções de Medida6.2.4. Saída Geométricas6.2.5. Construtores Geométricos6.2.6. Editores Geométricos6.2.7. Referência Linear6.2.8. Variado6.2.9. Suporte a grandes transações (Long Transactions)
6.3. Funções SQL-MM6.4. Funções ArcSDE
As funções descritas abaixo são as quais o usuário de PostGIS utiliza. Existem outras funções que sãorequeridas como suporte de funções aos objetos de PostGIS que não são de uso para um usuário comum.
6.1. Funções de OpenGIS
6.1.1. Funções de Gerenciamento
AddGeometryColumn(varchar, varchar, varchar, integer, varchar, integer)
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 umaentrada dentro da tabela SPATIAL_REF_SYS. O tipo deve ser uma string maiúscula quecorresponde ao tipo de geometria , eg, ' POLÍGONO' ou ' MULTILINESTRING '.
DropGeometryColumn(varchar, varchar, varchar)
Sintaxe: DropGeometryColumn(<schema_name>, <table_name>, <column_name>). Remove umacoluna geométrica de uma tabela espacial. Note que o schema_name necessitará combinar o campodo f_schema_name da linha da tabela na tabela dos geometry_columns.
SetSRID(geometry)
Atribui o SRID em uma geometria para um valor de inteiro particular. É utilizado na construção decaixas de salto para "queries".
Capítulo 6. Referências de PostGIS http://webgis.com.br/postgis/docs/capitulo6_Referencias_PostGIS.htm...
1 de 31 29/01/2010 04:24
5/16/2018 PostGIS - Fun es e Extens es - slidepdf.com
http://slidepdf.com/reader/full/postgis-funcoes-e-extensoes 2/31
6.1.2. Funções de Relacionamento da Geometria
Distance(geometry,geometry)
Retorna a distancia cartesiana entre duas geometrias em unidades projetadas.
Equals(geometry,geometry)
Retorna1 (VERDADEIRO) se esta geometria é que "spatially equal" (espacialmente iguais) a umaoutra 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 GEOSOGC SPECs2.1.1.2
Disjoint(geometry,geometry)
Retorna 1 (VERDADEIRO) se esta Geometria é que "spatially disjoint" (desloca espacialmente) deoutra geometria.Executado pelo módulo de GEOS
Não chame "GeometryCollection" como um argumentoNOTA: esta é a versão "allowable" (permissível) que retorna uma boolean (condição verdadeira oufalsa), e não um inteiro.OGC SPEC s2.1.1.2 / / s2.1.13.3 - a.Relate(b, ' FF*FF * * * * ')
Intersects(geometry,geometry)
Retorna 1 (VERDADEIRO) se esta geometria "spatially intersects" (cruza espacialmente) outrageometria.Executado pelo módulo de GEOSNão chame GeometryCollection como um argumentoNOTA: esta é a versão "allowable" (permissível) que retorna uma boolean (condição verdadeira oufalsa), e não um inteiro.OGC SPEC s2.1.1.2 / / s2.1.13.3 - Intersects(g1, g2)-Not (Disjoint(g1, g2))
Touches(geometry,geometry)
Retorna 1 (VERDADEIRO) se esta geometria "spatially touches" (toca espacialmente) de outrageometria.Executado pelo módulo de GEOSNão chame GeometryCollection como um argumentoNOTA: esta é a versão "allowable" (permissível) que retorna uma boolean (condição verdadeira oufalsa), 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 (aintersection b) não vazio
Crosses(geometry,geometry)
Retorna 1 (VERDADEIRO) se esta geometria "spatially crosses" de outras geometrias.Executado pelo módulo de GEOSNão chame GeometryCollection como um argumento
NOTA: esta é a versão "allowable" (permissível) que retorna uma boolean (condição verdadeira oufalsa), e não um inteiro.OGC SPEC s2.1.1.2 / / s2.1.13.3 - a.Relate(b, ' T*T * * * * * * ')
Within(geometry A,geometry B)
Capítulo 6. Referências de PostGIS http://webgis.com.br/postgis/docs/capitulo6_Referencias_PostGIS.htm...
2 de 31 29/01/2010 04:24
5/16/2018 PostGIS - Fun es e Extens es - slidepdf.com
http://slidepdf.com/reader/full/postgis-funcoes-e-extensoes 3/31
Retorna 1 (VERDADEIRO) se a geometria A é "spatially within" a geometria B.Executado pelo módulo de GEOSNão chame GeometryCollection como um argumentoNOTA: 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 * * * ')
Overlaps(geometry,geometry)
Retorna 1 (VERDADEIRO) se Geometria é "spatially overlaps" (sobrepõe espacialmente).Executado pelo módulo de GEOSNão chame GeometryCollection como um argumentoNOTA: 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
Contains(geometry A, geometry B)
Retorna 1 (VERDADEIRO) se a geometria A "spatially contains" (contem espacialmente) ageometria B.Executado pelo módulo de GEOS
Não chame GeometryCollection como um argumentoNOTA: 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)
Intersects(geometry,geometry)
Retorna 1 (VERDADEIRO) se a geometria é "spatially intersects".Executado pelo módulo de GEOSNão chame GeometryCollection como um argumentoNOTA: 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)
Relate(geometry,geometry, intersectionPatternMatrix)
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 especificadopelos valores em umaintersectionPatternMatrix.Executado pelo módulo de GEOSNão chame GeometryCollection como um argumentoNOTA: 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)
Relate(geometry,geometry)
Retorna o DE-9IM (dimensionally extended nine-intersection matrix)Executado pelo módulo de GEOSNão chame GeometryCollection como um argumentoNão em especificação OGC, mas sub-entendido. veja s2.1.13.2
6.1.3. Funções de Processamento da Geometria
Centroid(geometry)
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 decompilação).
Capítulo 6. Referências de PostGIS http://webgis.com.br/postgis/docs/capitulo6_Referencias_PostGIS.htm...
de 31 29/01/2010 04:24
5/16/2018 PostGIS - Fun es e Extens es - slidepdf.com
http://slidepdf.com/reader/full/postgis-funcoes-e-extensoes 4/31
Area(geometry)
Retorna a área da geometria, se é um polígono ou multi-polígono.
Length(geometry)
O comprimento desta curva em sua referência espacial associada.sinônimo para length2d ()
OGC SPEC 2.1.5.1
PointOnSurface(geometry)
Retorna um ponto garantido estar na superfícieImplementado usando GEOSOGC SPEC 3.2.14.2 e 3.2.18.2 -
Boundary(geometry)
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 usandorepresentação de primitivas geométricas como discutido na OGC SPEC, seção 3.12.2.Executado pelo módulo de GEOSOGC SPEC s2.1.1.1
Buffer(geometry,double,[integer])
Retorna uma geometria que represente todos os pontos que distanciam desta geometria é menor ouigual a distancia. Cálculos estão em um Spacial Reference System desta geometria. O terceiroparametro opcional atribui o número de segmentos usados para aproximar um quarto de círculo
(padrão para 8).Executado pelo módulo de GEOSNão chame GeometryCollection como um argumentoOGC SPEC s2.1.1.3
ConvexHull(geometry)
Retorna uma geometria que representa a casca convexa desta geometria.Executado pelo módulo de GEOSOGC SPECs2.1.1.3
Intersection(geometry,geometry)Retorna uma geometria que representa a interseção atribuída do ponto das Geometrias.Executado pelo módulo de GEOSNão chame GeometryCollection como um argumentoOGC SPEC s2.1.1.3
SymDifference(geometry A, geometry B)
Retorna uma geometria que representa a diferença simétrica atribuída do ponto da geometria Acom geometria B.
Executado pelo módulo de GEOSNão chame GeometryCollection como um argumentoOGC SPEC s2.1.1.3
Difference(geometry A, geometry B)
Capítulo 6. Referências de PostGIS http://webgis.com.br/postgis/docs/capitulo6_Referencias_PostGIS.htm...
de 31 29/01/2010 04:24
5/16/2018 PostGIS - Fun es e Extens es - slidepdf.com
http://slidepdf.com/reader/full/postgis-funcoes-e-extensoes 5/31
Retorna uma geometria que representa a diferença atribuída do ponto da geometria Acom geometria B.Executado pelo módulo de GEOSNão chame GeometryCollection como um argumentoOGC SPEC s2.1.1.3
GeomUnion(geometry,geometry)
Retorna uma geometria que representa a união atribuída do ponto das geometrias.Executado pelo módulo de GEOSNão chame GeometryCollection como um argumentoNOTA: este é renomeado de "union" porque união é uma palavra reservada SQLOGC SPEC s2.1.1.3
GeomUnion(geometry set)
Retorna uma geometria que representa a união atribuída do ponto de todas as geometrias em dadoconjunto.Executado pelo módulo de GEOS
Não chame GeometryCollection no conjunto de argumentoNada definido em OGC SPEC
MemGeomUnion(geometry set)
Mesmo que o anterior, só que com "memory-friendly" (memória-amigável - usa menos memória emais tempo de processamento)
6.1.4. Assessores Geométricos
AsText(geometry)Retorna a representação de Well-Known Text (WKT) da geometria. Por exemplo: POLYGON(0 0,01,1 1,1 0,0 0)OGC SPEC s2.1.1.1
AsBinary(geometry)
Retorna a geometria no OGC formato "well-known-bynary", usando a codificação endian dousuário em que o banco de dados está funcionando. É utilizado em cursores binários para extrairdados 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')
SRID(geometry)
Retornos de números inteiros SRID do sistema de referência espacial da geometria.OGC SPEC s2.1.1.1
Dimension(geometry)
A dimensão inerente deste objeto de geometria, que deve ser menor ou igual à dimensãocoordenada. OGC SPEC s2.1.1.1 - retorna 0 para pontos, 1 para linhas, 2 para polígonos, e a maiordimensão dos componentes de um GEOMETRYCOLLECTION.
select dimension('GEOMETRYCOLLECTION(LINESTRING(1 1,0 0),POINT(0 0)');
dimension
-----------1
Envelope(geometry)
Retorna um polígono representando a caixa delimitada da geometria.
Capítulo 6. Referências de PostGIS http://webgis.com.br/postgis/docs/capitulo6_Referencias_PostGIS.htm...
5 de 31 29/01/2010 04:24
5/16/2018 PostGIS - Fun es e Extens es - slidepdf.com
http://slidepdf.com/reader/full/postgis-funcoes-e-extensoes 6/31
OGC SPEC s2.1.1.1 - A caixa delimitada mínima para esta geometria, retornou como umageometria. 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.
IsEmpty(geometry)
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
IsSimple(geometry)
Retorna 1 (VERDADEIRO) se esta geometria não tem nenhum ponto geométrico anômalo, comointersecção própria ou tangência própria.Executado pelo módulo de GEOSOGC SPECs2.1.1.1
IsClosed(geometry)
Retornos verdadeiros do começo de geometria e pontos finais são coincidentes.
IsRing(geometry)
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 GEOSOGC spec 2.1.5.1
NumGeometries(geometry)
Se geometria é um GEOMETRYCOLLECTION (ou MULTI *) retorna o número de geometrias.Caso contrário, retorna NULO.
GeometryN(geometry,int)
Retorna a enésima geometria se a geometria é uma GEOMETRYCOLLECTION, MULTIPOINT,MULTILINESTRING ou MULTIPOLYGON. Caso contrário, retorna NULO.
Nota
Indice é 1-based como para especificações OGC desde a versão 0.8.0. As versõesanteriores executaram esta como 0-based preferivelmente.
NumPoints(geometry)
Encontra e Retorna o número de pontos na primeira linha na geometria. Retorna NULO se não hánenhuma linha na geometria.
PointN(geometry,integer)
Retorna o enésimo ponto na primeira linha na geometria. Retorna NULO se não há nenhuma linha
na geometria.
ExteriorRing(geometry)
Retorna o anel exterior do primeiro polígono na geometria. Retorna NULO se não há nenhum
Capítulo 6. Referências de PostGIS http://webgis.com.br/postgis/docs/capitulo6_Referencias_PostGIS.htm...
6 de 31 29/01/2010 04:24
5/16/2018 PostGIS - Fun es e Extens es - slidepdf.com
http://slidepdf.com/reader/full/postgis-funcoes-e-extensoes 7/31
polígono na geometria.
NumInteriorRings(geometry)
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.
NumInteriorRing(geometry)
Sinomimo para NumInteriorRings (geometry). As especificações OpenGIS são ambiguas sobre onome da função exata, assim que fornecemos ambas as escritas.
InteriorRingN(geometry, integer)
Retorna o enésimo anel interior do polígono na geometria. Retorna NULO se não há nenhumpolígono na geometria ou o N dado é fora da escala(1 baseado).
Nota
Indice is 1-based como especificações para OGC desde a versão 0.8.0. As versõesanteriores implementaram esta como 0-based preferivelmente.
EndPoint(geometry)
Retorna o último ponto da geometria de "LineString" como um ponto.
StartPoint(geometry)
Retorna o primeiro ponto da geometria de "LineString" como um ponto.
GeometryType(geometry)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 degeometria é um membro. O nome do sub-tipo imediato de geometria é devolvido como uma string.
X(geometry)
Encontra e retorna a coordenada de X do primeiro ponto na geometria. Retorna NULO se não hánenhum ponto na geometria.
Y(geometry)
Encontra e retorna a coordenada de Y do primeiro ponto na geometria. Retorna NULO se não hánenhum ponto na geometria.
Z(geometry)
Encontra e retorna a coordenada de Z do primeiro ponto na geometria. Retorna NULO se não hánenhum ponto na geometria.
M(geometry)
Retorna uma coordenada M do ponto, ou NULO se não disponível. A entrada deve ser um ponto.
Nota
Capítulo 6. Referências de PostGIS http://webgis.com.br/postgis/docs/capitulo6_Referencias_PostGIS.htm...
7 de 31 29/01/2010 04:24
5/16/2018 PostGIS - Fun es e Extens es - slidepdf.com
http://slidepdf.com/reader/full/postgis-funcoes-e-extensoes 8/31
This is not (yet) part of the OGC spec, but is listed here to complete the pointcoordinate extractor function list.
Esta não é (ainda) parte das especificações de OGC, mas é listada aqui para completar alista da função do extrator da coordenada do ponto.
6.1.5. Construtores Geométricos
GeomFromText(text,[<srid>])
Converte uma geometria de WKT com o dado SRID.OGC SPEC 3.2.6.2 - a opção SRID está de conformidade.
PointFromText(text,[<srid>])
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
LineFromText(text,[<srid>])
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
LinestringFromText(text,[<srid>])
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
PolyFromText(text,[<srid>])
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
PolygonFromText(text,[<srid>])
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
MPointFromText(text,[<srid>])
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
MLineFromText(text,[<srid>])
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
MPolyFromText(text,[<srid>])
Capítulo 6. Referências de PostGIS http://webgis.com.br/postgis/docs/capitulo6_Referencias_PostGIS.htm...
8 de 31 29/01/2010 04:24
5/16/2018 PostGIS - Fun es e Extens es - slidepdf.com
http://slidepdf.com/reader/full/postgis-funcoes-e-extensoes 9/31
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
GeomCollFromText(text,[<srid>])
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
GeomFromWKB(bytea,[<srid>])
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.
GeometryFromWKB(bytea,[<srid>])
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.
PointFromWKB(bytea,[<srid>])
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
LineFromWKB(bytea,[<srid>])
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
LinestringFromWKB(bytea,[<srid>])
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
PolyFromWKB(bytea,[<srid>])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
PolygonFromWKB(bytea,[<srid>])
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.
MPointFromWKB(bytea,[<srid>])
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
Capítulo 6. Referências de PostGIS http://webgis.com.br/postgis/docs/capitulo6_Referencias_PostGIS.htm...
9 de 31 29/01/2010 04:24
5/16/2018 PostGIS - Fun es e Extens es - slidepdf.com
http://slidepdf.com/reader/full/postgis-funcoes-e-extensoes 10/31
MLineFromWKB(bytea,[<srid>])
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
MPolyFromWKB(bytea,[<srid>])
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
GeomCollFromWKB(bytea,[<srid>])
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
BdPolyFromText(text WKT, integer SRID)
Construir um Polygon dada uma coleção arbitrária de linhas fechadas como uma representação dotexto MultiLineString. Lança um erro se WKT não for um MULTILINESTRING. Lança um erro sea saída for um MULTIPOLYGON; usa BdMPolyFromText neste caso ou vê BuildArea() para umacesso específico de postgis.OGC SFSQL 1.1 - 3.2.6.2Disponibilidade: 1.1.0 - requer GEOS >= 2.1.0.
BdMPolyFromText(text WKT, integer SRID)
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ídaMULTIPOLYGON mesmo quando o resultado é composto somente por um único POLYGON; usaBdPolyFromText se você estiver certo que um único POLYGON resultará da operação ouveja BuildArea() para um acesso específico de postgis.OGC SFSQL 1.1 - 3.2.6.2Disponibilidade: 1.1.0 - requer GEOS >= 2.1.0.
6.2. Extensões de Postgis
6.2.1. Funções de Gerenciamento
DropGeometryTable([<schema_name>], <table_name>)
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.
UpdateGeometrySRID([<schema_name>], <table_name>, <column_name>, <srid>)
Atualiza o SRID de todas as características em uma coluna da geometria que atualiza confinamentee referência nas colunas geométricas. Nota: usa o current_schema() em instalações dopgsql schema-aware se o schema não for fornecido.
update_geometry_stats([<table_name>, <column_name>])
Atualiza estatisticas sobre tabelas espaciais para o uso pelo operador da seleção. Precisará tambémrodar o "VACUUM ANALYZE [ table_name ] [ column_name ]" para as estatisticas que recolhem o
Capítulo 6. Referências de PostGIS http://webgis.com.br/postgis/docs/capitulo6_Referencias_PostGIS.htm...
10 de 31 29/01/2010 04:24
5/16/2018 PostGIS - Fun es e Extens es - slidepdf.com
http://slidepdf.com/reader/full/postgis-funcoes-e-extensoes 11/31
processo para estar completo. Nota: começando com PostgreSQL 8.0 que analisando estatisticas éautomaticamente executado rodando "VACUUM ANALYZE".
postgis_version()
Retorna o número de versão de PostGIS e opções de tempo de compilação. Nota: Antes da versão1.1.0 esta era uma função procedural, assim possivelmente não estará retornando a informaçãoexata (em caso dos melhoramentos incompletos do banco de dados).
postgis_lib_version()
Retorna o número de versão da biblioteca de PostGIS.Disponível: 0.9.0
postgis_lib_build_date()
Retorna data da construção da biblioteca PostGIS.Disponível: 1.0.0RC1
postgis_script_build_date()Retorna data da construção de scripts PostGIS.Disponível: 1.0.0RC1
postgis_scripts_installed()
Retorna a versão do script postgis instalado neste banco de dados. Nota: Se a saída desta funçãonão combinasse com a saída de postgis_scripts_released() provavelmente faltou promovercorretamente um banco de dados existente. Veja a seção Upgrading para mais informações.Disponibilidade: 0.9.0
postgis_scripts_released()
Retorna o número da versão do script de lwpostgis.sql liberado com o instalado na biblioteca dopostgis. Nota: Começar com versão 1.1.0 esta função, retorna o mesmo valordo postgis_lib_version(). Conservar para a compatibilidade inversa.Disponível: 0.9.0
postgis_geos_version()
Retorna o número da versão da biblioteca de GEOS ou NULO se o suporte a GEOS não forpermitida.Disponível: 0.9.0
postgis_proj_version()
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
postgis_uses_stats()
Retorna verdadeiro se o uso do STATS for permitido,caso contrário retorna falso.Disponível: 0.9.0
postgis_full_version()
Retorna a versão postgis completa e constrói informações de configuração.Disponível: 0.9.0
Capítulo 6. Referências de PostGIS http://webgis.com.br/postgis/docs/capitulo6_Referencias_PostGIS.htm...
11 de 31 29/01/2010 04:24
5/16/2018 PostGIS - Fun es e Extens es - slidepdf.com
http://slidepdf.com/reader/full/postgis-funcoes-e-extensoes 12/31
6.2.2. Operadores
A &< B
O operador "&<" retorna verdadeiro se a caixa delimitada sobrepor o próprio A ou está à esquerdada caixa delimitada do próprio B.
A &> B
O operador "&>" retorna verdadeiro se a caixa delimitada sobrepor o próprio A ou está à direita dacaixa delimitada do próprio B.
A << B
O operador "<<" retorna verdadeiro se a caixa delimitada for estritamente à esquerda da caixadelimitada do próprio B.
A >> B
O operador ">>" retorna verdadeiro se o salto de caixa do próprio A for estritamente à direita dosalto de caixa do próprio B.
A &<| B
O operador "&<|" returna verdadeiro se a caixa delimitada do próprio A for abaixo da caixadelimitada do próprio B.
A |&> B
O operador "|&>" returna verdadeiro se a caixa delimitada de A for acima da caixa delimitada do
próprio B.A <<| B
O operador "<<|" retorna verdadeiro se a caixa delimitada de A for estritamente abaixo da caixadelimitada do próprio B.
A |>> B
O operador "|>>" retorna verdadeiro se a caixa delimitada A for esttritamente acima da caixadelimitada do próprio B.
A ~= 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.
A @ B
O operador "@ " retorna verdadeiro se a caixa delimitada do próprio A estiver completamentecontido na caixa delimitada do próprio B.
A ~ B
O operador "~" retorna verdadeiro se a caixa delimitada estiver completamente contida na caixadelimitada do próprio B.
A && B
Capítulo 6. Referências de PostGIS http://webgis.com.br/postgis/docs/capitulo6_Referencias_PostGIS.htm...
12 de 31 29/01/2010 04:24
5/16/2018 PostGIS - Fun es e Extens es - slidepdf.com
http://slidepdf.com/reader/full/postgis-funcoes-e-extensoes 13/31
O operador "&& " é o operador sobreposto. Se a caixa delimitada do prórpio A sobrepor a caixadelimitada do próprio B, o operador retorna verdadeiro.
6.2.3. Funções de Medida
area2d(geometry)
Retorna a área da geometria, se é um polígono ou multi-polígono.
distance_sphere(point, point)
Retorna a distância linear nos medidores entre dois pontos de lat/lon. Usa uma terra e um raioesféricos de 6370986 medidores. Mais rapidamente do que distance_spheroid(), mas menos exato.Atualmente só se implementou para pontos.
distance_spheroid(point, point, spheroid)
Retorna a distância linear entre dois pontos latitude/longitude dando um esferóide particular. Veja aexplicação de esferóides dados para length_spheroid(). Atualmente só se implementou para pontos.
length2d(geometry)
Retorna o comprimento 2-dimensional da geometria se é um linestring ou multi-linestring.
length3d(geometry)
Retorna o comprimento 3-dimensional da geometria se é um linestring ou multi-linestring.
length_spheroid(geometry,spheroid)
Calcula o comprimento de uma geometria em um ellipsoid . É utilizada se as coordenadas dageometria 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;
length3d_spheroid(geometry,spheroid)
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 mesmasunidades como os spheroid axes) são usados para calcular a soma de deslocamento da distânciaextra vertical.
distance(geometry, geometry)
Retorna a distância menor entre duas geometrias..
max_distance(linestring,linestring)
Capítulo 6. Referências de PostGIS http://webgis.com.br/postgis/docs/capitulo6_Referencias_PostGIS.htm...
13 de 31 29/01/2010 04:24
5/16/2018 PostGIS - Fun es e Extens es - slidepdf.com
http://slidepdf.com/reader/full/postgis-funcoes-e-extensoes 14/31
Retorna a distância maior entre duas linhas de string.
perimeter(geometry)
Retorna o perímetro da geometria, se é um polígono ou multi-polígono.
perimeter2d(geometry)
Retorna o perímetro 2-dimensional da geometria, se é um polígono ou multi-polígono.
perimeter3d(geometry)
Retorna o perímetro 3-dimensional da geometria, se é um polígono ou multi-polígono.
azimuth(geometry, geometry)
Retorna o azimuth do segmento definido pelo dado geometrias Point ou o NULO, se os dois pontosforem coincidentes. O valor do retorno está nos radianos.
Disponibilidade: 1.1.0
6.2.4. Saídas Geométricas
AsBinary(geometry,{'NDR'|'XDR'})
Retorna a geometria no formato OGC "well-known-bynary", usando "little-endian" (NDR) oubig-endian (XDR) . É utilizado em cursores binários para extrair dados do banco de dados semconvertê-la a uma representação string.
AsEWKT(geometry)
Retorna uma Geometria em formato EWKT (como texto).
AsEWKB(geometry, {'NDR'|'XDR'})
Retorna uma geometria em formato EWKB (como o "bytea") usando outra codificação "little-endian" (NDR) ou "big-endian".
AsSVG(geometry, [rel], [precision])
Retorna a geometria como um dado do trajeto de SVG. Usa 1 como segundo argumento e tem otrajeto 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 dosdígitos decimais usados na saída ("default" para 15). Pontos de geometrias serão rendidos comocx/cy quando arg 'rel' é 0, x/y quando 'rel' é 1.
AsGML(geometry, [precision])
Retorna a geometria como um elemento GML. O segundo argumento pode ser usado para reduzir onúmero máximo dos dígitos significativos usados na saída (defaults para 15).
AsKML(geometry, [precision])
Retorna a geometria como um elemento KML. O segundo argumento pode ser usado para reduzir onúmero máximo de dígitos significativos usados na saída ( defaults para 15).
6.2.5. Construtores Geométricos
Capítulo 6. Referências de PostGIS http://webgis.com.br/postgis/docs/capitulo6_Referencias_PostGIS.htm...
14 de 31 29/01/2010 04:24
5/16/2018 PostGIS - Fun es e Extens es - slidepdf.com
http://slidepdf.com/reader/full/postgis-funcoes-e-extensoes 15/31
GeomFromEWKT(text)
Faz a geometria de EWKT.
GeomFromEWKB(bytea)
Faz a geometria de EWKB.
MakePoint(<x>, <y>, [<z>], [<m>])Cria um ponto 2d,3dz or 4d geométrico.
MakePointM(<x>, <y>, <m>)
Cria um ponto 3dm geométrico.
MakeBox2D(<LL>, <UR>)
Cria um BOX2D definido dados os pontos geométricos.
MakeBox3D(<LLB>, <URT>)
Cria um BOX3D definido dados os pontos geométricos.
MakeLine(geometry set)
Cria um Linestring de um conjunto de pontos de geometrias. Poderá usar um subselect para ordenaros pontos antes de alimentá-los a este agregado.
MakeLine(geometry, geometry)
Cria um Linestring dados dois pontos geométricos.
LineFromMultiPoint(multipoint)
Cria um LineString de uma geometria MultiPoint.
MakePolygon(linestring, [linestring[]])
Cria um polígono formado pela proteção dada e pelo conjunto de regras. Poderá construir umconjunto de geometria usando Accum. Entradas geométricas devem ser LINESTRINGS fechadas(veja IsClosed e GeometryType).
BuildArea(geometry)
Cria uma geometria areal formada pelo componente de linha de trabalho da geometria dada. O tipodo retorno pode ser um Polygon ou um MultiPolygon,
dependendo da entrada. Se a entrada das linhas de trabalho não forem forma de polígonos, NULO éretornado. Veja também BdPolyFromText
e BdMPolyFromText - envoltórios para esta função com padrão de interface OGC.
Disponibilidade: 1.1.0 - requer GEOS >= 2.1.0.Polygonize(geometry set)
Agregado. Cria um GeometryCollection que contem os polígonos possíveis formados decomponentes de linhas de trabalho de um conjunto de geometrias.Disponível 1.0.0RC1 - requer GEOS >= 2.1.0.
Capítulo 6. Referências de PostGIS http://webgis.com.br/postgis/docs/capitulo6_Referencias_PostGIS.htm...
15 de 31 29/01/2010 04:24
5/16/2018 PostGIS - Fun es e Extens es - slidepdf.com
http://slidepdf.com/reader/full/postgis-funcoes-e-extensoes 16/31
Collect(geometry set)
Esta função retorna um GEOMETRYCOLLECTION ou um objeto MULTI de um conjunto degeometrias. A função collect() é uma função "agregada" na terminologia de PostgreSQL. Issosignifica 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 BYATTRCOLUMN" retornará um GEOMETRYCOLLECTION separado para cada valor distinto deATTRCOLUMN.
Collect(geometry, geometry)
Esta função retorna uma geometria, sendo uma coleção de duas saídas geométricas. O tipo de saídapode ser um MULTI* ou um GEOMETRYCOLLECTION.
Dump(geometry)
Esta é uma função de um conjunto de retornos (set-returning function-SRF). Retorna um conjuntode 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 doscomponentes 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.
DumpRings(geometry)
Esta é uma função de um conjunto de retornos (set-returning function-SRF). Retorna umconjunto de linhas geometry_dump, formado por uma geometria (geom) e por uma conjunto deinteiros (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 correspondentecomo um polígono.
Disponibilidade: PostGIS 1.1.3. Requer PostgreSQL 7.3 ou superiores.
6.2.6. Editores Geométricos
AddBBOX(geometry)
Adiciona caixa delimitada à geometria. Isto fará na caixa delimitada baseada em seleções maisrápidas, mas aumentará o tamanho da geometria.
DropBBOX(geometry)
Destrói a caixa delimitada da geometria. Isto reduz o tamanho da geometria, mas as caixadelimitada baseada em seleções mais lentas.
AddPoint(linestring, point, [<position>])
Adiciona um ponto a um LineString na posição <pos> (índice 0-based). O terceiro parâmetro podeser omitido ou ajustado a -1.
RemovePoint(linestring, offset)
Remove ponto de uma linestring. Offset é 0-based.
Disponível: 1.1.0
Capítulo 6. Referências de PostGIS http://webgis.com.br/postgis/docs/capitulo6_Referencias_PostGIS.htm...
16 de 31 29/01/2010 04:24
5/16/2018 PostGIS - Fun es e Extens es - slidepdf.com
http://slidepdf.com/reader/full/postgis-funcoes-e-extensoes 17/31
SetPoint(linestring, N, point)
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
Force_collection(geometry)Converte a geometria em um GEOMETRYCOLLECTION. É utilizado para simplificar arespresentação de WKB.
Force_2d(geometry)
Força as geometrias dentro de um "2-dimensional mode" (modo bi-dimensional) de forma que todasas representações de saída só terão as coordenadas X e Y. É utilizado para forçar a saídaOGC-compliant (desde que OGC especifica somente geometrias 2-D).
Force_3dz(geometry), Force_3d(geometry)Força as geometrias dentro de um modo XYZ.
Force_3dm(geometry)
Força as geometrias dentro de um modo XYM.
Force_4d(geometry)
Força as geometrias dentro de um modo XYZM.
Multi(geometry)
Retorna a geometria como uma geometria MULTI*. Se a geometria já é uma MULTI*, estaretornará inalterada.
Transform(geometry,integer)
Retorna uma nova geometria com suas coordenadas transformadas ao SRID referenciado peloparâmetro inteiro. O destino SRID tem que existir na tabela SPATIAL_REF_SYS.
Affine(geometry, float8, float8, float8, float8, float8, float8, float8, float8, float8, float8, float8, float8)
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 /
e os vertices são transformados como segue:
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.
Capítulo 6. Referências de PostGIS http://webgis.com.br/postgis/docs/capitulo6_Referencias_PostGIS.htm...
17 de 31 29/01/2010 04:24
5/16/2018 PostGIS - Fun es e Extens es - slidepdf.com
http://slidepdf.com/reader/full/postgis-funcoes-e-extensoes 18/31
Disponível: 1.1.2.
Affine(geometry, float8, float8, float8, float8, float8, float8)
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.
Translate(geometry,float8,float8,float8)
Traduz a geometria a um novo local que usa os parâmetros numéricos como recompensa. Isto é:translate(geom,X,Y,Z).
Scale(geometry, float8, float8, float8)
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
RotateZ(geometry, float8), RotateX(geometry, float8), RotateY(geometry, float8),
Gira a geometria em torno da linha central de Z, X ou Y por dado ângulo dado nos radianos. Seguira regra right-hand.
Disponível: 1.1.2.
TransScale(geometry, float8, float8, float8, float8)
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 callsaffine(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 segundosdois 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.
Reverse(geometry)
Retorna a geometria com a ordem do vértice invertida.
Capítulo 6. Referências de PostGIS http://webgis.com.br/postgis/docs/capitulo6_Referencias_PostGIS.htm...
18 de 31 29/01/2010 04:24
5/16/2018 PostGIS - Fun es e Extens es - slidepdf.com
http://slidepdf.com/reader/full/postgis-funcoes-e-extensoes 19/31
ForceRHR(geometry)
Força polígono da coleção a obedecer Right-Hand-Rule.
Simplify(geometry, tolerance)
Retorna uma versão "simplified"da geometria dada usando o algoritmo de Douglas-Peuker . Destaforma, 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 ageometria retornada pode perder sua simplicidade. (veja IsSimple)
SnapToGrid(geometry, originX, originY, sizeX, sizeY), SnapToGrid(geometry, sizeX, sizeY),SnapToGrid(geometry, size)
Pega todos os pontos de entrada da geometria à definição de grade por seu tamanho de origem e decélula. Remove os pontos consecutivos que caem na mesma célula, retornando eventualmente oNULO, se os pontos da saída não forem bastante para definir uma geometria do tipo dado. Asgeometrias derrubadas em uma coleção são desfeitas dela.
Nota
A geometria retornada pode perder sua simplicidade (veja IsSimple).
Nota
Antes da liberação 1.1.0 esta função retornou sempre uma geometria 2d . Começando por1.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 degeometria para definir todas as dimensões da grade.
Disponível: 1.0.0RC1
SnapToGrid(geometry, geometry, sizeX, sizeY, sizeZ, sizeM)
Pega todos os pontos de entrada da geometria a definição de grade por seu tamanho de origem (osegundo argumento, deve ser um ponto) e por seu tamanho de célula. Especificar 0 como tamanhopara alguma dimensão que você não quiser pegar para uma grade.
Disponível: 1.1.0Segmentize(geometry, maxlength)
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. Acomputação da distância é executada em somente em 2d.
LineMerge(geometry)
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
6.2.7. Referência Linear
Capítulo 6. Referências de PostGIS http://webgis.com.br/postgis/docs/capitulo6_Referencias_PostGIS.htm...
19 de 31 29/01/2010 04:24
5/16/2018 PostGIS - Fun es e Extens es - slidepdf.com
http://slidepdf.com/reader/full/postgis-funcoes-e-extensoes 20/31
line_interpolate_point(linestring, location)
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 2dlength o ponto tem que ser encontrado.Veja line_locate_point() para computar a posição da linha o mais próximo a um Point.
Nota
Desde a liberação 1.1.1 esta função tambem interpola valores M e Z (quandopresente), quando que as liberações anteriores ajustam-nas para 0.0.
Disponível: 0.8.2
line_substring(linestring, start, end)
Retorna um linestring sendo um substring da entrada uma que começa e que termina nas fraçõesdo 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.
Nota
Desde a liberação 1.1.1 esta função também interpola valores M e Z (quandopresente), quando que as liberações anteriores ajustam-nas aos valores nãoespecificados.
Disponível: 1.1.0line_locate_point(LineString, Point)
Retorna um float entre 0 e 1 que representam a posição do ponto o mais próximo em LineString
para o dado Point , como uma fração do totaltamanho 2d line.Você pode usar a posição retornada para extrair um Point (line_interpolate_point) ou um substring
(line_substring).Disponível: 1.1.0
locate_along_measure(geometry, float8)Retorna um valor derivado da coleção da geometria com elementos que combinam a medida
especificada. Os elementos Polygonal não sãosuportados.Semântica é especificado por: ISO/IEC CD 13249-3:200x(E) - Text for Continuation CD Editing
MeetingDisponível: 1.1.0
locate_between_measures(geometry, float8, float8)
Retorna um valor derivado da coleção da geometria com elementos que combinam a escalaespecificada 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 EditingMeeting
Disponível: 1.1.0
6.2.8. Variado
Capítulo 6. Referências de PostGIS http://webgis.com.br/postgis/docs/capitulo6_Referencias_PostGIS.htm...
20 de 31 29/01/2010 04:24
5/16/2018 PostGIS - Fun es e Extens es - slidepdf.com
http://slidepdf.com/reader/full/postgis-funcoes-e-extensoes 21/31
Summary(geometry)
Retorna um resumo de texto dos conteúdos da geometria.
box2d(geometry)
Retorna um BOX2D representando as extensões máximas da geometria.
box3d(geometry)Retorna um BOX3D representando as extensões máximas da geometria.
extent(geometry set)
A função extent() é uma função "aggregate" (agregada) na terminologia de PostgreSQL. Issosignifica que os operadores em listas de dados, fazem o mesmo caminho que as funções sum() emean(). Por exemplo,"SELECT EXTENT(GEOM) FROM GEOMTABLE" retornará um BOX3D dando a extensãomáxima de todas as características na tabela. Semelhantemente, "SELECT EXTENT(GEOM)
FROM GEOMTABLE GROUP BY CATEGORY" retornará um resultado de extensão para cadacategoria.
zmflag(geometry)
Returna ZM (semântica da dimensão) flag de geometrias como um inteiro.Valores são: 0=2d,1=3dm, 2=3dz, 3=4d.
HasBBOX(geometry)
Retorna VERDADEIRO se o bbox desta geometria é armazenada, FALSO caso contrário.Usa
addBBOX() e dropBBOX() para armazenamento.ndims(geometry)
Retorna o número das dimensões da geometria como um inteiro. Valores são: 2,3 ou 4.
nrings(geometry)
Se a geometria for um polígono ou um multi-polígono, retorna o número de anéis.
npoints(geometry)
Retorna o número de pontos na geometria.
isvalid(geometry)
Retorna verdadeiro se esta geometria for válida.
expand(geometry, float)
Esta função retorna uma caixa delimitada expandida em todos os sentidos da caixa delimitada daentrada da geometria, por uma quantidade especificada no segundo argumento. Muito usada paraselecionar distance() , para adicionar um filtro do índice à seleção.
estimated_extent([schema], table, geocolumn)
Retorna a extensão estimada da tabela espacial dada. O estimado é feito de estatisticas de colunasgeométricas. O "schema"atual será usado se não especificado.
Capítulo 6. Referências de PostGIS http://webgis.com.br/postgis/docs/capitulo6_Referencias_PostGIS.htm...
21 de 31 29/01/2010 04:24
5/16/2018 PostGIS - Fun es e Extens es - slidepdf.com
http://slidepdf.com/reader/full/postgis-funcoes-e-extensoes 22/31
Para estatística PostgreSQL>=8.0.0 são recolhidos por VACUUM ANALYZE e a extensão resultanteserá aproximadamente 95% do real.Para estatística PostgreSQL<8.0.0 são recolhidos por update_geometry_stats() e a extensãoresultante será exata.
find_srid(varchar,varchar,varchar)
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 dageometria não for adicionada corretamente com a função de AddGeometryColumns(), esta funçãonão trabalhará tampouco.
mem_size(geometry)
Retorna a quantia de espaços (em bytes) encontrados na geometria.
numb_sub_objects(geometry)
Retorna o número dos objetos armazenados na geometria. Isto é utilizado para MULTI-geometrias e
GEOMETRYCOLLECTIONs.
point_inside_circle(geometry,float,float,float)
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, retornafalso.
xmin(box3d) ymin(box3d) zmin(box3d)
Retorna o mínimo solicitado de uma caixa delimitada.xmax(box3d) ymax(box3d) zmax(box3d)
Retorna o máximo solicitado de uma caixa delimitada.
Accum(geometry set)
Agregado. Constrói um conjunto de geometrias.
6.2.9. Suporte a grandes transações (Long Transactions)
Este módulo e funções associadas de pl/pgsql foram implementados para fornecer suporte a grandesbloqueios requerido por especificação Web Feature Service.
Nota
Os usuários devem usar serializable transaction level que caso contrário o mecanismo debloqueio quebraria.
EnableLongTransactions()
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
Capítulo 6. Referências de PostGIS http://webgis.com.br/postgis/docs/capitulo6_Referencias_PostGIS.htm...
22 de 31 29/01/2010 04:24
5/16/2018 PostGIS - Fun es e Extens es - slidepdf.com
http://slidepdf.com/reader/full/postgis-funcoes-e-extensoes 23/31
DisableLongTransactions()
Desabilita suporte a transações grandes. Esta função remove as tabelas metadados de suporte atransações grandes, e apaga todos os gatilhos às tabelas lock-checked .
Disponível: 1.1.3
CheckAuth([<schema>], <table>, <rowid_col>)
Verifica atualizações e deleções das linhas em dada tabela, sendo autorizada. Identifica linhasusando a coluna <rowid_col>.
Disponível: 1.1.3
LockRow([<schema>], <table>, <rowid>, <authid>, [<expires>])
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, 0caso contrário (já bloqueado pelo outro auth)
Disponível: 1.1.3
UnlockRows(<authid>)
Remove todos os bloqueios carregados por id de autorização especificada. Retorna o número dosbloqueios liberados.
Disponível: 1.1.3AddAuth(<authid>)
Adiciona um símbolo da autorização a ser usado na transação atual.Disponível: 1.1.3
6.3. Funções SQL-MM
Esta é uma listagem das funções definidas SQL-MM que PostGIS suporta atualmente. As implementaçõesdestas funções seguem a implementação ArcSDE e assim desviar-se um pouco das especificações. Estesdesvios serão notados.
As of version 1.2.0, these functions have been implemented by wrapping existing PostGIS functions. As aresult, 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 noPostGIS. Em conseqüência, o suporte cheio para geometrias curvadas para muitas funções não pode estarno lugar.
Nota
SQL-MM define o padrão SRID de todos construtores de geometrias como 0. PostGIS usaum padrão SRID de -1.
ST_Area
Return the area measurement of an ST_Surface or ST_MultiSurface value.
Capítulo 6. Referências de PostGIS http://webgis.com.br/postgis/docs/capitulo6_Referencias_PostGIS.htm...
23 de 31 29/01/2010 04:24
5/16/2018 PostGIS - Fun es e Extens es - slidepdf.com
http://slidepdf.com/reader/full/postgis-funcoes-e-extensoes 24/31
Retorna a medida da área de um valor ST_Surface ou ST_MultiSurface.
SQL-MM 3: 8.1.2, 9.5.3
ST_AsBinary
Retorna a representação binária well-known de um valor ST_Geometry.
SQL-MM 3: 5.1.37
ST_AsText
Retorna a representação de texto well-known de um valor ST_Geometry.
SQL-MM 3: 5.1.25
ST_Boundary
Retorna o limite do valor ST_Geometry.
SQL-MM 3: 5.1.14
ST_Buffer
Retorna um buffer em torno do valor ST_Geometry.
SQL-MM 3: 5.1.17
ST_Centroid
Retorna centroid matemático do valor ST_Surface ou ST_MultiSurface.
SQL-MM 3: 8.1.4, 9.5.5
ST_Contains
Testa se um valor ST_Geometry espacialmente contem um outro valor ST_Geometry.
SQL-MM 3: 5.1.31
ST_ConvexHull
Retorna o hull convexo do valor ST_Geometry.
SQL-MM 3: 5.1.16
ST_CoordDim
Returna a dimensão da coordenada do valor ST_Geometry.
SQL-MM 3: 5.1.3
ST_Crosses
Testa se um valor ST_Geometry espacialmente atravessa outro valor ST_Geometry.
SQL-MM 3: 5.1.29
ST_Difference
Capítulo 6. Referências de PostGIS http://webgis.com.br/postgis/docs/capitulo6_Referencias_PostGIS.htm...
24 de 31 29/01/2010 04:24
5/16/2018 PostGIS - Fun es e Extens es - slidepdf.com
http://slidepdf.com/reader/full/postgis-funcoes-e-extensoes 25/31
Returna um valor ST_Geometry que representa a diferença do conjunto de pontos de dois valoresST_Geometry.
SQL-MM 3: 5.1.20
ST_Dimension
Returna a dimensão do valor ST_Geometry.
SQL-MM 3: 5.1.2
ST_Disjoint
Testa se um valor ST_Geometry é espacialmente desconecta de outro valor ST_Geometry.
SQL-MM 3: 5.1.26
ST_Distance
Returna a distancia entre duas geometrias.
SQL-MM 3: 5.1.23
ST_EndPoint
Returna um valor ST_Point que é o ponto final de um valor ST_Curve.
SQL-MM 3: 7.1.4
ST_Envelope
Returna o retângulo delimitado para o valor ST_Geometry.
SQL-MM 3: 5.1.15
ST_Equals
Testa se um valor ST_Geometry é espacialmente igual a outro valor ST_Geometry.
SQL-MM 3: 5.1.24
ST_ExteriorRing
Returna o anel exterior de um ST_Surface.
SQL-MM 3: 8.2.3, 8.3.3
ST_GeometryN
Returna a indicação do valor ST_Geometry de um ST_GeomCollection.
SQL-MM 3: 9.1.5
ST_GeometryType
Returna o tipo geométrico do valor ST_Geometry.
SQL-MM 3: 5.1.4
Capítulo 6. Referências de PostGIS http://webgis.com.br/postgis/docs/capitulo6_Referencias_PostGIS.htm...
25 de 31 29/01/2010 04:24
5/16/2018 PostGIS - Fun es e Extens es - slidepdf.com
http://slidepdf.com/reader/full/postgis-funcoes-e-extensoes 26/31
ST_GeomFromText
Returna uma especificação do valor ST_Geometry.
SQL-MM 3: 5.1.40
ST_GeomFromWKB
Returna uma especificação do valor ST_Geometry.
SQL-MM 3: 5.1.41
ST_InteriorRingN
Returna o anel interior especificado de um valor ST_Surface.
SQL-MM 3: 8.2.6, 8.3.5
ST_Intersection
Returna um valor ST_Geometry que representa a interseção do conjunto de pontos de dois valoresST_Geometry.
SQL-MM 3: 5.1.18
ST_Intersects
Testa se um valor ST_Geometry intercepta espacialmente outro valor ST_Geometry.
SQL-MM 3: 5.1.27
ST_IsClosed
Testa se um valor ST_Curve ou um valor ST_MultiCurve está fechado.
Nota
SQL-MM define o resultado de ST_IsClosed(NULL) para ser 0, quando PostGISreturna NULO.
SQL-MM 3: 7.1.5, 9.3.3
ST_IsEmpty
Testa se um valor ST_Geometry corresponde à um conjunto vazio.
Nota
SQL-MM define o resultado de ST_IsEmpty(NULL) para ser 0, quando PostGISreturna NULO.
SQL-MM 3: 5.1.7
ST_IsRing
Testa se um valor ST_Curve é um anel.
Capítulo 6. Referências de PostGIS http://webgis.com.br/postgis/docs/capitulo6_Referencias_PostGIS.htm...
26 de 31 29/01/2010 04:24
5/16/2018 PostGIS - Fun es e Extens es - slidepdf.com
http://slidepdf.com/reader/full/postgis-funcoes-e-extensoes 27/31
Nota
SQL-MM define o resultado de ST_IsRing(NULL) para ser 0, quando PostGISreturna NULO.
SQL-MM 3: 7.1.6
ST_IsSimple
Testa se um valor ST_Geometry não tem pontos geométricos anomalos, como própria interseção ouprópria tangência.
Nota
SQL-MM define o resultado de ST_IsSimple(NULL) para ser 0, qunado PostGISreturna NULO.
SQL-MM 3: 5.1.8
ST_IsValid
Testa se um valor ST_Geometry está bem formado.
Nota
SQL-MM define o resultado de ST_IsValid(NULL) para ser 0, quando PostGISreturna NULO.
QL-MM define o resultado de ST_IsValid(NULL) para ser 1.
SQL-MM 3: 5.1.9
ST_Length
Returna a medida do comprimento de um valor ST_Curve ou um valor ST_MultiCurve.
SQL-MM 3: 7.1.2, 9.3.4
ST_LineFromText
Returna uma especificação do valor ST_LineString.
SQL-MM 3: 7.2.8
ST_LineFromWKB
Returna uma especificação de valor ST_LineString.
SQL-MM 3: 7.2.9
ST_MLineFromText
Returna uma espeficiação de valor ST_MultiLineString.
SQL-MM 3: 9.4.4
ST_MLineFromWKB
Capítulo 6. Referências de PostGIS http://webgis.com.br/postgis/docs/capitulo6_Referencias_PostGIS.htm...
27 de 31 29/01/2010 04:24
5/16/2018 PostGIS - Fun es e Extens es - slidepdf.com
http://slidepdf.com/reader/full/postgis-funcoes-e-extensoes 28/31
Returna uma especificação de valor ST_MultiLineString.
SQL-MM 3: 9.4.5
ST_MPointFromText
Returna uma especificação de valor ST_MultiPoint.
SQL-MM 3: 9.2.4
ST_MPointFromWKB
Returna uma especificação de valor ST_MultiPoint.
SQL-MM 3: 9.2.5
ST_MPolyFromText
Returna uma especificação de valor ST_MultiPolygon.
SQL-MM 3: 9.6.4
ST_MPolyFromWKB
Returna uma especificação de valor ST_MultiPolygon.
SQL-MM 3: 9.6.5
ST_NumGeometries
Returna o número de geometrias em um ST_GeomCollection.
SQL-MM 3: 9.1.4
ST_NumInteriorRing
Returna o número de asnéis interiores em um ST_Surface.
SQL-MM 3: 8.2.5
ST_NumPoints
Returna o número de pontos em um valor ST_LineString ou um valor ST_CircularString.
SQL-MM 3: 7.2.4
ST_OrderingEquals
ST_OrderingEquals compara duas geometrias e t (TRUE) se as geometrias são iguais e ascoordenadas estão na mesma ordem; caso contrário retorna f (FALSE).
Nota
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
Capítulo 6. Referências de PostGIS http://webgis.com.br/postgis/docs/capitulo6_Referencias_PostGIS.htm...
28 de 31 29/01/2010 04:24
5/16/2018 PostGIS - Fun es e Extens es - slidepdf.com
http://slidepdf.com/reader/full/postgis-funcoes-e-extensoes 29/31
ST_Overlaps
Testa se um valor ST_Geometry sobrepõe camadas espacialmente a outro valor ST_Geometry.
SQL-MM 3: 5.1.32
ST_Perimeter
Returna a medida do comprimento do limite de um valor ST_Surface ou de um valorST_MultiRSurface.
SQL-MM 3: 8.1.3, 9.5.4
ST_Point
Returna um ST_Point com os valores de coordenadas dadas.
SQL-MM 3: 6.1.2
ST_PointFromText
Returna uma especificação de valor ST_Point.
SQL-MM 3: 6.1.8
ST_PointFromWKB
Returna uma especificação de valor ST_Point.
SQL-MM 3: 6.1.9
ST_PointN
Returna uma especificação de valor ST_Point em um ST_LineString ou ST_CircularString.
SQL-MM 3: 7.2.5, 7.3.5
ST_PointOnSurface
Returna um valor ST_Point garantido para interseção espacialmente do valor ST_Surface ouST_MultiSurface.
SQL-MM 3: 8.1.5, 9.5.6ST_PolyFromText
Returna uma especificação de valor ST_Polygon.
SQL-MM 3: 8.3.6
ST_PolyFromWKB
Returna uma especificação de valor ST_Polygon.
SQL-MM 3: 8.3.7
ST_Polygon
Returna uma construção de polígono de uma linestring especificada e SRID.
Capítulo 6. Referências de PostGIS http://webgis.com.br/postgis/docs/capitulo6_Referencias_PostGIS.htm...
29 de 31 29/01/2010 04:24
5/16/2018 PostGIS - Fun es e Extens es - slidepdf.com
http://slidepdf.com/reader/full/postgis-funcoes-e-extensoes 30/31
SQL-MM 3: 8.3.2
ST_Relate
Testa se um valor ST_Geometry é relatado espacialmente à outro valor ST_Geometry.
SQL-MM 3: 5.1.25
ST_SRIDReturna o identificador de sistema de referência espacial do valor ST_Geometry.
SQL-MM 3: 5.1.5
ST_StartPoint
Returna um valor ST_Point que é o ponto inicial de um valor ST_Curve.
SQL-MM 3: 7.1.3
ST_SymDifference
Returna um valor ST_Geometry que representa a diferença simétrica de um conjunto de pontos dedois valores ST_Geometry.
SQL-MM 3: 5.1.21
ST_Touches
Testa se um valor ST_Geometry tocado espacialmente por outro valor ST_Geometry.
SQL-MM 3: 5.1.28
ST_Transform
Returna um valor ST_Geometry transformado para sistema de referência espacial especificado.
SQL-MM 3: 5.1.6
ST_Union
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
ST_Within
Testa se um valor ST_Geometry é espacialmente dentro de outro valor ST_Geometry.
SQL-MM 3: 5.1.30
ST_WKBToSQL
Returna um valor ST_Geometry para uma dada representação binária well-known.
SQL-MM 3: 5.1.36
ST_WKTToSQL
Capítulo 6. Referências de PostGIS http://webgis.com.br/postgis/docs/capitulo6_Referencias_PostGIS.htm...
0 de 31 29/01/2010 04:24
5/16/2018 PostGIS - Fun es e Extens es - slidepdf.com
http://slidepdf.com/reader/full/postgis-funcoes-e-extensoes 31/31
Returna um valor ST_Geometry para uma dada representação de texto well-known.
SQL-MM 3: 5.1.34
ST_X
Returna o valor da coordenada x de um valor ST_Point.
SQL-MM 3: 6.1.3
ST_Y
Returna o valor da coordenada y de um valoST_Point.
SQL-MM 3: 6.1.4
6.4. Funções ArcSDE
As funções adicionais foram acrescidas para melhorar o suporte a uma interface de estilo ArcSDE.
SE_EnvelopesIntersect
Returna t (TRUE) se os envelopes de duas interseções de geometrias; caso contrário, returna f (FALSE).
SE_Is3d
Testa se um valor de geometria tem valores de coordenada z.
SE_IsMeasured
Testa se um valor de geometria tem valores de coordenada m.
SE_LocateAlong
Returna um valor de coleção de geometria derivada com elementos que combinam a medidaespecificada.
SE_LocateBetween
Returna um valor de coleção de geometria derivada com elementos que combinam a escala
especificada das medidas inclusive.SE_M
Returna o valor da coordenada m de um valor ST_Point.
SE_Z
Returna o valor da coordenada z de um valor ST_Point.
Anterior Página Inicial Próxima
Capítulo 5. Tipos de Performance Início Capítulo 7. Relatando Erros
Capítulo 6. Referências de PostGIS http://webgis.com.br/postgis/docs/capitulo6_Referencias_PostGIS.htm...