Quando personalizzi uno stile della mappa, è utile capire in che modo lo stile di diverse funzionalità della mappa può influire su altri stili della mappa. Esistono diversi livelli che
si sovrappongono:
La mappa base: quando inizi a creare uno stile di mappa, lo stile iniziale che vedi è quello della mappa base, ovvero la mappa predefinita. Tutti gli elementi della mappa che non personalizzi mantengono lo stile della mappa base.
Stili di mappa: gli stili personalizzati sostituiscono gli stili del livello della mappa base.
In questa immagine, lo stile della mappa personalizzato sostituisce le aree urbane con il colore acquamarina
e le strade con il colore blu scuro.
Elementi di stile: ogni elemento della mappa ha uno o più elementi di stile che
puoi personalizzare. In questa immagine, il colore di riempimento del poligono dell'elemento della mappa delle aree urbane
è impostato su acquamarina, mentre il colore di riempimento della rete stradale
è impostato su blu.
Gerarchia degli elementi della mappa
All'interno di uno stile della mappa, gli elementi della mappa sono organizzati gerarchicamente, con quattro elementi della mappa generali in alto e tutti gli altri elementi della mappa disposti sotto di loro in una gerarchia logica. Per impostazione predefinita, un elemento della mappa eredita gli stili
dell'elemento della mappa sopra di esso nella gerarchia (il relativo elemento principale). Tuttavia, puoi
ignorare lo stile di primo livello impostando uno o più elementi di stile
per gli elementi della mappa sottostanti (elementi della mappa secondari). Per informazioni dettagliate sulla gerarchia delle funzionalità della mappa, consulta Elementi che puoi personalizzare in una mappa.
Ogni elemento della mappa ha uno o più elementi o parti che puoi personalizzare. Ad esempio, il colore di riempimento del poligono (la forma della funzionalità della mappa) è un elemento, così come il colore del tratto dell'etichetta di testo. Puoi definire lo stile
di ogni elemento separatamente e qualsiasi elemento a cui non applichi uno stile mantiene lo stile
predefinito. Poiché gli elementi sono separati, puoi applicare uno stile al colore di riempimento del testo
dell'etichetta e lasciare il colore del tratto (contorno) come predefinito (o ereditato
da uno stile principale).
Ecco alcune linee guida utili per comprendere il funzionamento della gerarchia e dell'ereditarietà degli stili.
Gli stili secondari predefiniti vengono ereditati dall'elemento principale: per fare in modo che tutti gli elementi della mappa secondari ereditino uno stile, imposta lo stile per l'elemento della mappa principale e lascia lo stile secondario come predefinito.
Gli stili secondari personalizzati sostituiscono lo stile principale: per sostituire lo stile principale,
imposta uno stile personalizzato nella funzionalità secondaria.
Gli elementi di stile sono indipendenti: gli elementi di stile che puoi impostare per una funzionalità della mappa (ad esempio il poligono, l'icona dell'etichetta e il riempimento e il tratto del testo dell'etichetta) sono indipendenti l'uno dall'altro. Se imposti il colore del poligono, ma lasci l'icona invariata, lo stile del poligono sostituisce lo stile principale, ma l'icona eredita lo stile principale o predefinito.
Disattiva la visibilità per nascondere le funzionalità della mappa: se vuoi vedere solo una cosa sulla mappa, devi disattivare la visibilità per tutto il resto.
Esempio di gerarchia ed ereditarietà
Ecco un esempio di come funzionano l'ereditarietà e la gerarchia.
Seleziona l'elemento mappa di primo livello Naturale e imposta il
Colore riempimento poligono su giallo. Questo stile rende gialli tutti i poligoni delle funzionalità della mappa in Naturale:
Vuoi che anche Copertura del suolo, che si trova in Naturale, sia di colore giallo,
quindi lo lasci senza stile e eredita lo stile da Naturale.
Vuoi che le foreste siano verdi, quindi in Copertura del suolo apri Foresta
e colora il poligono di verde. Questo stile secondario personalizzato esegue l'override degli stili per Copertura del suolo e Naturale.
Vuoi che il ghiaccio venga mostrato in un colore acquamarina chiaro, quindi anche in Copertura del suolo, apri Ghiaccio e colora il poligono in acquamarina chiaro.
Infine, vuoi che l'acqua sia di colore acquamarina, quindi seleziona Naturale > Acqua e
colora il relativo poligono di acquamarina. L'impostazione dello stile figlio Acqua sostituisce lo stile padre per Naturale.
Segui una procedura simile per evidenziare le funzionalità della mappa che ti interessano.
[null,null,["Ultimo aggiornamento 2025-08-25 UTC."],[],[],null,["# Understand map style inheritance and hierarchy\n\nSelect platform: [Android](/maps/documentation/android-sdk/cloud-customization/map-hier \"View this page for the Android platform docs.\") [iOS](/maps/documentation/ios-sdk/cloud-customization/map-hier \"View this page for the iOS platform docs.\") [JavaScript](/maps/documentation/javascript/cloud-customization/map-hier \"View this page for the JavaScript platform docs.\") [Web Service](/maps/documentation/maps-static/cloud-customization/map-hier \"View this page for the Web Service platform docs.\")\n\n\u003cbr /\u003e\n\nWhen you customize a map style, it helps to understand how styling different map\nfeatures may affect other styles on the map. There are several layers that\noverlap:\n\n- **The base map**: When you start creating a map style, the initial\n you see is the style of the base map; that is, the default map. Any map\n features you don't customize retain the base map styling.\n\n- **Map styles**: Custom styles override the styles on the base map layer.\n In this image, the custom map style overrides the urban areas as aqua\n and roads as dark blue.\n\n- **Style elements**: Each map feature has one or more style elements that\n you can customize. In this image, the urban areas map feature polygon\n fill color is styled as aqua, and the road network fill color\n is styled as blue.\n\nMap feature hierarchy\n---------------------\n\nWithin a map style, map features are organized hierarchically, with 4 broad\nmap features at the top, and all other map features arranged beneath them in\na logical hierarchy. By default, a map feature inherits the element styles\nfor the map feature above it in the hierarchy (its parent); however, you\ncan override the top level style by setting one or more of the style elements\nfor map features underneath it (child map features). For details on the map\nfeature hierarchy, see [What you can style on a map](/maps/documentation/maps-static/cloud-customization/taxonomy).\n\nEach map feature has one or more elements, or parts of the map feature, that\nyou can style. For example, the fill color for the polygon (the map feature\nshape) is an element, as is the stroke color for the text label. You style\neach element separately, and any element you don't style retains the default\nstyle. Since elements are separate, you can style the fill color for label\ntext, and leave the stroke (outline) color as the default (or inheriting\nfrom a parent style).\n\nHere are some helpful guidelines in understanding how style hierarchy and\ninheritance work.\n\n- **Default child styles inherit from the parent**: To have all\n child map features inherit a style, set the style for the parent map feature,\n and leave the child style as the default.\n\n- **Custom child styles override the parent**: To override the parent style,\n set a custom style on the child feature.\n\n- **Style elements are independent**: The style elements you can set for a\n map feature (for example, the polygon, the label icon, and the label text\n fill and stroke) are independent from each other. If you set the polygon\n color, but leave the icon alone, the polygon style overrides the parent\n style, but the icon inherits the parent or default style.\n\n- **Turn off Visibility to hide map features**: If you want to see only one\n thing on your map, you have to turn off visibility for everything else.\n\n | **Note:** When you hide map features or make them semi-transparent, you may expose boundary inaccuracies. Map feature boundaries are not always precise, but are adjusted to look correct when all layers are visible. For more details, see [Manage styles that overlap](/maps/documentation/maps-static/cloud-customization/overlap).\n\nHierarchy and Inheritance Example\n---------------------------------\n\nHere is an example of how inheritance and hierarchy works.\n\n1. Select the top-level map feature of **Natural** , and set the\n **Polygon Fill color** to yellow. This styles all polygons for map\n features under **Natural** to be yellow:\n\n2. You want **Land cover** , which is under **Natural** , to also be yellow,\n so you leave it unstyled, and it inherits the style from **Natural**.\n\n3. You want forests to be green, so under **Land cover** , you open **Forest** ,\n and color its polygon green. This custom child style overrides the\n styles for **Land cover** and **Natural**.\n\n4. You want ice to be shown a pale aqua, so also under **Land cover** , you\n open **Ice**, and color its polygon pale aqua.\n\n5. And last, you want water to be aqua, so you select **Natural\\\u003eWater** , and\n color its polygon aqua. Setting the child style **Water** overrides the parent\n style for **Natural**.\n\nFollow a similar process to highlight the map features for your needs."]]
