Le funzioni elencate sotto sono quelle di cui un utente PostGIS avrà più probabilmente bisogno. Ci sono altre funzioni, di supporto agli oggetti PostGIS, che non sono utili all'utente comune.
PostGIS ha iniziato una transizione dalla namin convention esistente a una convenzione SQL-MM-centrica. Di conseguenza, molte funzioni di uso comune sono state rinominate usando il prefisso standard "spatial type" (ST). Le funzioni precedenti sono tuttora disponibili, anche se non elencate nel presente documento. Al loro posto sono presenti le funzioni aggiornate corrispondenti. Le funzioni non ST_ che mancano in questo documento sono deprecate e verranno eliminate in una futura release, quindi NON VANNO PIÙ USATE. |
Questa sezione elenca i tipi di dati PostgreSQL personalizzati installati da PostGIS per rappresentare i dati spaziali.
Ogni tipo di dati descrive il suo comportamento di conversione di tipo. Un cast di tipo converte i valori di un tipo di dati in un altro tipo. PostgreSQL consente di definire il comportamento di conversione per i tipi personalizzati, insieme alle funzioni utilizzate per convertire i valori del tipo. I cast possono avere un comportamento automatico, che consente la conversione automatica di un argomento di funzione in un tipo supportato dalla funzione.
Alcuni cast hanno un comportamento esplicito, il che significa che il cast deve essere specificato usando la sintassi CAST(myval As sometype)
o myval::sometype
. Il casting esplicito evita il problema dei cast ambigui, che possono verificarsi quando si utilizza una funzione sovraccaricata che non supporta un determinato tipo. Ad esempio, una funzione può accettare un box2d o un box3d, ma non una geometria. Poiché la geometria ha un cast automatico per entrambi i tipi di box, questo produce un errore di "funzione ambigua". Per evitare l'errore, utilizzare un cast esplicito al tipo di box desiderato.
Tutti i tipi di dati possono essere convertiti in text
, quindi non è necessario specificarlo esplicitamente.
Queste funzioni aiutano a definire tabelle contenenti colonne geometriche.
geometry_dump
rows for the components of a geometry.
geometry_dump
rows for the coordinates in a geometry.
geometry_dump
rows for the segments in a geometry.
geometry_dump
rows for the exterior and interior rings of a Polygon.
TRUE
se il punto iniziale e quello finale di LINESTRING
coincidono. Per le superfici poliedriche indica una superficie chiusa (volumetrica).
Queste funzioni creano geometrie modificate cambiando tipo, struttura o vertici.
These functions test whether geometries are valid according to the OGC SFS standard. They also provide information about the nature and location of invalidity. There is also a function to create a valid geometry out of an invalid one.
valid_detail
row stating if a geometry is valid or if not a reason and a location.
These functions work with the Spatial Reference System of geometries as defined in the spatial_ref_sys
table.
Queste funzioni creano oggetti geometrici da vari formati testuali o binari.
LINESTRING
da WKB con il SRID indicato
Queste funzioni convertono gli oggetti geometrici in vari formati testuali o binari.
TRUE
if A's 2D bounding box intersects B's 2D bounding box.
TRUE
if a geometry's (cached) 2D bounding box intersects a 2D float precision bounding box (BOX2DF).
TRUE
if a 2D float precision bounding box (BOX2DF) intersects a geometry's (cached) 2D bounding box.
TRUE
if two 2D float precision bounding boxes (BOX2DF) intersect each other.
TRUE
if A's n-D bounding box intersects B's n-D bounding box.
TRUE
if a geometry's (cached) n-D bounding box intersects a n-D float precision bounding box (GIDX).
TRUE
if a n-D float precision bounding box (GIDX) intersects a geometry's (cached) n-D bounding box.
TRUE
if two n-D float precision bounding boxes (GIDX) intersect each other.
TRUE
if A's bounding box overlaps or is to the left of B's.
TRUE
if A's bounding box overlaps or is below B's.
TRUE
if A' bounding box overlaps or is to the right of B's.
TRUE
if A's bounding box is strictly to the left of B's.
TRUE
if A's bounding box is strictly below B's.
TRUE
if the coordinates and coordinate order geometry/geography A are the same as the coordinates and coordinate order of geometry/geography B.
TRUE
if A's bounding box is strictly to the right of B's.
TRUE
if A's bounding box is contained by B's.
TRUE
if a geometry's 2D bounding box is contained into a 2D float precision bounding box (BOX2DF).
TRUE
if a 2D float precision bounding box (BOX2DF) is contained into a geometry's 2D bounding box.
TRUE
if a 2D float precision bounding box (BOX2DF) is contained into another 2D float precision bounding box.
TRUE
if A's bounding box overlaps or is above B's.
TRUE
if A's bounding box is strictly above B's.
TRUE
if A's bounding box contains B's.
TRUE
if a geometry's 2D bonding box contains a 2D float precision bounding box (GIDX).
TRUE
if a 2D float precision bounding box (BOX2DF) contains a geometry's 2D bonding box.
TRUE
if a 2D float precision bounding box (BOX2DF) contains another 2D float precision bounding box (BOX2DF).
TRUE
if A's bounding box is the same as B's.
Queste funzioni determinano la relazione spaziale tra due geometrie.
These functions compute measurements of distance, area and angles. There are also functions to compute geometry values determined by measurements.
ST_Length
ST_Perimeter
.
These functions compute results arising from the overlay of two geometries. These are also known as point-set theoretic boolean operations. Some related functions are also provided.
These functions compute geometric constructions, or alter geometry size or shape.
These functions operate on sets of polygonal geometry that form "implicit coverages". To form a valid coverage polygons must not overlap, and the vertices of adjacent edges must match exactly. Coverages are fast to process, and can be operated on with window functions, which retain the coverage topology inside the window partition while altering the edges.
These functions change the position and shape of geometries using affine transformations.
These functions implement clustering algorithms for sets of geometries.
These functions produce or operate on bounding boxes. They can also provide and accept geometry values, by using automatic or explicit casts.
See also Section 13.7, “Funzioni del box PostGIS”.
These functions support working with trajectories. A trajectory is a linear geometry with increasing measures (M value) on each coordinate. Spatio-temporal data can be modeled by using relative times (such as the epoch) as the measure values.
These functions report and upgrade PostGIS versions.
This section lists custom PostGIS Grand Unified Custom Variables (GUC). These can be set globally, by database, by session or by transaction. Best set at global or database level.
These functions are utilities for troubleshooting and repairing geometry data. They are only needed if the geometry data is corrupted in some way, which should never happen under normal circumstances.