Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Funzioni costruttore

Le funzioni costruttore consentono di ottenere rappresentazioni binarie dei tipi di dati di geometria point, line o polygon. È inoltre possibile utilizzare queste funzioni per convertire dati binari in testo e ottenere valori binari per dati geometrici espressi come Known Text (). WKT

ST_AsBinary(geometry)

Restituisce un tipo di dati varbinary che contiene la WKB rappresentazione della geometria specificata. Esempio:

SELECT ST_AsBinary(ST_Point(-158.54, 61.56))

ST_AsText(geometry)

Converte ciascuno dei tipi di dati di geometria specificati in testo. Restituisce un valore in un tipo di dati varchar, che è una WKT rappresentazione del tipo di dati geometrico. Esempio:

SELECT ST_AsText(ST_Point(-158.54, 61.56))

ST_GeomAsLegacyBinary(geometry)

Restituisce un varbinary legacy dalla geometria specificata. Esempio:

SELECT ST_GeomAsLegacyBinary(ST_Point(-158.54, 61.56)

ST_GeometryFromText(varchar)

Converte il testo in WKT formato in un tipo di dati geometrico. Restituisce un valore in un tipo di dati di geometria. Esempio:

SELECT ST_GeometryFromText(ST_AsText(ST_Point(1, 2)))

ST_GeomFromBinary(varbinary)

Restituisce un oggetto di tipo geometrico da una rappresentazione. WKB Esempio:

SELECT ST_GeomFromBinary(ST_AsBinary(ST_Point(-158.54, 61.56)))

ST_GeomFromLegacyBinary(varbinary)

Restituisce un oggetto del tipo geometria da un tipo varbinary legacy. Esempio:

SELECT ST_GeomFromLegacyBinary(ST_GeomAsLegacyBinary(ST_Point(-158.54, 61.56)))

ST_LineFromText(varchar)

Restituisce un valore nel tipo di dati di geometria line. Esempio:

SELECT ST_Line('linestring(1 1, 2 2, 3 3)')

ST_LineString(array(point))

Restituisce un tipo di geometria LineString formato da un array di tipi di geometria puntiforme. Se nell'array specificato sono presenti meno di due punti non vuoti, viene restituita una LineString vuota. Restituisce un'eccezione se qualsiasi elemento nell'array è nullo o vuoto o identico a quello precedente. La geometria restituita potrebbe non essere semplice. A seconda dell'input specificato, la geometria restituita può auto-intersecarsi o contenere vertici duplicati. Esempio:

SELECT ST_LineString(ARRAY[ST_Point(-158.54, 61.56), ST_Point(-158.55, 61.56)])

ST_MultiPoint(array(point))

Restituisce un oggetto geometria MultiPoint formato dai punti specificati. Restituisce null se l'array specificato è vuoto. Restituisce un'eccezione se qualsiasi elemento nell'array è nullo o vuoto. La geometria restituita potrebbe non essere semplice e può contenere punti duplicati se l'array specificato ha duplicati. Esempio:

SELECT ST_MultiPoint(ARRAY[ST_Point(-158.54, 61.56), ST_Point(-158.55, 61.56)])

ST_Point(double, double)

Restituisce un oggetto di tipo di geometria point. Per i valori dei dati di input di questa funzione, utilizzate valori geometrici, come i valori nel sistema di coordinate cartesiane Universal Transverse Mercator (UTM) o le unità della mappa geografica (longitudine e latitudine) in gradi decimali. I valori di longitudine e latitudine utilizzano il World Geodetic System, noto anche come 1984, o:4326. WGS EPSG WGS1984 è il sistema di coordinate utilizzato dal Global Positioning System (). GPS

Ad esempio, nella notazione seguente le coordinate geografiche sono specificate in longitudine e latitudine e il valore .072284, che è la distanza buffer, è specificato in unità angolari come gradi decimali:

SELECT ST_Buffer(ST_Point(-74.006801, 40.705220), .072284)

Sintassi:

SELECT ST_Point(longitude, latitude) FROM earthquakes LIMIT 1

L'esempio esempio usa specifiche coordinate di longitudine e latitudine:

SELECT ST_Point(-158.54, 61.56)
FROM earthquakes
LIMIT 1

Il prossimo esempio usa specifiche coordinate di longitudine e latitudine:

SELECT ST_Point(-74.006801, 40.705220)

L'esempio seguente utilizza la ST_AsText funzione per ottenere la geometria da: WKT

SELECT ST_AsText(ST_Point(-74.006801, 40.705220)) AS WKT

ST_Polygon(varchar)

Utilizzando la sequenza delle ordinate fornite in senso orario, da sinistra a destra, restituisce un tipo di dati di geometria polygon. A partire dalla versione 2 del motore Athena, solo i poligoni sono accettati come input. Esempio:

SELECT ST_Polygon('polygon ((1 1, 1 4, 4 4, 4 1))') 

to_geometry(sphericalGeography)

Restituisce un oggetto geometria dall'oggetto geografico sferico specificato. Esempio:

SELECT to_geometry(to_spherical_geography(ST_Point(-158.54, 61.56)))

to_spherical_geography(geometry)

Restituisce un oggetto geografico sferico dalla geometria specificata. Utilizza questa funzione per convertire un oggetto geometrico in un oggetto geografico sferico sulla sfera del raggio terrestre. Questa funzione può essere utilizzata solo sulle geometrie POINT, MULTIPOINT, LINESTRING, MULTILINESTRING, POLYGON e MULTIPOLYGON definite nello spazio 2D o su GEOMETRYCOLLECTION di tali geometrie. Per ogni punto della geometria specificata, la funzione verifica che point.x si trovi all'interno di [-180.0, 180.0] e che point.y si trovi all'interno di [-90.0, 90.0]. La funzione utilizza questi punti come gradi di longitudine e latitudine per costruire la forma del risultato sphericalGeography.

Esempio:

SELECT to_spherical_geography(ST_Point(-158.54, 61.56))