IconOptions interface
Opzioni usate per personalizzare le icone in un SymbolLayer
- Extends
Proprietà
allow |
Specifica se l'icona del simbolo può sovrapporre altri simboli sulla mappa.
Se |
anchor | Specifica quale parte dell'icona viene posizionata più vicina alla posizione di ancoraggio delle icone sulla mappa. '"center"': il centro dell'icona è posizionato più vicino all'ancoraggio. '"left": il lato sinistro dell'icona è posizionato più vicino all'ancoraggio. '"right": il lato destro dell'icona è posizionato più vicino all'ancoraggio. '"top"': la parte superiore dell'icona è posizionata più vicina all'ancoraggio. '"bottom"': la parte inferiore dell'icona è posizionata più vicina all'ancoraggio. '"top-left": l'angolo superiore sinistro dell'icona viene posizionato più vicino all'ancoraggio. '"in alto a destra": l'angolo superiore destro dell'icona viene posizionato più vicino all'ancoraggio. '"in basso a sinistra": l'angolo inferiore sinistro dell'icona viene posizionato più vicino all'ancoraggio. '"in basso a destra": l'angolo in basso a destra dell'icona viene posizionato più vicino all'ancoraggio. Impostazione predefinita '"bottom"'. |
ignore |
Specifica se altri simboli possono sovrapporsi a questo simbolo.
Se true, altri simboli possono essere visibili anche se sono in confronto con l'icona.
Impostazione predefinita |
image | Nome dell'immagine nell'immagine della mappa sprite da usare per disegno dell'icona.
Le immagini predefinite disponibili sono: |
offset | Specifica una distanza di offset dell'icona dal relativo ancoraggio in pixel.
I valori positivi indicano destra e giù, mentre i valori negativi indicano sinistra e verso l'alto.
Ogni componente viene moltiplicato per il valore di dimensione per ottenere l'offset finale in pixel.
Se combinato con la rotazione, l'offset sarà come se la direzione ruotata fosse su.
Impostazione predefinita |
opacity | Numero compreso tra 0 e 1 che indica l'opacità in corrispondenza della quale verrà disegnata l'icona.
Impostazione predefinita |
optional | Specifica se un'icona dei simboli può essere nascosta, ma il testo visualizzato se si sovrappone a un altro simbolo.
Se true, il testo verrà visualizzato senza le icone corrispondenti quando l'icona si sbatte con altri simboli e il testo non viene visualizzato.
Impostazione predefinita |
padding | Dimensioni dell'area aggiuntiva intorno al rettangolo di selezione dell'icona usato per rilevare le collisioni dei simboli.
Impostazione predefinita |
pitch |
Specifica l'orientamento dell'icona quando viene inserita la mappa. '"auto": corrisponde automaticamente al valore di 'rotationAlignment'. '"map"': l'icona è allineata al piano della mappa. '"viewport"': l'icona è allineata al piano del riquadro di visualizzazione Impostazione predefinita '"auto"' |
rotation | Importo per ruotare l'icona in senso orario in gradi Default |
rotation |
In combinazione con la proprietà di posizionamento di un SymbolLayerOptions, questo determina il comportamento di rotazione delle icone. '"auto"': quando il posizionamento è "punto" equivale a "viewport". Quando la posizione è "linea" equivale a "mappa". '"map"': quando la posizione è "punto" allinea le icone a est-ovest. Quando il posizionamento è "line" allinea gli assi x delle icone con la linea. '"viewport"': Icone' assi x si allineano all'asse x del viewport. Impostazione predefinita '"auto"'. |
size | Ridimensiona le dimensioni originali dell'icona dal fattore specificato.
Deve essere maggiore o uguale a 0.
Impostazione predefinita |
Dettagli proprietà
allowOverlap
Specifica se l'icona del simbolo può sovrapporre altri simboli sulla mappa.
Se true
l'icona sarà visibile anche se si sbatte con altri simboli disegnati in precedenza.
Suggerimento: impostarlo su true se anima un simbolo per garantire il rendering uniforme.
Impostazione predefinita false
.
allowOverlap?: boolean
Valore della proprietà
boolean
anchor
Specifica quale parte dell'icona viene posizionata più vicina alla posizione di ancoraggio delle icone sulla mappa.
'"center"': il centro dell'icona è posizionato più vicino all'ancoraggio.
'"left": il lato sinistro dell'icona è posizionato più vicino all'ancoraggio.
'"right": il lato destro dell'icona è posizionato più vicino all'ancoraggio.
'"top"': la parte superiore dell'icona è posizionata più vicina all'ancoraggio.
'"bottom"': la parte inferiore dell'icona è posizionata più vicina all'ancoraggio.
'"top-left": l'angolo superiore sinistro dell'icona viene posizionato più vicino all'ancoraggio.
'"in alto a destra": l'angolo superiore destro dell'icona viene posizionato più vicino all'ancoraggio.
'"in basso a sinistra": l'angolo inferiore sinistro dell'icona viene posizionato più vicino all'ancoraggio.
'"in basso a destra": l'angolo in basso a destra dell'icona viene posizionato più vicino all'ancoraggio.
Impostazione predefinita '"bottom"'.anchor?: PositionAnchor | DataDrivenPropertyValueSpecification<PositionAnchor>
Valore della proprietà
PositionAnchor | DataDrivenPropertyValueSpecification<PositionAnchor>
ignorePlacement
Specifica se altri simboli possono sovrapporsi a questo simbolo.
Se true, altri simboli possono essere visibili anche se sono in confronto con l'icona.
Impostazione predefinita false
.
ignorePlacement?: boolean
Valore della proprietà
boolean
image
Nome dell'immagine nell'immagine della mappa sprite da usare per disegno dell'icona.
Le immagini predefinite disponibili sono: marker-black
marker-darkblue
pin-round-blue
pin-round-darkblue
marker-blue
marker-yellow
pin-round-red
marker-red
pin-blue
pin-darkblue
pin-red
, .
Impostazione predefinita "marker-blue"
.
image?: string | DataDrivenPropertyValueSpecification<string>
Valore della proprietà
string | DataDrivenPropertyValueSpecification<string>
offset
Specifica una distanza di offset dell'icona dal relativo ancoraggio in pixel.
I valori positivi indicano destra e giù, mentre i valori negativi indicano sinistra e verso l'alto.
Ogni componente viene moltiplicato per il valore di dimensione per ottenere l'offset finale in pixel.
Se combinato con la rotazione, l'offset sarà come se la direzione ruotata fosse su.
Impostazione predefinita [0, 0]
.
offset?: Pixel | DataDrivenPropertyValueSpecification<Pixel>
Valore della proprietà
opacity
Numero compreso tra 0 e 1 che indica l'opacità in corrispondenza della quale verrà disegnata l'icona.
Impostazione predefinita 1
.
opacity?: number | DataDrivenPropertyValueSpecification<number>
Valore della proprietà
number | DataDrivenPropertyValueSpecification<number>
optional
Specifica se un'icona dei simboli può essere nascosta, ma il testo visualizzato se si sovrappone a un altro simbolo.
Se true, il testo verrà visualizzato senza le icone corrispondenti quando l'icona si sbatte con altri simboli e il testo non viene visualizzato.
Impostazione predefinita false
.
optional?: boolean
Valore della proprietà
boolean
padding
Dimensioni dell'area aggiuntiva intorno al rettangolo di selezione dell'icona usato per rilevare le collisioni dei simboli.
Impostazione predefinita 2
.
padding?: number | DataDrivenPropertyValueSpecification<number>
Valore della proprietà
number | DataDrivenPropertyValueSpecification<number>
pitchAlignment
Specifica l'orientamento dell'icona quando viene inserita la mappa.
'"auto": corrisponde automaticamente al valore di 'rotationAlignment'.
'"map"': l'icona è allineata al piano della mappa.
'"viewport"': l'icona è allineata al piano del riquadro di visualizzazione
Impostazione predefinita '"auto"'pitchAlignment?: "auto" | "map" | "viewport"
Valore della proprietà
"auto" | "map" | "viewport"
rotation
Importo per ruotare l'icona in senso orario in gradi Default 0
.
rotation?: number | DataDrivenPropertyValueSpecification<number>
Valore della proprietà
number | DataDrivenPropertyValueSpecification<number>
rotationAlignment
In combinazione con la proprietà di posizionamento di un SymbolLayerOptions, questo determina il comportamento di rotazione delle icone.
'"auto"': quando il posizionamento è "punto" equivale a "viewport". Quando la posizione è "linea" equivale a "mappa".
'"map"': quando la posizione è "punto" allinea le icone a est-ovest. Quando il posizionamento è "line" allinea gli assi x delle icone con la linea.
'"viewport"': Icone' assi x si allineano all'asse x del viewport.
Impostazione predefinita '"auto"'.rotationAlignment?: "auto" | "map" | "viewport"
Valore della proprietà
"auto" | "map" | "viewport"
size
Ridimensiona le dimensioni originali dell'icona dal fattore specificato.
Deve essere maggiore o uguale a 0.
Impostazione predefinita 1
.
size?: number | DataDrivenPropertyValueSpecification<number>
Valore della proprietà
number | DataDrivenPropertyValueSpecification<number>