postgis - funções e extensões

31
 Capítulo 6. Referências PostGIS Anterior  Próxima Capítul o 6. Refe rênci as Post GIS Índice 6.1. Funções OpenGIS 6.1.1. Funções de Gerenciamento 6.1.2. Funções de Relacionamento da Geometria 6.1.3. Funções de Processamento da Geometria 6.1.4. Assessores Geométricos 6.1.5. Construtores Geométricos 6.2. Extensões PostGIS 6.2.1. Funções de Gerenciamento 6.2.2. Operadores 6.2.3. Funções de Medida 6.2.4. Saída Geométricas 6.2.5. Construtores Geométricos 6.2.6. Editores Geométricos 6.2.7. Referência Linear 6.2.8. Variado 6.2.9. Suporte a grandes transações (Long Transactions) 6.3. Funções SQL-MM 6.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ão requeridas 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. F unções de Gerenciamento AddGeom etryColumn(v archar, var char, varchar , integer, varchar, integer) Si ntaxe: AddGeometryColum n(<schema_name>, <t able_nam e>, <column_nam e>, <srid>, < type>, <dimensi on>). Acrescenta uma coluna g eométrica a uma ta bela existente de atr ibutos . 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 '. DropGeom etryColumn(varchar, varchar, va rchar) Si ntaxe: DropGeom etryColum n(<schema_name>, <table_name>, <column_nam e>). Remove uma coluna geom étrica de uma tabela espacial. Note que o schema_name necessitará combin ar o campo do 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 de caixas de salto para "queries". Capítul o 6. Ref erências de PostGIS ht tp://webg i s.com .br/postg is/docs/capi t ulo6_Referen cias_Post GIS.htm... 1 de 31 29/01/2010 04:24

Upload: valeriambc

Post on 19-Jul-2015

358 views

Category:

Documents


1 download

TRANSCRIPT

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...