CurvePolygon
Si applica a:
SQL ServerDatabase SQL di AzureIstanza gestita di SQL di Azure
Un CurvePolygon è una superficie topologicamente chiusa definita da un anello di delimitazione esterno e nessuno o più anelli interni
Importante
Per una descrizione dettagliata ed esempi delle funzionalità spaziali introdotte in SQL Server 2012 (11.x), tra cui il sottotipo CurvePolygon, scaricare il white paper Nuove funzionalità spaziali in SQL Server 2012.
Nei criteri seguenti vengono definiti attributi di un'istanza CurvePolygon :
Il limite dell'istanza CurvePolygon viene definito dall'anello esterno e da tutti gli anelli interni.
L'interno dell'istanza CurvePolygon è lo spazio tra l'anello esterno e tutti gli anelli interni.
Un'istanza CurvePolygon differisce da un'istanza Polygon per il fatto che un'istanza CurvePolygon può contenere i segmenti di arco seguenti: CircularString e CompoundCurve.
Istanze CompoundCurve
L'illustrazione seguente mostra figure CurvePolygon valide:
Istanze accettate
Per poter essere accettata, un'istanza CurvePolygon deve essere vuota o contenere solo anelli di arco circolare accettati. Un anello di arco circolare accettato soddisfa i requisiti seguenti.
È un'istanza LineString, CircularStringo CompoundCurve accettata. Per altre informazioni sulle istanze accettate, vedere LineString, CircularStringe CompoundCurve.
Dispone almeno di quattro punti.
I punti iniziale e finale condividono le stesse coordinate X e Y.
Nota
I valori Z e ; vengono ignorati.
L'esempio seguente illustra le istanze CurvePolygon accettate.
DECLARE @g1 geometry = 'CURVEPOLYGON EMPTY';
DECLARE @g2 geometry = 'CURVEPOLYGON((0 0, 0 0, 0 0, 0 0))';
DECLARE @g3 geometry = 'CURVEPOLYGON((0 0 1, 0 0 2, 0 0 3, 0 0 3))'
DECLARE @g4 geometry = 'CURVEPOLYGON(CIRCULARSTRING(1 3, 3 5, 4 7, 7 3, 1 3))';
DECLARE @g5 geography = 'CURVEPOLYGON((-122.3 47, 122.3 -47, 125.7 -49, 121 -38, -122.3 47))';
@g3 viene accettata anche se i punti iniziale e finale hanno valori Z diversi perché i valori Z vengono ignorati. @g5 viene accettata anche se l'istanza del tipo geography non è valida.
Gli esempi seguenti generano System.FormatException.
DECLARE @g1 geometry = 'CURVEPOLYGON((0 5, 0 0, 0 0, 0 0))';
DECLARE @g2 geometry = 'CURVEPOLYGON((0 0, 0 0, 0 0))';
@g1 non viene accettata perché i punti iniziale e finale non hanno lo stesso valore Y. @g2 non viene accettata perché l'anello non dispone di un numero di punti sufficiente.
Istanze valide
Perché un'istanza CurvePolygon sia valida, è necessario che l'anello interno e quello esterno soddisfino i criteri seguenti:
- Possono toccarsi solo in corrispondenza di singoli punti tangenti.
- Non possono incrociarsi.
- Ogni anello deve contenere almeno quattro punti.
- Ogni anello deve essere un tipo di curva accettabile.
Le istanzeCurvePolygon devono inoltre soddisfare criteri specifici a seconda del fatto che siano del tipo di dati geometry o geography .
Tipo di dati geometry
Un'istanza geometryCurvePolygon valida deve avere gli attributi seguenti:
- Tutti gli anelli interni devono essere contenuti nell'anello esterno.
- Può disporre di più anelli interni, ma un anello interno non può contenere un altro anello interno.
- Nessun anello può incrociare se stesso o un altro anello.
- Gli anelli possono toccarsi solo in corrispondenza di singoli punti tangenti (il numero di punti dove gli anelli si toccano deve essere limitato).
- L'interno del poligono deve essere connesso.
L'esempio seguente illustra un'istanza geometryCurvePolygon valida.
DECLARE @g1 geometry = 'CURVEPOLYGON EMPTY';
DECLARE @g2 geometry = 'CURVEPOLYGON(CIRCULARSTRING(1 3, 3 5, 4 7, 7 3, 1 3))';
SELECT @g1.STIsValid(), @g2.STIsValid();
Le istanze CurvePolygon dispongono delle stesse regole di validità delle istanze Polygon, ad eccezione del fatto che le istanze CurvePolygon possono accettare i nuovi tipi di segmento di arco circolare. Per altri esempi di istanze valide o non valide, vedere Polygon.
Tipo di dati geography
Un'istanza geographyCurvePolygon valida deve avere gli attributi seguenti:
- L'interno del poligono viene connesso utilizzando il lato sinistro della regola.
- Nessun anello può incrociare se stesso o un altro anello.
- Gli anelli possono toccarsi solo in corrispondenza di singoli punti tangenti (il numero di punti dove gli anelli si toccano deve essere limitato).
- L'interno del poligono deve essere connesso.
Nell'esempio seguente viene illustrata un'istanza CurvePolygon geography valida.
DECLARE @g geography = 'CURVEPOLYGON((-122.3 47, 122.3 47, 125.7 49, 121 38, -122.3 47))';
SELECT @g.STIsValid();
Esempi
R. Creazione di un'istanza Geometry con un'istanza CurvePolygon vuota
Questo esempio illustra come creare un'istanza CurvePolygon vuota:
DECLARE @g geometry;
SET @g = geometry::Parse('CURVEPOLYGON EMPTY');
B. Dichiarazione e creazione di un'istanza Geometry utilizzando un'istanza CurvePolygon nella stessa istruzione
Questo frammento di codice illustra come dichiarare e inizializzare un'istanza geometry con un'istanza CurvePolygon nella stessa istruzione:
DECLARE @g geometry = 'CURVEPOLYGON(CIRCULARSTRING(2 4, 4 2, 6 4, 4 6, 2 4))'
C. Creazione di un'istanza Geography con un'istanza CurvePolygon
Questo frammento di codice illustra come dichiarare e inizializzare un'istanza geography con un'istanza CurvePolygonnella stessa istruzione:
DECLARE @g geography = 'CURVEPOLYGON(CIRCULARSTRING(-122.358 47.653, -122.348 47.649, -122.348 47.658, -122.358 47.658, -122.358 47.653))';
D. Archiviazione di un'istanza CurvePolygon con un solo anello di delimitazione esterno
Questo esempio illustra come archiviare un cerchio semplice in un'istanza CurvePolygon (per definire il cerchio viene utilizzato solo un anello di delimitazione esterno):
DECLARE @g geometry;
SET @g = geometry::Parse('CURVEPOLYGON(CIRCULARSTRING(2 4, 4 2, 6 4, 4 6, 2 4))');
SELECT @g.STArea() AS Area;
E. Archiviazione di un'istanza CurvePolygon contenente anelli interni
In questo esempio viene creato un anello in un'istanza CurvePolygon (per definire l'anello vengono utilizzati sia un anello di delimitazione esterno che un anello interno):
DECLARE @g geometry;
SET @g = geometry::Parse('CURVEPOLYGON(CIRCULARSTRING(0 4, 4 0, 8 4, 4 8, 0 4), CIRCULARSTRING(2 4, 4 2, 6 4, 4 6, 2 4))');
SELECT @g.STArea() AS Area;
Questo esempio illustra sia un'istanza CurvePolygon valida che un'istanza non valida in caso di utilizzo di anelli interni:
DECLARE @g1 geometry, @g2 geometry;
SET @g1 = geometry::Parse('CURVEPOLYGON(CIRCULARSTRING(0 5, 5 0, 0 -5, -5 0, 0 5), (-2 2, 2 2, 2 -2, -2 -2, -2 2))');
IF @g1.STIsValid() = 1
BEGIN
SELECT @g1.STArea();
END
SET @g2 = geometry::Parse('CURVEPOLYGON(CIRCULARSTRING(0 5, 5 0, 0 -5, -5 0, 0 5), (0 5, 5 0, 0 -5, -5 0, 0 5))');
IF @g2.STIsValid() = 1
BEGIN
SELECT @g2.STArea();
END
SELECT @g1.STIsValid() AS G1, @g2.STIsValid() AS G2;
Sia per @g1 che per @g2 viene usato lo stesso anello di delimitazione esterno: un cerchio con un raggio di 5 ed entrambi usano un quadrato per un anello interno. Tuttavia, l'istanza @g1 è valida, mentre l'istanza @g2 non lo è. @g2 è non valida perché l'anello interno divide lo spazio interno delimitato dall'anello esterno in quattro aree separate. Nel disegno seguente viene illustrata questa condizione:
Vedere anche
Polygon
CircularString
CompoundCurve
Guida di riferimento ai metodi per il tipo di dati geometry
Guida di riferimento ai metodi per il tipo di dati geography
Panoramica dei tipi di dati spaziali
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per