Puoi applicare stili personalizzati tramite dichiarazioni di stile JSON incorporate
a quanto segue:
Mappa predefinita.
I tipi di mappa tra cui un utente può passare all'interno di un singolo frame della mappa.
Specifica gli stili per le funzionalità
Per applicare stili a diverse funzionalità ed elementi di una mappa, crea un array di oggetti MapTypeStyle che definiscono lo stile della mappa.
L'array ha il seguente formato:
varstylesArray=[{featureType:'',elementType:'',stylers:[{color:''},{visibility:''},// Add any stylers you need.]},{featureType:'',// Add the stylers you need.}]
Per un elenco di tutti i valori disponibili per featureType, elementType e
stylers, consulta il riferimento allo stile JSON.
Di seguito è riportato un esempio di mappa predefinita con uno stile che utilizza testo e icone di colore chiaro su uno sfondo scuro (ovvero la modalità Buio). Per visualizzare il codice campione, vai a
Esempio di codice per le mappe con stili: modalità notturna.
Per modificare gli stili della mappa predefinita, imposta la proprietà styles della mappa nell'oggetto MapOptions sull'array di stili quando:
Creazione della mappa in corso.
oppure quando chiami il metodo Map.setOptions.
Le modifiche alle etichette e alle strade influiscono su tutti i tipi di mappe, inclusi rilievo, satellite, ibrida e roadmap predefinita.
Applicare stili a un tipo di mappa
Di seguito viene mostrato un tipo di mappa aggiunto chiamato Mappa con stile nel controllo in alto a sinistra della mappa. Per visualizzare il codice campione, vai a Tipi di mappe con stili.
Per creare un tipo di mappa con stile, imposta l'array di stili su un oggetto StyledMapType. La creazione di un nuovo tipo di mappa con stile non influisce sullo stile dei tipi di mappa predefiniti.
[null,null,["Ultimo aggiornamento 2025-08-27 UTC."],[[["\u003cp\u003eCustomize the appearance of your maps using embedded JSON style declarations for the default map and selectable map types.\u003c/p\u003e\n"],["\u003cp\u003eStyle features and elements within the map by creating an array of \u003ccode\u003eMapTypeStyle\u003c/code\u003e objects defining the desired appearance, with the \u003ccode\u003efeatureType\u003c/code\u003e, \u003ccode\u003eelementType\u003c/code\u003e, and \u003ccode\u003estylers\u003c/code\u003e properties determining specific modifications.\u003c/p\u003e\n"],["\u003cp\u003eUtilize the Maps Platform Styling Wizard to quickly generate JSON styling objects, simplifying the process of creating custom map styles.\u003c/p\u003e\n"],["\u003cp\u003eApply styles to the default map by setting the \u003ccode\u003estyles\u003c/code\u003e property in the \u003ccode\u003eMapOptions\u003c/code\u003e object during map creation or by using the \u003ccode\u003eMap.setOptions\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eCreate styled map types by setting the style array to a \u003ccode\u003eStyledMapType\u003c/code\u003e object, enabling the addition of custom map styles without impacting the default map types.\u003c/p\u003e\n"]]],["Custom styling for maps can be applied via embedded JSON style declarations to default maps or user-switchable map types. Create an array of `MapTypeStyle` objects specifying `featureType`, `elementType`, and `stylers` to define styling. For consistent styling across apps, use cloud customization with a map ID. Use the Maps Platform Styling Wizard to quickly generate JSON styling or apply styles by setting the map's `styles` property within the `MapOptions` object or the `Map.setOptions` method.\n"],null,["# Use embedded JSON style declarations\n\nSelect platform: [Android](/maps/documentation/android-sdk/styling \"View this page for the Android platform docs.\") [iOS](/maps/documentation/ios-sdk/styling \"View this page for the iOS platform docs.\") [JavaScript](/maps/documentation/javascript/json-styling-overview \"View this page for the JavaScript platform docs.\")\n\n\u003cbr /\u003e\n\nYou can apply customized styling through an embedded JSON style declarations\nto the following:\n\n- Default map.\n- Map types that a user can switch between within a single map frame.\n\n| If you want to update the same style across multiple apps, look into [cloud customization](/maps/documentation/javascript/cloud-customization), which is available in the Google Cloud console and requires a [map ID](/maps/documentation/get-map-id). To avoid potential conflicts, **do not combine** cloud customization and hardcoded styling in the same app.\n| **Experimental:** For a richer styling experience, you can use [JSON styling with cloud-based map styling](./cloud-customization/json) which has a more extensive list of map features with more options to customize their appearance.\n\nSpecify styles to features\n--------------------------\n\nTo apply styles to different features and elements in a map, create an array of\n[`MapTypeStyle`](/maps/documentation/javascript/3.exp/reference#MapTypeStyle)\nobjects that define how the map should be styled.\n\nThe array takes the following form: \n\n var stylesArray = [\n {\n featureType: '',\n elementType: '',\n stylers: [\n {color: ''},\n {visibility: ''},\n // Add any stylers you need.\n ]\n },\n {\n featureType: '',\n // Add the stylers you need.\n }\n ]\n\nFor a list of all available values for `featureType`, `elementType`, and\n`stylers`, see the [JSON style reference](/maps/documentation/javascript/style-reference).\n\nMaps Platform Styling Wizard\n----------------------------\n\n[](https://mapstyle.withgoogle.com) \n[](https://mapstyle.withgoogle.com) \n[](https://mapstyle.withgoogle.com)[](https://mapstyle.withgoogle.com/) \n[](https://mapstyle.withgoogle.com/) \n[](https://mapstyle.withgoogle.com/) \n[](https://mapstyle.withgoogle.com/) \n[](https://mapstyle.withgoogle.com/) \n[](https://mapstyle.withgoogle.com/) \n[Create\ncustom styles for the Google Maps Platform APIs](https://mapstyle.withgoogle.com)\n\nUse the [Maps Platform Styling Wizard](https://mapstyle.withgoogle.com) as a quick way to generate a JSON styling object.\n| **Note:** To have a style apply to multiple app platforms, consider using [cloud-based maps styling](/maps/documentation/javascript/cloud-customization). If you want to use a JSON style, you can import it. For details, see [Import a JSON map style](./cloud-customization/map-styles-leg#json-import).\n\nApply styles to a default map\n-----------------------------\n\nThe following shows an example default map styled using light-colored text and\nicons on a dark background (i.e. dark mode). To see the code sample, go to\n[Styled Maps - Night Mode code sample](/maps/documentation/javascript/examples/style-array).\n\n\nTo modify the styles of the default map, set the map's `styles` property in the\n`MapOptions` object to your style array when:\n\n- Creating your map.\n- Or, when calling the `Map.setOptions` method.\n\nChanges to labels and roads affect all map types including terrain, satellite,\nhybrid, and default roadmap types.\n\nApply styles to a map type\n--------------------------\n\nThe following shows an added map type called **Styled Map** in the control at\nthe top left of the map. To see the code sample, go to [Styled Map Types](/maps/documentation/javascript/examples/maptype-styled-simple).\n\n\nTo create a styled map type, set the style array to a [`StyledMapType`](/maps/documentation/javascript/3.exp/reference#StyledMapType)\nobject. Creating a new styled map type does not affect the style of the default\nmap types."]]
