DEV (Thu 21 Sep 2023 07:23:39 AM UTC rev. 4395b1f )
Abstract
PostGIS é uma extensão para o sistema de banco de dados objeto-relacional PostgreSQL que permite que objetos SIG (Sistema de Informação Geográfica) sejam armazenados em banco de dados. O PostGIS inclui suporte a índices espaciais baseado em GiST R-Tree, e funções para analise e processamento de objetos SIG.
Este é o manual para a versão 3.5.0dev
This work is licensed under a Creative Commons Attribution-Share Alike 3.0 License. Feel free to use this material any way you like, but we ask that you attribute credit to the PostGIS Project and wherever possible, a link back to https://postgis.net.
Table of Contents
- 1. Introdução
- 2. Instalação do PostGIS
- 3. PostGIS Administration
- 4. Data Management
- 5. Spatial Queries
- 6. Dicas de desempenho
- 7. Referência do PostGIS
- 7.1. PostgreSQL PostGIS Geometry/Geography/Box Types
- box2d — The type representing a 2-dimensional bounding box.
- box3d — The type representing a 3-dimensional bounding box.
- geometry — geografia é um tipo de dado espacial usado para representar uma característica no sistema de coordenada da terra-redonda.
- geometry_dump — A composite type used to describe the parts of complex geometry.
- geography — The type representing spatial features with geodetic (ellipsoidal) coordinate systems.
- 7.2. Funções de Gestão
- AddGeometryColumn — Remove uma coluna geometria de uma spatial table.
- DropGeometryColumn — Remove uma coluna geometria de uma spatial table.
- DropGeometryTable — Derruba uma table e todas suas referências em geometry_columns.
- Find_SRID — Returns the SRID defined for a geometry column.
- Populate_Geometry_Columns — Ensures geometry columns are defined with type modifiers or have appropriate spatial constraints.
- UpdateGeometrySRID — Updates the SRID of all features in a geometry column, and the table metadata.
- 7.3. Construtores de geometria
- ST_Collect — Creates a GeometryCollection or Multi* geometry from a set of geometries.
- ST_LineFromMultiPoint — Cria uma linestring de um multiponto geométrico.
- ST_MakeEnvelope — Cria um polígono retangular formado a partir dos mínimos e máximos dados. Os valores de entrada devem ser em SRS especificados pelo SRID.
- ST_MakeLine — Cria uma Linestring de ponto, multiponto ou linha das geometrias.
- ST_MakePoint — Creates a 2D, 3DZ or 4D Point.
- ST_MakePointM — Cria um ponto com uma coordenada x y e medida.
- ST_MakePolygon — Creates a Polygon from a shell and optional list of holes.
- ST_Point — Creates a Point with X, Y and SRID values.
- ST_PointZ — Creates a Point with X, Y, Z and SRID values.
- ST_PointM — Creates a Point with X, Y, M and SRID values.
- ST_PointZM — Creates a Point with X, Y, Z, M and SRID values.
- ST_Polygon — Creates a Polygon from a LineString with a specified SRID.
- ST_TileEnvelope — Creates a rectangular Polygon in Web Mercator (SRID:3857) using the XYZ tile system.
- ST_HexagonGrid — Returns a set of hexagons and cell indices that completely cover the bounds of the geometry argument.
- ST_Hexagon — Returns a single hexagon, using the provided edge size and cell coordinate within the hexagon grid space.
- ST_SquareGrid — Returns a set of grid squares and cell indices that completely cover the bounds of the geometry argument.
- ST_Square — Returns a single square, using the provided edge size and cell coordinate within the square grid space.
- ST_Letters — Returns the input letters rendered as geometry with a default start position at the origin and default text height of 100.
- 7.4. Acessors de Geometria
- GeometryType — Retorna o tipo de geometria de valor ST_Geometry.
- ST_Boundary — Retorna o encerramento da borda combinatória dessa geometria.
- ST_BoundingDiagonal — Retorna a diagonal da geometria fornecida da caixa limitada.
- ST_CoordDim — Retorna a dimensão da coordenada do valor ST_Geometry.
- ST_Dimension — Retorna a dimensão da coordenada do valor ST_Geometry.
- ST_Dump — Returns a set of
geometry_dumprows for the components of a geometry. - ST_DumpPoints — Retorna um texto resumo dos conteúdos da geometria.
- ST_DumpSegments — Retorna um texto resumo dos conteúdos da geometria.
- ST_DumpRings — Returns a set of
geometry_dumprows for the exterior and interior rings of a Polygon. - ST_EndPoint — Retorna o número de pontos em um valor ST_LineString ou ST_CircularString.
- ST_Envelope — Retorna uma geometria representando a precisão da dobrada (float8) da caixa limitada da geometria fornecida.
- ST_ExteriorRing — Retorna o número de anéis interiores de um polígono.
- ST_GeometryN — Retorna o tipo de geometria de valor ST_Geometry.
- ST_GeometryType — Retorna o tipo de geometria de valor ST_Geometry.
- ST_HasArc — Tests if a geometry contains a circular arc
- ST_InteriorRingN — Retorna o número de anéis interiores de um polígono.
- ST_IsClosed — Retorna
VERDADEIROse os pontos de começo e fim daLINESTRINGsão coincidentes. Para superfície poliédrica está fechada (volumétrica). - ST_IsCollection — Retorna verdadeiro se essa geometria é uma coleção vazia, polígono, ponto etc.
- ST_IsEmpty — Tests if a geometry is empty.
- ST_IsPolygonCCW — Tests if Polygons have exterior rings oriented counter-clockwise and interior rings oriented clockwise.
- ST_IsPolygonCW — Tests if Polygons have exterior rings oriented clockwise and interior rings oriented counter-clockwise.
- ST_IsRing — Tests if a LineString is closed and simple.
- ST_IsSimple — Retorna (VERDADEIRA) se essa geometria não tem nenhum ponto irregular, como auto intersecção ou tangenciação.
- ST_M — Returns the M coordinate of a Point.
- ST_MemSize — Retorna o tipo de geometria de valor ST_Geometry.
- ST_NDims — Retorna a dimensão da coordenada do valor ST_Geometry.
- ST_NPoints — Retorna o número de pontos (vértices) em uma geometria.
- ST_NRings — Retorna o número de anéis interiores de um polígono.
- ST_NumGeometries — Retorna o número de pontos em uma geometria. Funciona para todas as geometrias.
- ST_NumInteriorRings — Retorna o número de anéis interiores de um polígono.
- ST_NumInteriorRing — Retorna o número de anéis interiores de um polígono na geometria. Sinônimo para ST_NumInteriorRings.
- ST_NumPatches — Retorna o número de faces em uma superfícies poliédrica. Retornará nulo para geometrias não poliédricas.
- ST_NumPoints — Retorna o número de pontos em um valor ST_LineString ou ST_CircularString.
- ST_PatchN — Retorna o tipo de geometria de valor ST_Geometry.
- ST_PointN — Retorna o número de pontos em um valor ST_LineString ou ST_CircularString.
- ST_Points — Retorna uma multilinestring contendo todas as coordenadas de uma geometria.
- ST_StartPoint — Returns the first point of a LineString.
- ST_Summary — Retorna um texto resumo dos conteúdos da geometria.
- ST_X — Returns the X coordinate of a Point.
- ST_Y — Returns the Y coordinate of a Point.
- ST_Z — Returns the Z coordinate of a Point.
- ST_Zmflag — Retorna a dimensão da coordenada do valor ST_Geometry.
- 7.5. Editores de geometria
- ST_AddPoint — Adicione um ponto para uma LineString.
- ST_CollectionExtract — Given a geometry collection, returns a multi-geometry containing only elements of a specified type.
- ST_CollectionHomogenize — Returns the simplest representation of a geometry collection.
- ST_CurveToLine — Converts a geometry containing curves to a linear geometry.
- ST_Scroll — Change start point of a closed LineString.
- ST_FlipCoordinates — Returns a version of a geometry with X and Y axis flipped.
- ST_Force2D — Força a geometria para o modo de 2 dimensões.
- ST_Force3D — Força a geometria para um modo XYZ. Este é um apelido para a função ST_Force_3DZ.
- ST_Force3DZ — Força as geometrias para o modo XYZ.
- ST_Force3DM — Força as geometrias para o modo XYM.
- ST_Force4D — Força as geometrias para o modo XYZM.
- ST_ForcePolygonCCW — Orients all exterior rings counter-clockwise and all interior rings clockwise.
- ST_ForceCollection — Converte a geometria para um GEOMETRYCOLLECTION.
- ST_ForcePolygonCW — Orients all exterior rings clockwise and all interior rings counter-clockwise.
- ST_ForceSFS — Força as geometrias a utilizarem os tipos disponíveis na especificação SFS 1.1.
- ST_ForceRHR — Força a orientação dos vértices em um polígono a seguir a regra da mão direita.
- ST_ForceCurve — Converte para cima uma geometria para seu tipo curvo, se aplicável.
- ST_LineToCurve — Converts a linear geometry to a curved geometry.
- ST_Multi — Restitui a geometria como uma MULTI* geometria.
- ST_LineExtend — Returns a line with the last and first segments extended the specified distance(s).
- ST_Normalize — Retorna a geometria na sua forma canônica.
- ST_Project — Returns a point projected from a start point by a distance and bearing (azimuth).
- ST_QuantizeCoordinates — Sets least significant bits of coordinates to zero
- ST_RemovePoint — Remove a point from a linestring.
- ST_RemoveRepeatedPoints — Returns a version of a geometry with duplicate points removed.
- ST_Reverse — Retorna a geometria com a ordem dos vértices revertida.
- ST_Segmentize — Returns a modified geometry/geography having no segment longer than a given distance.
- ST_SetPoint — Substitui ponto de uma linestring com um dado ponto.
- ST_ShiftLongitude — Shifts the longitude coordinates of a geometry between -180..180 and 0..360.
- ST_WrapX — Envolve uma geometria em torno de um valor X.
- ST_SnapToGrid — Rompe todos os pontos da geometria de entrada para uma rede regular.
- ST_Snap — Rompe segmentos e vértices de geometria de entrada para vértices de uma geometria de referência.
- ST_SwapOrdinates — Retorna uma versão da geometria dada com os valores ordenados dados trocados.
- 7.6. Geometry Validation
- ST_IsValid — Tests if a geometry is well-formed in 2D.
- ST_IsValidDetail — Returns a
valid_detailrow stating if a geometry is valid or if not a reason and a location. - ST_IsValidReason — Returns text stating if a geometry is valid, or a reason for invalidity.
- ST_MakeValid — Attempts to make an invalid geometry valid without losing vertices.
- 7.7. Spatial Reference System Functions
- ST_InverseTransformPipeline — Return a new geometry with coordinates transformed to a different spatial reference system using the inverse of a defined coordinate transformation pipeline.
- ST_SetSRID — Set the SRID on a geometry.
- ST_SRID — Returns the spatial reference identifier for a geometry.
- ST_Transform — Return a new geometry with coordinates transformed to a different spatial reference system.
- ST_TransformPipeline — Return a new geometry with coordinates transformed to a different spatial reference system using a defined coordinate transformation pipeline.
- postgis_srs_codes — Return the list of SRS codes associated with the given authority.
- postgis_srs — Return a metadata record for the requested authority and srid.
- postgis_srs_all — Return metadata records for every spatial reference system in the underlying Proj database.
- postgis_srs_search — Return metadata records for projected coordinate systems that have areas of useage that fully contain the bounds parameter.
- 7.8. Geometry Input
- 7.9. Geometry Output
- 7.10. Operadores
- 7.11. Spatial Relationships
- 7.12. Measurement Functions
- ST_Area — Retorna o centro geométrico de uma geometria.
- ST_Azimuth — Retorna a menor linha 2-dimensional entre duas geometrias
- ST_Angle — Retorna a linha 3-dimensional mais longa entre duas geometrias
- ST_ClosestPoint — Returns the 2D point on g1 that is closest to g2. This is the first point of the shortest line from one geometry to the other.
- ST_3DClosestPoint — Retorna o ponto 3 dimensional em g1 que é o mais próximo de g2. Este é o primeiro ponto da linha mais curta em três dimensões.
- ST_Distance — Retorna a linha 3-dimensional mais longa entre duas geometrias
- ST_3DDistance — Para tipo geometria, retorna a menor distância cartesiana 3-dimensional (baseado no sistema de referência espacial) entre duas geometrias em unidades projetadas.
- ST_DistanceSphere — Retorna a menor distância entre duas geometrias lon/lat dado um esferoide específico. As versões anteriores a 1.5 só suportam pontos.
- ST_DistanceSpheroid — Retorna a menor distância entre duas geometrias lon/lat dado um esferoide específico. As versões anteriores a 1.5 só suportam pontos.
- ST_FrechetDistance — Retorna a menor linha 3-dimensional entre duas geometrias
- ST_HausdorffDistance — Retorna a menor linha 3-dimensional entre duas geometrias
- ST_Length — Retorna o centro geométrico de uma geometria.
- ST_Length2D — Retorna o comprimento 2-dimensional da geometria se for uma linestring ou multi-linestring. Isto é um heterônimo para
ST_Length - ST_3DLength — Retorna o centro geométrico de uma geometria.
- ST_LengthSpheroid — Retorna o centro geométrico de uma geometria.
- ST_LongestLine — Retorna a linha 3-dimensional mais longa entre duas geometrias
- ST_3DLongestLine — Retorna a linha 3-dimensional mais longa entre duas geometrias
- ST_MaxDistance — Retorna a maior distância 2-dimensional entre duas geometrias em unidades projetadas.
- ST_3DMaxDistance — Para tipo de geometria retorna a maior distância 3-dimensional cartesiana (baseada na referência espacial) entre duas geometrias em unidade projetadas.
- ST_MinimumClearance — Retorna a liquidação mínima de uma geometria, uma medida de uma robustez de uma geometria.
- ST_MinimumClearanceLine — Retorna a LineString de dois pontos abrangendo a liquidação mínima de uma geometria.
- ST_Perimeter — Returns the length of the boundary of a polygonal geometry or geography.
- ST_Perimeter2D — Returns the 2D perimeter of a polygonal geometry. Alias for
ST_Perimeter. - ST_3DPerimeter — Retorna o centro geométrico de uma geometria.
- ST_ShortestLine — Retorna a menor linha 2-dimensional entre duas geometrias
- ST_3DShortestLine — Retorna a menor linha 3-dimensional entre duas geometrias
- 7.13. Overlay Functions
- ST_ClipByBox2D — Computes the portion of a geometry falling within a rectangle.
- ST_Difference — Computes a geometry representing the part of geometry A that does not intersect geometry B.
- ST_Intersection — Computes a geometry representing the shared portion of geometries A and B.
- ST_MemUnion — Aggregate function which unions geometries in a memory-efficent but slower way
- ST_Node — Nodes a collection of lines.
- ST_Split — Returns a collection of geometries created by splitting a geometry by another geometry.
- ST_Subdivide — Computes a rectilinear subdivision of a geometry.
- ST_SymDifference — Computes a geometry representing the portions of geometries A and B that do not intersect.
- ST_UnaryUnion — Computes the union of the components of a single geometry.
- ST_Union — Computes a geometry representing the point-set union of the input geometries.
- 7.14. Processamento de Geometria
- ST_Buffer — Computes a geometry covering all points within a given distance from a geometry.
- ST_BuildArea — Creates a polygonal geometry formed by the linework of a geometry.
- ST_Centroid — Retorna o centro geométrico de uma geometria.
- ST_ChaikinSmoothing — Returns a smoothed version of a geometry, using the Chaikin algorithm
- ST_ConcaveHull — Computes a possibly concave geometry that contains all input geometry vertices
- ST_ConvexHull — Computes the convex hull of a geometry.
- ST_DelaunayTriangles — Returns the Delaunay triangulation of the vertices of a geometry.
- ST_FilterByM — Removes vertices based on their M value
- ST_GeneratePoints — Generates a multipoint of random points contained in a Polygon or MultiPolygon.
- ST_GeometricMedian — Retorna a mediana de um MultiPonto.
- ST_LineMerge — Return the lines formed by sewing together a MultiLineString.
- ST_MaximumInscribedCircle — Retorna o centro geométrico de uma geometria.
- ST_LargestEmptyCircle — Computes the largest circle not overlapping a geometry.
- ST_MinimumBoundingCircle — Returns the smallest circle polygon that contains a geometry.
- ST_MinimumBoundingRadius — Returns the center point and radius of the smallest circle that contains a geometry.
- ST_OrientedEnvelope — Returns a minimum-area rectangle containing a geometry.
- ST_OffsetCurve — Returns an offset line at a given distance and side from an input line.
- ST_PointOnSurface — Computes a point guaranteed to lie in a polygon, or on a geometry.
- ST_Polygonize — Computes a collection of polygons formed from the linework of a set of geometries.
- ST_ReducePrecision — Returns a valid geometry with points rounded to a grid tolerance.
- ST_SharedPaths — Retorna uma coleção contendo caminhos compartilhados pelas duas linestrings/multilinestrings de entrada.
- ST_Simplify — Returns a simplified version of a geometry, using the Douglas-Peucker algorithm.
- ST_SimplifyPreserveTopology — Returns a simplified and valid version of a geometry, using the Douglas-Peucker algorithm.
- ST_SimplifyPolygonHull — Computes a simplifed topology-preserving outer or inner hull of a polygonal geometry.
- ST_SimplifyVW — Returns a simplified version of a geometry, using the Visvalingam-Whyatt algorithm
- ST_SetEffectiveArea — Sets the effective area for each vertex, using the Visvalingam-Whyatt algorithm.
- ST_TriangulatePolygon — Computes the constrained Delaunay triangulation of polygons
- ST_VoronoiLines — Returns the boundaries of the Voronoi diagram of the vertices of a geometry.
- ST_VoronoiPolygons — Returns the cells of the Voronoi diagram of the vertices of a geometry.
- 7.15. Coverages
- ST_CoverageInvalidEdges — Window function that finds locations where polygons fail to form a valid coverage.
- ST_CoverageSimplify — Window function that simplifies the edges of a polygonal coverage.
- ST_CoverageUnion — Computes the union of a set of polygons forming a coverage by removing shared edges.
- 7.16. Affine Transformations
- ST_Affine — Apply a 3D affine transformation to a geometry.
- ST_Rotate — Rotates a geometry about an origin point.
- ST_RotateX — Rotates a geometry about the X axis.
- ST_RotateY — Rotates a geometry about the Y axis.
- ST_RotateZ — Rotates a geometry about the Z axis.
- ST_Scale — Scales a geometry by given factors.
- ST_Translate — Translates a geometry by given offsets.
- ST_TransScale — Translates and scales a geometry by given offsets and factors.
- 7.17. Clustering Functions
- ST_ClusterDBSCAN — Window function that returns a cluster id for each input geometry using the DBSCAN algorithm.
- ST_ClusterIntersecting — Aggregate function that clusters input geometries into connected sets.
- ST_ClusterIntersectingWin — Window function that returns a cluster id for each input geometry, clustering input geometries into connected sets.
- ST_ClusterKMeans — Window function that returns a cluster id for each input geometry using the K-means algorithm.
- ST_ClusterWithin — Aggregate function that clusters geometries by separation distance.
- ST_ClusterWithinWin — Window function that returns a cluster id for each input geometry, clustering using separation distance.
- 7.18. Bounding Box Functions
- Box2D — Returns a BOX2D representing the 2D extent of a geometry.
- Box3D — Returns a BOX3D representing the 3D extent of a geometry.
- ST_EstimatedExtent — Returns the estimated extent of a spatial table.
- ST_Expand — Returns a bounding box expanded from another bounding box or a geometry.
- ST_Extent — Aggregate function that returns the bounding box of geometries.
- ST_3DExtent — Aggregate function that returns the 3D bounding box of geometries.
- ST_MakeBox2D — Creates a BOX2D defined by two 2D point geometries.
- ST_3DMakeBox — Creates a BOX3D defined by two 3D point geometries.
- ST_XMax — Returns the X maxima of a 2D or 3D bounding box or a geometry.
- ST_XMin — Returns the X minima of a 2D or 3D bounding box or a geometry.
- ST_YMax — Returns the Y maxima of a 2D or 3D bounding box or a geometry.
- ST_YMin — Returns the Y minima of a 2D or 3D bounding box or a geometry.
- ST_ZMax — Returns the Z maxima of a 2D or 3D bounding box or a geometry.
- ST_ZMin — Returns the Z minima of a 2D or 3D bounding box or a geometry.
- 7.19. Referência linear
- ST_LineInterpolatePoint — Returns a point interpolated along a line at a fractional location.
- ST_3DLineInterpolatePoint — Returns a point interpolated along a 3D line at a fractional location.
- ST_LineInterpolatePoints — Returns points interpolated along a line at a fractional interval.
- ST_LineLocatePoint — Returns the fractional location of the closest point on a line to a point.
- ST_LineSubstring — Returns the part of a line between two fractional locations.
- ST_LocateAlong — Returns the point(s) on a geometry that match a measure value.
- ST_LocateBetween — Returns the portions of a geometry that match a measure range.
- ST_LocateBetweenElevations — Returns the portions of a geometry that lie in an elevation (Z) range.
- ST_InterpolatePoint — Retorna o valor da dimensão de medida da geometria no ponto fechado para o ponto fornecido.
- ST_AddMeasure — Interpolates measures along a linear geometry.
- 7.20. Trajectory Functions
- ST_IsValidTrajectory — Tests if the geometry is a valid trajectory.
- ST_ClosestPointOfApproach — Returns a measure at the closest point of approach of two trajectories.
- ST_DistanceCPA — Returns the distance between the closest point of approach of two trajectories.
- ST_CPAWithin — Tests if the closest point of approach of two trajectories is within the specified distance.
- 7.21. SFCGAL Funções
- postgis_sfcgal_version — retorna a versão do SFCGAL em uso
- postgis_sfcgal_full_version — Returns the full version of SFCGAL in use including CGAL and Boost versions
- ST_3DArea — Computa a área de geometrias de superfície 3D. Irá retornar 0 para sólidos.
- ST_3DConvexHull — Computa o eixo mediano aproximado de uma geometria territorial.
- ST_3DIntersection — Representar intersecção 3D
- ST_3DDifference — Representar diferença 3D
- ST_3DUnion — Perform 3D union.
- ST_AlphaShape — Computes an Alpha-shape enclosing a geometry
- ST_ApproximateMedialAxis — Computa o eixo mediano aproximado de uma geometria territorial.
- ST_ConstrainedDelaunayTriangles — Return a constrained Delaunay triangulation around the given input geometry.
- ST_Extrude — Extrude uma superfície a um volume relacionado
- ST_ForceLHR — Orientação força LHR
- ST_IsPlanar — Verifique se a superfície é ou não planar
- ST_IsSolid — teste se a geometria é um sólido. Nenhuma verificação de validade é representada.
- ST_MakeSolid — Molde a geometria para um sólido. Nenhuma verificação é apresentada. Para obter um sólido válido, a geometria de entrada deve ser uma superfície poliédrica fechada ou um TIN fechado.
- ST_MinkowskiSum — Representar soma Minkowski
- ST_OptimalAlphaShape — Computes an Alpha-shape enclosing a geometry using an "optimal" alpha value.
- ST_Orientation — Determine orientação da superfície
- ST_StraightSkeleton — Calcule um esqueleto em linha reta de uma geometria
- ST_Tesselate — Representa superfície tesselação de um polígono ou superfície poliédrica e retorna como uma TIN ou coleção de TINS
- ST_Volume — Computa o volume de um sólido 3D. Se aplicado a geometrias com superfícies (mesmo fechadas), irão retornar 0.
- 7.22. Suporte de longas transações
- AddAuth — Adiciona um token de autorização para ser usado em transação atual.
- CheckAuth — Cria trigger em uma table para prevenir/permitir atualizações e exclusões de filas baseado em token de autorização.
- DisableLongTransactions — DesativarLongasTransações
- EnableLongTransactions — AtivarLongasTransações
- LockRow — Configurar fechamento/autorização para uma fileira específica na table
- UnlockRows — Removes all locks held by an authorization token.
- 7.23. Version Functions
- PostGIS_Extensions_Upgrade — Packages and upgrades PostGIS extensions (e.g. postgis_raster, postgis_topology, postgis_sfcgal) to given or latest version.
- PostGIS_Full_Version — Reports full PostGIS version and build configuration infos.
- PostGIS_GEOS_Version — Returns the version number of the GEOS library.
- PostGIS_GEOS_Compiled_Version — Returns the version number of the GEOS library against which PostGIS was built.
- PostGIS_Liblwgeom_Version — Returns the version number of the liblwgeom library. This should match the version of PostGIS.
- PostGIS_LibXML_Version — Returns the version number of the libxml2 library.
- PostGIS_Lib_Build_Date — Returns build date of the PostGIS library.
- PostGIS_Lib_Version — Returns the version number of the PostGIS library.
- PostGIS_PROJ_Version — Returns the version number of the PROJ4 library.
- PostGIS_Wagyu_Version — Returns the version number of the internal Wagyu library.
- PostGIS_Scripts_Build_Date — Returns build date of the PostGIS scripts.
- PostGIS_Scripts_Installed — Returns version of the PostGIS scripts installed in this database.
- PostGIS_Scripts_Released — Returns the version number of the postgis.sql script released with the installed PostGIS lib.
- PostGIS_Version — Returns PostGIS version number and compile-time options.
- 7.24. Grandes Variáveis Unificadas Personalizadas do PostGIS (GUCs)
- postgis.backend — O backend para fazer a manutenção de uma função onde GEOS e SFCGAL sobrepõe. Opções: geos ou sfcgal. Padrão para geos.
- postgis.gdal_datapath — Uma opção de configuração para designar o valor da opção GDAL_DATA do GDAL. Se não funcionar, a variável ambiental GDAL_DATA é usada.
- postgis.gdal_enabled_drivers — Uma opção de configuração para estabelecer os drivers GDAL ativados no ambiente POstGIS. Afeta a variável GDAL_SKIP do GDAL.
- postgis.enable_outdb_rasters — Uma opção de configuração booleana para ativar o acesso ao out-db raster bands.
- postgis.gdal_config_options — Uma opção de configuração booleana para ativar o acesso ao out-db raster bands.
- 7.25. Troubleshooting Functions
- PostGIS_AddBBox — Adicionar o retângulo envolvente a geometria.
- PostGIS_DropBBox — Exclui o cache de retângulos envolventes da geometria.
- PostGIS_HasBBox — Retorna verdadeiro se o retângulo desta geometria está cacheado. FALSO caso contrário.
- 8. Topologia
- 8.1. Tipos de topologia
- getfaceedges_returntype — A composite type that consists of a sequence number and an edge number.
- TopoGeometry — A composite type representing a topologically defined geometry.
- validatetopology_returntype — A composite type that consists of an error message and id1 and id2 to denote location of error. This is the return type for
ValidateTopology.
- 8.2. Domínios de Topologia
- TopoElement — Um arranjo de 2 inteiros geralmente usado para identificar um componente TopoGeometry.
- TopoElementArray — An array of TopoElement objects.
- 8.3. Gerenciamento de Topologia e TopoGeometria
- AddTopoGeometryColumn — Adiciona uma coluna topogeometria a uma table, registra essa coluna nova como uma camada topology.layer e retorna a nova layer_id.
- RenameTopoGeometryColumn — Renames a topogeometry column
- DropTopology — Cuidado ao usar: Derruba um esquema topologia e deleta sua referência da table topology.topology e referências para tables naquele esquema da table geometry_columns.
- RenameTopology — Renames a topology
- DropTopoGeometryColumn — Derruba a coluna topogeometria da table nomeada
table_nameno esquemaschema_namee tira os registros da - Populate_Topology_Layer — Adds missing entries to topology.layer table by reading metadata from topo tables.
- TopologySummary — Takes a topology name and provides summary totals of types of objects in topology.
- ValidateTopology — Returns a set of validatetopology_returntype objects detailing issues with topology.
- ValidateTopologyRelation — Returns info about invalid topology relation records
- FindTopology — Returns a topology record by different means.
- FindLayer — Returns a topology.layer record by different means.
- 8.4. Topology Statistics Management
- 8.5. Construtores de topologia
- CreateTopology — Creates a new topology schema and registers it in the topology.topology table.
- CopyTopology — Makes a copy of a topology (nodes, edges, faces, layers and TopoGeometries) into a new schema
- ST_InitTopoGeo — Creates a new topology schema and registers it in the topology.topology table.
- ST_CreateTopoGeo — Adiciona uma coleção de geometrias para uma dada topologia vazia e retorna uma mensagem detalhando sucesso.
- TopoGeo_AddPoint — Adiciona um ponto a uma topologia usando uma tolerância e possivelmente dividindo um limite existente.
- TopoGeo_AddLineString — Adds a linestring to an existing topology using a tolerance and possibly splitting existing edges/faces. Returns edge identifiers.
- TopoGeo_AddPolygon — Adds a polygon to an existing topology using a tolerance and possibly splitting existing edges/faces. Returns face identifiers.
- 8.6. Editores de Topologia
- ST_AddIsoNode — Adiciona um nó isolado a uma face em uma topologia e retorna a id do novo nó. Se a face é nula, o nó continua sendo criado.
- ST_AddIsoEdge — Adiciona um limite isolado definido pela geometria
alinestringa uma topologia conectando dois nós isoladosanodeeanothernodee retorna a nova id do novo limite. - ST_AddEdgeNewFaces — Adiciona um novo limite e, se uma face for dividida, deleta a face original e substitui por duas novas faces.
- ST_AddEdgeModFace — Adiciona um novo limite e, se uma face for dividida, modifica a face original e adiciona uma nova face.
- ST_RemEdgeNewFace — Remove um limite e, se o limite removido separava duas faces, deleta as faces originais e as substitui por uma nova face.
- ST_RemEdgeModFace — Removes an edge, and if the edge separates two faces deletes one face and modifies the other face to cover the space of both.
- ST_ChangeEdgeGeom — Modifica a forma de um limite sem afetar a estrutura da topologia.
- ST_ModEdgeSplit — Divide um limite criando um novo nó junto de um limite existente, modificando o limite original e adicionando um novo limite.
- ST_ModEdgeHeal — Heals two edges by deleting the node connecting them, modifying the first edge and deleting the second edge. Returns the id of the deleted node.
- ST_NewEdgeHeal — Heals two edges by deleting the node connecting them, deleting both edges, and replacing them with an edge whose direction is the same as the first edge provided.
- ST_MoveIsoNode — Moves an isolated node in a topology from one point to another. If new
apointgeometry exists as a node an error is thrown. Returns description of move. - ST_NewEdgesSplit — Divide um limite criando um novo nó ao longo do limite existente, deletando o limite original e substituindo-o por dois novos. Retorna a id do novo nó criado que integra os novos limites.
- ST_RemoveIsoNode — Remove um nó isolado e retorna descrição de ação. Se o nó não for isolado (for começo ou fim de um limite), então, uma exceção é lançada.
- ST_RemoveIsoEdge — Removes an isolated edge and returns description of action. If the edge is not isolated, then an exception is thrown.
- 8.7. Assessores de Topologia
- GetEdgeByPoint — Finds the edge-id of an edge that intersects a given point.
- GetFaceByPoint — Finds face intersecting a given point.
- GetFaceContainingPoint — Finds the face containing a point.
- GetNodeByPoint — Finds the node-id of a node at a point location.
- GetTopologyID — Retorna a id de uma topologia na table topology.topology dado o nome da topologia.
- GetTopologySRID — Retorna o SRID de uma topologia na table topology.topology dado o nome da topologia.
- GetTopologyName — Retorna o nome de uma topologia (esquema) dada a id da topologia.
- ST_GetFaceEdges — Retorna um conjunto de limites ordenados que amarram
aface. - ST_GetFaceGeometry — Retorna o polígono na topologia dada com a id de face especificada.
- GetRingEdges — Retorna o conjunto ordenado de identificadores de limites assinados, conhecidos caminhando em um lado da beirada.
- GetNodeEdges — Retorna um conjunto ordenado de limites incidentes no dado nó.
- 8.8. Processamento de Topologia
- Polygonize — Finds and registers all faces defined by topology edges.
- AddNode — Adiciona um ponto nó na table nó no esquema topológico específico e retorna a nodeid do novo nó. Se o ponto já existe, a nodeid é retornada.
- AddEdge — Adiciona uma linestring limite à edge table e os pontos de início e fim associados à table ponto nó do esquema de topologia especificado usando a linestring geometria específica e retorna a bordaid da nova borda (ou da borda já existente).
- AddFace — Registra uma face primitiva a uma topologia e pega seu identificador.
- ST_Simplify — Retorna uma versão "simplificada" da geometria da dada TopoGeometria usando o algorítimo Douglas-Peucker.
- RemoveUnusedPrimitives — Removes topology primitives which not needed to define existing TopoGeometry objects.
- 8.9. Construtores de TopoGeometria
- CreateTopoGeom — Cria uma novo objeto de topo geometria de um arranjo topo elemento - tg_type: 1:[multi]point, 2:[multi]line, 3:[multi]poly, 4:collection
- toTopoGeom — Converts a simple Geometry into a topo geometry.
- TopoElementArray_Agg — Returns a
topoelementarrayfor a set of element_id, type arrays (topoelements). - TopoElement — Converts a topogeometry to a topoelement.
- 8.10. Editores de TopoGeometria
- clearTopoGeom — Clears the content of a topo geometry.
- TopoGeom_addElement — Adds an element to the definition of a TopoGeometry.
- TopoGeom_remElement — Removes an element from the definition of a TopoGeometry.
- TopoGeom_addTopoGeom — Adds element of a TopoGeometry to the definition of another TopoGeometry.
- toTopoGeom — Adds a geometry shape to an existing topo geometry.
- 8.11. Assessores de TopoGeometria
- GetTopoGeomElementArray — Returns a
topoelementarray(an array of topoelements) containing the topological elements and type of the given TopoGeometry (primitive elements). - GetTopoGeomElements — Returns a set of
topoelementobjects containing the topological element_id,element_type of the given TopoGeometry (primitive elements). - ST_SRID — Returns the spatial reference identifier for a topogeometry.
- GetTopoGeomElementArray — Returns a
- 8.12. TopoGeometry Outputs
- AsGML — Retorna a representação GML de uma topogeometria.
- AsTopoJSON — Retorna a representação TopoJSON de uma topogeometria.
- 8.13. Relações de Topologia Espacial
- Equals — Retorna verdade se duas topogeometrias forem compostas da mesma topologia primitiva
- Intersects — Retorna verdade se algum par de primitivos das duas topologias se intersectar.
- 8.14. Importing and exporting Topologies
- 9. Gerência de dados raster, pesquisas e aplicações
- 9.1. Carregando e criando dados matriciais
- 9.2. Catálogos Raster
- 9.3. Construindo Aplicações Personalizadas com o PostGIS Raster
- 9.3.1. PHP Exemplo Outputting usando ST_AsPNG em consenso co outras funções raster
- 9.3.2. ASP.NET C# Exemplo gerado usando ST_AsPNG em consenso com outras funções raster
- 9.3.3. O app console Java que gera a consulta raster como arquivo de imagem
- 9.3.4. Use PLPython para excluir imagens via SQL
- 9.3.5. Rasters de saída com PSQL
- 10. Referência Raster
- 10.1. Tipos de suporte de dados raster
- geomval — Um tipo de dado espacial com dois campos - geom (possuindo objeto geométrico) e val (possuindo um valor de pixel de precisão dupla de uma banda raster).
- addbandarg — Um tipo composto usado como entrada na função ST_AddBand definindo os atributos e valor inicial da nova banda.
- rastbandarg — Um tipo composto para usar quando for preciso expressar um raster e um índice de banda desse raster.
- raster — raster spatial data type.
- reclassarg — Um tipo composto usado como entrada dentro da função ST_Reclass definindo o comportamento da reclassificação.
- summarystats — Um tipo composto retornado pelas funções ST_SummaryStats e ST_SummaryStatsAgg.
- unionarg — Um tipo composto usado como entrada dentro da função ST_Union definindo as bandas a serem processadas e o comportamento da operação UNIÃO.
- 10.2. Gerenciamento Raster
- AddRasterConstraints — Adds raster constraints to a loaded raster table for a specific column that constrains spatial ref, scaling, blocksize, alignment, bands, band type and a flag to denote if raster column is regularly blocked. The table must be loaded with data for the constraints to be inferred. Returns true if the constraint setting was accomplished and issues a notice otherwise.
- DropRasterConstraints — Derruba as restrições raster PostGIS que se referem a uma tabela de coluna raster. É útil se você precisar recarregar dados ou atualizar os dados da sua coluna raster.
- AddOverviewConstraints — Marca uma coluna raster como sendo um resumo de outra.
- DropOverviewConstraints — Desmarca uma coluna raster de ser um resumo de outra.
- PostGIS_GDAL_Version — Relata a versão da biblioteca GDAL em uso pelo PostGIS
- PostGIS_Raster_Lib_Build_Date — Relata a data da biblioteca raster construída completa.
- PostGIS_Raster_Lib_Version — Relata a versão raster completa e constrói informações de configuração.
- ST_GDALDrivers — Returns a list of raster formats supported by PostGIS through GDAL. Only those formats with can_write=True can be used by ST_AsGDALRaster
- ST_Contour — Generates a set of vector contours from the provided raster band, using the GDAL contouring algorithm.
- ST_InterpolateRaster — Interpolates a gridded surface based on an input set of 3-d points, using the X- and Y-values to position the points on the grid and the Z-value of the points as the surface elevation.
- UpdateRasterSRID — Altera o SRID de todos os rasters na coluna e tabela do usuário especificado.
- ST_CreateOverview — Cria uma resolução de versão reduzida de uma dada cobertura raster.
- 10.3. Construtores Raster
- ST_AddBand — Retorna um raster com nova banda(s) do tipo dado adicionado com o valor inicial com a localização do índice. Se nenhum índice for especificado, a banda é adicionada ao final.
- ST_AsRaster — Converte uma geometria PostGIS para um raster PostGIS.
- ST_Band — Retorna uma ou mais bandas de um raster existente como um novo raster. Útil para a construção de novos rasters a partir de rasters existentes.
- ST_MakeEmptyCoverage — Cover georeferenced area with a grid of empty raster tiles.
- ST_MakeEmptyRaster — Retorna um raster vazio (sem bandas) das dimensões dadas (width & height), o X e Y do superior esquerdo, tamanho de pixel e rotação (scalex, scaley, skewx & skewy) e sistema de referência (srid). Se um raster passar, retorna um novo raster com o mesmo tamanho, alinhamento e SRID. Se o srid é deixado de fora, a referência espacial se torna desconhecida (0).
- ST_Tile — Retorna um conjunto de rasters resultante de uma divisão do raster de entrada baseado nas dimensões desejadas nos rasters de saída.
- ST_Retile — Retorna um conjunto de tiles configuradas de uma cobertura raster aleatória.
- ST_FromGDALRaster — Retorna um raster de um arquivo raster GDAL suportado.
- 10.4. Assessores Raster
- ST_GeoReference — Retorna os metadados georreferenciados no formato GDAL ou ESRI como é comumente visto em um arquivo mundo. O padrão é GDAL.
- ST_Height — Retorna a altura do raster em pixeis.
- ST_IsEmpty — Retorna verdadeiro se o raster estiver vazio (largura = 0 e altura = 0). Senão, retorna falso.
- ST_MemSize — Retorna a quantidade de espaço (em bytes) que o raster pega.
- ST_MetaData — Retorna metadados básicos sobre um objeto raster como um tanho pixel, rotação (skew), esquerda superior, inferior etc.
- ST_NumBands — Retorna o número de bandas no objeto raster.
- ST_PixelHeight — Retorna a altura do pixel em unidades geométricas do sistema de referência espacial.
- ST_PixelWidth — Retorna a largura do pixel em unidades geométricas do sistema de referência espacial.
- ST_ScaleX — Retorna o componente X da largura do pixel em unidades do sistema de referência coordenadas.
- ST_ScaleY — Retorna o componente Y da altura do pixel em unidades do sistema de referência coordenadas.
- ST_RasterToWorldCoord — Retorna o canto superior esquerdo do raster como X e Y geométricos (longitude e latitude) dada a coluna e linha. Coluna e linha começam em 1.
- ST_RasterToWorldCoordX — Retorna a coordenada geométrica X superior esquerda de um raster, coluna ou linha. A numeração das colunas e linhas começam no 1.
- ST_RasterToWorldCoordY — Retorna a coordenada geométrica Y superior esquerda de um raster, coluna e linha. A numeração das colunas e linhas começam no 1.
- ST_Rotation — Retorna a rotação do raster em radianos.
- ST_SkewX — Retorna o desvio X georreferência (ou parâmetro e rotação).
- ST_SkewY — Retorna o desvio Y georreferência (ou parâmetro e rotação).
- ST_SRID — Retorna o identificador de referência espacial como definido na tabela spatial_ref_sys.
- ST_Summary — Retorna um texto resumo dos conteúdos do raster.
- ST_UpperLeftX — Retorna a coordenada X superior esquerda na ref. espacial projetada.
- ST_UpperLeftY — Retorna a coordenada Y superior esquerda na ref. espacial projetada.
- ST_Width — Retorna a largura do raster em pixeis.
- ST_WorldToRasterCoord — Retorna o canto superior esquerdo como coluna e linha dados os X e Y geométricos (longitude e latitude) ou um ponto expressado na coordenada do sistema de referência espacial do raster.
- ST_WorldToRasterCoordX — Retorna a coluna no raster do ponto (pt) ou uma coordenada X e Y (xw, yw) representada no sistema de referência espacial mundial de raster.
- ST_WorldToRasterCoordY — Retorna a linha no raster do ponto (pt) ou uma coordenada X e Y (xw, yw) representada no sistema de referência espacial global de raster.
- 10.5. Assessores de banda raster
- ST_BandMetaData — Retorna os metadados básicos para uma banda raster especificada. banda número 1 é assumida se nenhuma for especificada.
- ST_BandNoDataValue — Retorna o valor em uma dada banda que não representa nenhum valor. Se nenhuma banda número 1 for assumida.
- ST_BandIsNoData — Retorna verdadeiro se a banda estiver repleta somente de valores nodata.
- ST_BandPath — Retorna o caminho do arquivo do sistema para uma banda armazenada em um sistema de arquivos. Se nenhum número de banda for especificado, usa-se 1.
- ST_BandFileSize — Returns the file size of a band stored in file system. If no bandnum specified, 1 is assumed.
- ST_BandFileTimestamp — Returns the file timestamp of a band stored in file system. If no bandnum specified, 1 is assumed.
- ST_BandPixelType — Retorna o tipo pixel para uma dada banda. Se nenhum número de banda for especificado, usa-se 1.
- ST_MinPossibleValue — Retorna o número de bandas no objeto raster.
- ST_HasNoBand — Retorna verdade se não existirem bandas com números dados. Se nenhum número de banda for especificado, então assume-se a banda 1.
- 10.6. Assessores e Setters de Pixel Raster
- ST_PixelAsPolygon — Retorna o polígono que limita o pixel para uma linha e coluna específicas.
- ST_PixelAsPolygons — Retorna o polígono que limita cada pixel de uma banda raster ao longo do valor, as coordenadas raster X e Y de cada pixel.
- ST_PixelAsPoint — Retorna um ponto geométrico do canto superior esquerdo do pixel.
- ST_PixelAsPoints — Retorna um ponto geométrico para cada pixel de uma banda raster junto com o valor, as coordenas raster X e Y de cada pixel. As coordenadas do ponto são do ponto esquerdo superior do pixel.
- ST_PixelAsCentroid — Retorna o centroide (ponto) da área representada por um pixel.
- ST_PixelAsCentroids — Retorna o centroide (ponto geométrico) para cada pixel de uma banda raster junto com o valor, as coordenas raster X e Y de cada pixel. O ponto é o centroide da área representada por um pixel.
- ST_Value — Retorna o valor da banda dada com a colunax, linhay pixel ou em um ponto específico. Os números de banda começam em 1 e assumem-se 1 se não especificados. Se
exclude_nodata_valuefor falso, então todos os pixeis, inclusive osnodata, são considerados para intersectar e retornar valor. Seexclude_nodata_valuenão passar então lê dos metadados do raster. - ST_NearestValue — Retorna o valor não-
NODATAmais próximo de um dado pixel de banda especificado por uma colunax e linhay ou um ponto geométrico expressado no mesmo sistema de coordenada referência do raster. - ST_SetZ — Returns a geometry with the same X/Y coordinates as the input geometry, and values from the raster copied into the Z dimension using the requested resample algorithm.
- ST_SetM — Returns a geometry with the same X/Y coordinates as the input geometry, and values from the raster copied into the M dimension using the requested resample algorithm.
- ST_Neighborhood — Retorna um arranjo de precisão 2-D dobrada dos valores não-
NODATAem torno da banda de pixel especificada ou por uma colunaX e linhaY ou um ponto geométrico expressado no mesmo sistema de coordenada de referência especial como o raster. - ST_SetValue — Retorna o raster modificado resultante do valor de uma banda em uma dada colunax, linhay pixel ou os pixeis que intersectam uma geometria específica. Os números de banda começam no 1 e são assumidos como 1 se não estiverem especificados.
- ST_SetValues — Retorna o raster modificado resultante dos valores de uma dada banda.
- ST_DumpValues — Obtenha os valores da banda específica como um arranjo 2-dimensional.
- ST_PixelOfValue — Obtenha as coordenadas colunax, linhay do pixel cujos valores são iguais ao valor de pesquisa.
- 10.7. Editores Raster
- ST_SetGeoReference — Coloque os parâmetros Georeference 6 em uma única chamada. Os números deverão ser separadospor espaço branco. Aceita entrar no formato GDAL ou ESRI. O padrão é GDAL.
- ST_SetRotation — Põe a rotação do raster em radianos.
- ST_SetScale — Coloca os tamanhos X e Y dos pixeis em unidades do sistema referencial de coordenadas. Número unidades/pixel largura/altura.
- ST_SetSkew — Coloca as georreferências X e Y distorcidas (ou parâmetro de rotação). Se somente um passar, coloca o X e o Y no mesmo valor.
- ST_SetSRID — Coloca o SRID de um raster em um srid inteiro específico definido na tabela spatial_ref_sys.
- ST_SetUpperLeft — Sets the value of the upper left corner of the pixel of the raster to projected X and Y coordinates.
- ST_Resample — Resample um raster usando um algorítimo específico, novas dimensões, um canto aleatório da grade e um conjunto de rasters georreferenciando atributos definidos ou emprestados de outro raster.
- ST_Rescale — Resample a raster by adjusting only its scale (or pixel size). New pixel values are computed using the NearestNeighbor (english or american spelling), Bilinear, Cubic, CubicSpline, Lanczos, Max or Min resampling algorithm. Default is NearestNeighbor.
- ST_Reskew — Resample um raster ajustando somente sua inclinação (ou tamanho de pixel). Novos valores de pixel são calculados usando o algorítimo NearestNeighbor (english or american spelling), Bilinear, Cubic, CubicSpline ou Lanczos. O padrão é NearestNeighbor.
- ST_SnapToGrid — Resample um raster encaixando-o em uma grade. Novos valores de pixel são calculados usando o algorítimo NearestNeighbor (english or american spelling), Bilinear, Cubic, CubicSpline ou Lanczos. O padrão é NearestNeighbor.
- ST_Resize — Redimensiona largura/altura novas para um raster
- ST_Transform — Reprojeta um raster em um sistema de referência espacial conhecido para outro usando um algorítimo resampling especificado. As opções são NearestNeighbor, Bilinear, Cubic, CubicSpline, Lanczos com o padrão sendo NearestNeighbor.
- 10.8. Editores de Banda Raster
- ST_SetBandNoDataValue — Coloca o valor da banda que não representa nenhum dado. A banda 1 é assumida se nenhuma banda for especificada. Para marcar uma banda como tendo nenhum valor nodata, coloca ele = NULL.
- ST_SetBandIsNoData — Coloca a bandeira isnodata da banda como VERDADE.
- ST_SetBandPath — Update the external path and band number of an out-db band
- ST_SetBandIndex — Update the external band number of an out-db band
- 10.9. Análises e Estatísticas de Banda Raster
- ST_Count — Retorna o número de pixeis em uma banda dada de um raster ou cobertura raster. Se nenhuma banda for especificada, o padrão é usar a banda 1. Se exclude_nodata_value for verdade, contará somente pixeis que não são iguais ao valor nodata.
- ST_CountAgg — Agregado. Retorna o número de pixeis em uma banda dada de um raster ou cobertura raster. Se nenhuma banda for especificada, o padrão é usar a banda 1. Se exclude_nodata_value for verdade, contará somente pixeis que são diferentes ao valor NODATA.
- ST_Histogram — Retorna um conjunto de registros que resumem um raster ou distribuição de dados de cobertura raster intervalos bin separados. O número de bins é auto calculado.
- ST_Quantile — Calcula quantiles para um raster ou cobertura de tabela raster no contexto da amostra ou população. Assim, um valor poderia ser examinado para estar na porcentagem 25%, 50%, 75% do raster.
- ST_SummaryStats — Retorna as estatísticas resumidas consistindo de count, sum, mean, stddev, min, max para uma dada banda raster de um raster ou cobertura raster. A banda 1 é assumida se nenhuma banda for especificada.
- ST_SummaryStatsAgg — Agregado. Retorna as estatísticas resumidas consistindo de count, sum, mean, stddev, min, max para uma dada banda raster de um conjunto de rasters. A banda 1 é assumida se nenhuma banda for especificada.
- ST_ValueCount — Retorna o conjunto de registros contendo uma banda pixel de valor e conta do número de pixeis em uma dada banda de um raster (ou uma cobertura raster) que tem um dado conjunto de valores. Usa-se a banda 1 se nenhuma for especificada. Por padrão pixeis de valor nodata não são contados. Todos os outros valores no pixel são saída e os valores de pixeis são arredondados para o inteiro mais próximo.
- 10.10. Raster Inputs
- ST_RastFromWKB — Return a raster value from a Well-Known Binary (WKB) raster.
- ST_RastFromHexWKB — Return a raster value from a Hex representation of Well-Known Binary (WKB) raster.
- 10.11. Raster Outputs
- ST_AsBinary/ST_AsWKB — Return the Well-Known Binary (WKB) representation of the raster.
- ST_AsHexWKB — Return the Well-Known Binary (WKB) in Hex representation of the raster.
- ST_AsGDALRaster — Return the raster tile in the designated GDAL Raster format. Raster formats are one of those supported by your compiled library. Use ST_GDALDrivers() to get a list of formats supported by your library.
- ST_AsJPEG — Retorna as bandas tile raster selecionadas como uma única Joint Photographic Exports Group (JPEG) image (byte arranjo). Se nenhuma banda for especificada e 1 ou mais que 3 bandas, então somente a primeira banda é usada. Se somente 3 bandas, então todas as 3 bandas serão usadas para mapear par RGB.
- ST_AsPNG — Retorna as bandas tile raster selecionadas como um gráfico de rede portátil (PNG) imagem (byte array). Se as bandas raster 1, 3 ou 4 e nenhum banda for especificado, então todas as bandas são usadas. Se mais 2 ou mais que 4 bandas e nenhuma banda forem especificadas, então somente a banda 1 é usada. As bandas são mapeadas para espeço RGB ou RGBA.
- ST_AsTIFF — Return the raster selected bands as a single TIFF image (byte array). If no band is specified or any of specified bands does not exist in the raster, then will try to use all bands.
- 10.12. Processamento Raster
- ST_Clip — Retorna o raster suprimido pela geometria de entrada. Se o número de banda não for especificado, todas as bandas são processadas. Se
cropnão for especificado ou for VERDADE, o raster de saída é cortado. - ST_ColorMap — Cria um novo raster de até quatro bandas 8BUI (grayscale, RGB, RGBA) do raster fonte e uma banda específica. A banda 1 usada se não especificado.
- ST_Grayscale — Creates a new one-8BUI band raster from the source raster and specified bands representing Red, Green and Blue
- ST_Intersection — Retorna uma raster ou conjunto de pares de valores de pixeis de geometria representando a porção dividida de dois rasters ou a interseção geométrica de uma vetorização do raster e uma geometria.
- ST_MapAlgebra (callback function version) — Versão função retorno - Retorna um raster de uma banda dado um ou mais rasters de entrada, os índices e uma função retorno de um usuário específico.
- ST_MapAlgebra (expression version) — Versão expressão - Retorna um raster de uma banda dado um ou mais rasters de entrada, índices de banda e uma ou mais expressões SQL de usuários específicos.
- ST_MapAlgebraExpr — Versão de banda raster 1: Cria uma nova banda raster formada pela aplicação de ma operação algébrica válida do PostgreSQL na banda raster de entrada de um tipo de pixel fornecido. A banda 1 é assumida se nenhuma banda for especificada.
- ST_MapAlgebraExpr — Versão de banda raster 2: Cria uma banda raster nova formada pela aplicação de uma operação algébrica válida PostgreSQL nas duas bandas raster de entrada e do tipo de pixel fornecido. A banda 1 de cada raster é assumida se nenhum número de bandas for especificado. O raster resultante será alinhado (escala, inclinação e cantos de pixel) na grade definida pelo primeiro raster e tem sua extensão definida pelo parâmetro "extenttype". O valores para "extenttype" pode ser: INTERSEÇÃO, UNIÃO, PRIMEIRO, SEGUNDO.
- ST_MapAlgebraFct — Versão de banda raster 1: Cria uma nova banda raster formada pela aplicação de uma função válida do PostgreSQL na banda raster de entrada de um tipo de pixel fornecido. A banda 1 é assumida se nenhuma banda for especificada.
- ST_MapAlgebraFct — Versão de banda 2 - Cria uma nova banda raster um formada pela aplicação de uma função PostgreSQL na 2 entrada de bandas raster e do tipo de pixel fornecido. A banda 1 é assumida se nenhuma banda for especificada. Tipo de extensão torna-se INTERSEÇÃO se não especificada.
- ST_MapAlgebraFctNgb — Versão 1-banda: o vizinho mais próximo no mapa algébrico usando a função de usuário definido PostgreSQL. Retorna um raster cujos valores são o resultado de uma função usuário PLPGSQL envolvendo uma vizinhança de valores da banda raster de entrada.
- ST_Reclass — Cria um novo raster composto por tipos de banda reclassificados do original. A nband pode ser alterada. Se nenhuma nband for especificada, usa-se a 1. Todas as outras bandas são retornadas inalteradas. Use caso: converta uma banda 16BUI para 8BUI e então adiante para uma renderização mais simples como formatos visíveis.
- ST_Union — Retorna a união de um conjunto de tiles raster em um único raster composto de 1 ou mais bandas.
- ST_Clip — Retorna o raster suprimido pela geometria de entrada. Se o número de banda não for especificado, todas as bandas são processadas. Se
- 10.13. Funções retorno de mapa algébrico embutido
- ST_Distinct4ma — Função de processamento raster que calcula o resumo de valores únicos de pixel em uma vizinhança.
- ST_InvDistWeight4ma — Função de processamento raster que interpola um valor de pixel de uma vizinhança.
- ST_Max4ma — Função de processamento raster que calcula o valor máximo de pixel em uma vizinhança.
- ST_Mean4ma — Função de processamento raster que calcula o menor valor de pixel em uma vizinhança.
- ST_Min4ma — Função de processamento raster que calcula o valor mínimo de pixel em uma vizinhança.
- ST_MinDist4ma — Função de processamento raster que retorna a distância mínima (em números de pixeis) entre o pixel de interesse e um pixel vizinho de interesse com valor.
- ST_Range4ma — Função de processamento raster que calcula a varição de valores de pixel em uma vizinhança.
- ST_StdDev4ma — Função de processamento raster que calcula o padrão de divergência de valores de pixel em uma vizinhança.
- ST_Sum4ma — Função de processamento raster que calcula o resumo de todos os valores de pixel em uma vizinhança.
- 10.14. Processamento Raster
- ST_Aspect — Retorna o aspecto (em graus) de uma banda raster de elevação. Útil para analisar terrenos.
- ST_HillShade — Retorna a iluminação hipotética de uma banda raster de elevação usando as entradas de azimute, altitude, claridade e escala fornecidas.
- ST_Roughness — Retorna um raster com a "robustez" calculada de um DEM.
- ST_Slope — Retorna o declive (em graus) de uma banda raster de elevação. Útil para analisar terrenos.
- ST_TPI — Retorna um raster com o índice de posição topográfico calculado.
- ST_TRI — Retorna um raster com o índice de aspereza do terreno calculado.
- 10.15. Raster para Geometria
- Box3D — Retorna a representação da caixa 3d da caixa encerrada do raster.
- ST_ConvexHull — Retorna o casco convexo da geometria do raster incluindo valores iguais ao BandNoDataValue. Para rasters com formas normais e não desviadas, o resultado é o mesmo que ST_Envelope, então só é útil para rasters com formas irregulares ou desviados.
- ST_DumpAsPolygons — Retorna um conjunto de linhas geomval (geom,val), de uma dada banda raster. Se nenhum número de banda for especificado, o número de banda torna-se 1.
- ST_Envelope — Retorna a representação de polígono da extensão do raster.
- ST_MinConvexHull — Retorna a geometria de casco convexo do raster excluindo os pixeis SEM DADOS.
- ST_Polygon — Retorna um multipolígono formado pela união de pixeis que têm um valor que não é um valor sem dados. Se um número de banda for especificado, usa-se 1.
- 10.16. Operadores Raster
- && — Retorna
VERDADEse a caixa limitadora de A intersecta a caixa limitadora de B. - &< — Retorna
VERDADEse uma caixa limitadora de A está à esquerda da de B. - &> — Retorna
VERDADEse uma caixa limitadora de A está à direita da de B. - = — Retorna
VERDADEse a caixa limitadora de A for a mesma de B. Utiliza precisão dupla de caixa limitadora. - @ — Retorna
VERDADEse a caixa limitadora de A estiver contida pela de B. Utiliza precisão dupla de caixa limitadora. - ~= — Retorna
VERDADEse a caixa limitadora de A é a mesma de B. - ~ — Retorna
TRUEse a caixa delimitadora de A estiver contida na do B. Utiliza caixa delimitadora de precisão dupla.
- && — Retorna
- 10.17. Relações raster e raster de banda espacial
- ST_Contains — Retorna verdade se nenhum ponto do raster rasteB estiver no exterior do raster rastA e pelo menos um ponto do interior do rastB estiver no interior do rastA.
- ST_ContainsProperly — Retorna verdade se o rastB intersectar o interior do rastA, mas não o limite ou exterior do ratA.
- ST_Covers — Retorna verdade se nenhum ponto do rastB estiver de fora do rastA.
- ST_CoveredBy — Retorna verdade se nenhum ponto do rastA estiver de fora do rastB.
- ST_Disjoint — Retorna verdade se raster rastA não intersectar espacialmente com o rastB.
- ST_Intersects — Retorna verdade se o raster rastA intersectar espacialmente com o raster rastB.
- ST_Overlaps — Retorna verdade se o raster rastA e rastB se intersectam, mas um deles não contém o outro completamente.
- ST_Touches — Retorna verdade se o raster rastA e rastB têm pelo menos um ponto em comum, mas seus interiores não se intersectarem.
- ST_SameAlignment — Retorna verdade se os rasters têm a mesma inclinação, escala, referência espacial, e deslocamento (pixeis podem ser colocados na mesma grade sem cortar eles) e falso se eles não notificarem problemas detalhados.
- ST_NotSameAlignmentReason — Retorna a declaração de texto se os rasters estiverem alinhados e se não tiverem, uma razão do porquê.
- ST_Within — Retorna verdade se nenhum ponto do raster rastA estiver no exterior do raster rastB e pelo menos um ponto do interior do rastA estiver no interior do rastB.
- ST_DWithin — Retorna verdade se os rasters rastA e rastB estiverem dentro da distância especificada de cada um.
- ST_DFullyWithin — Retorna verdade se os rasters rastA e rastB estiverem completamente dentro da distância especificada de cada um.
- 10.18. Raster Tips
- 11. PostGIS Extras
- 11.1. Padronizador de endereço
- 11.2. Tiger Geocoder
- Drop_Indexes_Generate_Script — Gera uma script que derruba todas as chaves não primárias e indexes não únicos no esquema tiger e esquema especificado de usuário. Padroniza esquema para:
tiger_datase nenhum esquema é especificado. - Drop_Nation_Tables_Generate_Script — Gera uma script que derruba todas as tables no esquema específico que começa com
county_all,state_allou código de estado seguido porcondadoouestado. - Drop_State_Tables_Generate_Script — Gera uma script que derruba todas as tables no esquema específico que estão prefixados com abreviação do estado. Padroniza o esquema para
tiger_datase nenhum esquema estiver especificado. - Geocode — Assimila um endereço como uma string (ou outro endereço normalizado) e gera um conjunto de localizações possíveis que inclui um ponto em NAD 83 long lat, um endereço normalizado para cada um e a avaliação. Quanto menor a avaliação, maior a chance de combinar. Os resultados são separados com menor avaliação em primeiro lugar. Pode passar no resultados máximos, até 10, e restrict_region (padrão NULO)
- Geocode_Intersection — Assimila 2 ruas que se intersectam e um estado, cidade, zip, e gera um conjunto de possíveis localizações no primeiro cruzamento que está na intersecção, também inclui um geomout como o ponto de localização em NAD 83 long lat, um
normalized_address(addy) para cada localização, e a avaliação. Quanto menor a avaliação, maior a chance de combinar. Os resultados são separados com menor avaliação em primeiro lugar. Pode passar nos resultados máximos, até 10. Usa dados Tiger (limites, faces, addr), string confusa do PostgreSQL (soundex, evenshtein). - Get_Geocode_Setting — Retorna a configuração de valor específico armazenada na table tiger.geocode_settings.
- Get_Tract — Retorna o trecho ou campo de uma tract table onde a geometria está localizada. Padrão para retornar um nome curto para o trecho.
- Install_Missing_Indexes — Encontra todas as tables com colunas chave usadas no ingresso geocoder e condições de filtros que estão perdendo os indexes usados nessas colunas e irão adicionar elas.
- Loader_Generate_Census_Script — Gera uma shell script para a plataforma específica para os estados que irão baixar o trecho do censo de estado Tiger, bg e dados de tables tabblocks, arranjar e carregar dentro do esquema
tiger_data. Cada state script retornou como um relato separado. - Loader_Generate_Script — Gera uma shell script para a plataforma específica para os estados que irão baixar dados Tiger, arranjar e carregar dentro do esquema
tiger_data. Cada state script retorna como um registro separado. A versão mais nova suporta mudanças estruturais do Tiger 2010 e também carrega trecho do censo, block groups, e block tables. - Loader_Generate_Nation_Script — Gerar uma script shell para a plataforma especificada que carrega as lookup tables de condado e estado.
- Missing_Indexes_Generate_Script — Encontra todas as tables com colunas chave usadas no ingresso geocoder que estão perdendo indexes nessas colunas e irão gerar o SQL DDL para definir o index para essas tables.
- Normalize_Address — Dado um endereço em texto de uma rua, retorna um tipo composto
norm_addyque não tem um sufixo, prefixo e tipo padronizado, rua, nome de rua etc. quebrado e, campos separados. Essa função irá funcionar com os dados lookup compactados com o tiger_geocoder (dados do censo tiger não são necessários). - Pagc_Normalize_Address — Dado um endereço em texto de uma rua, retorna um tipo composto
norm_addyque não tem um sufixo, prefixo e tipo padronizado, rua, nome de rua etc. quebrado e, campos separados. Essa função irá funcionar com os dados lookup compactados com o tiger_geocoder (dados do censo tiger não são necessários). Requer a extensão address_standardizer. - Pprint_Addy — Dado um objeto de tipo composto
norm_addy, retorna uma representação impressa dele. Normalmente, usado em conjunto com o normalize_address. - Reverse_Geocode — Pega um ponto em um sistema de referência espacial conehcido e retorna um relato que contém um banco de dados de, teoricamente, possíveis endereços e um banco de dados de ruas cruzadas. Se include_strnum_range = verdade, inclui o alcance da rua nas ruas cruzadas.
- Topology_Load_Tiger — Carrega uma região definida de dados tiger em uma Topologia PostGIS e transforma os dados tiger para referência espacial da topologia e rompe para a tolerância precisa da topologia.
- Set_Geocode_Setting — Estabelece uma configuração que afeta comportamento das funções geocoder.
- Drop_Indexes_Generate_Script — Gera uma script que derruba todas as chaves não primárias e indexes não únicos no esquema tiger e esquema especificado de usuário. Padroniza esquema para:
- 12. PostGIS Special Functions Index
- 12.1. PostGIS Aggregate Functions
- 12.2. PostGIS Window Functions
- 12.3. PostGIS SQL-MM Compliant Functions
- 12.4. PostGIS Geography Support Functions
- 12.5. PostGIS Raster Support Functions
- 12.6. PostGIS Geometry / Geography / Raster Dump Functions
- 12.7. PostGIS Box Functions
- 12.8. PostGIS Functions that support 3D
- 12.9. PostGIS Curved Geometry Support Functions
- 12.10. PostGIS Polyhedral Surface Support Functions
- 12.11. PostGIS Function Support Matrix
- 12.12. New, Enhanced or changed PostGIS Functions
- 12.12.1. PostGIS Functions new or enhanced in 3.4
- 12.12.2. PostGIS Functions new or enhanced in 3.3
- 12.12.3. PostGIS Functions new or enhanced in 3.2
- 12.12.4. PostGIS Functions new or enhanced in 3.1
- 12.12.5. PostGIS Functions new or enhanced in 3.0
- 12.12.6. PostGIS Functions new or enhanced in 2.5
- 12.12.7. PostGIS Functions new or enhanced in 2.4
- 12.12.8. PostGIS Functions new or enhanced in 2.3
- 12.12.9. PostGIS Functions new or enhanced in 2.2
- 12.12.10. PostGIS Functions new or enhanced in 2.1
- 12.12.11. PostGIS Functions new or enhanced in 2.0
- 12.12.12. PostGIS Functions new or enhanced in 1.5
- 12.12.13. PostGIS Functions new or enhanced in 1.4
- 12.12.14. PostGIS Functions new or enhanced in 1.3
- 13. Reporting Problems
- A. Apêndice