Con declaraciones de diseño JSON incorporadas, puedes aplicar diseños personalizados a lo siguiente:
Mapa predeterminado
Tipos de mapas entre los que los usuarios pueden cambiar en un único marco de mapa
Cómo especificar diseños para los componentes
Para aplicar diseños a diferentes elementos y componentes de un mapa, crea un array de objetos MapTypeStyle que defina cómo se debe aplicar el diseño al mapa.
El array adopta la siguiente forma:
varstylesArray=[{featureType:'',elementType:'',stylers:[{color:''},{visibility:''},// Add any stylers you need.]},{featureType:'',// Add the stylers you need.}]
Para obtener una lista de todos los valores disponibles para featureType, elementType y stylers, consulta la referencia de diseño JSON.
A continuación, se muestra un ejemplo de un mapa predeterminado con un diseño de íconos y textos de colores claros sobre un fondo oscuro (es decir, modo oscuro). Para ver la muestra de código, consulta el artículo Mapas con diseños: muestra de código del Modo nocturno.
Para modificar los diseños del mapa predeterminado, configura la propiedad styles del mapa en el objeto MapOptions con tu array de diseño en las siguientes circunstancias:
Al crear tu mapa
O bien, cuando llames al método Map.setOptions
Los cambios en las etiquetas y las rutas afectan a todos los tipos de mapas, incluidos los de terreno, satélite, híbridos y el mapa de ruta predeterminado.
Cómo aplicar diseños a un tipo de mapa
A continuación, se muestra un tipo de mapa agregado denominado Mapa con diseños (Styled Map) en el control que se encuentra en la esquina superior izquierda del mapa. Para ver la muestra de código, consulta el artículo Tipos de mapas con diseños.
Para crear un tipo de mapa con diseño, configura el array de diseños con un objeto StyledMapType. La creación de un nuevo tipo de mapa con diseño no afecta el diseño de los tipos de mapas predeterminados.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-08-18 (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,["Select 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\nSpecify styles to features\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[](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\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\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."]]
