Über eingebettete JSON-Stildeklarationen lassen sich benutzerdefinierte Stile auf
die Standardkarte und auf
Kartentypen anwenden, zwischen denen Nutzer innerhalb eines einzelnen Kartenframes wechseln können.
Stile für Kartenelemente festlegen
Wenn Sie Stile auf verschiedene Elemente und Unterelemente einer Karte anwenden möchten, erstellen Sie ein Array mit MapTypeStyle-Objekten, mit denen die Gestaltung der Karte definiert wird.
Das Array hat folgende Form:
varstylesArray=[{featureType:'',elementType:'',stylers:[{color:''},{visibility:''},// Add any stylers you need.]},{featureType:'',// Add the stylers you need.}]
Eine Liste aller verfügbaren Werte für featureType, elementType und stylers finden Sie in der JSON-Stilreferenz.
Hier sehen Sie ein Beispiel für eine Standardkarte mit hellem Text und Symbolen auf dunklem Hintergrund (d. h. im dunklen Modus). Das Codebeispiel finden Sie unter Karten mit benutzerdefinierten Stilen – Nachtmodus.
Wenn Sie die Stile der Standardkarte ändern möchten, setzen Sie die styles-Eigenschaft der Karte im Objekt MapOptions auf Ihr Stilarray, wenn
Sie die Karte erstellen oder
die Methode Map.setOptions aufrufen.
Änderungen an Labels und Straßen wirken sich auf alle Kartentypen aus, einschließlich Gelände-, Satelliten- und hybrider Karten sowie der standardmäßigen Straßenkarte.
Stile auf einen Kartentyp anwenden
Im folgenden Beispiel wurde ein zusätzlicher Kartentyp namens Karte mit benutzerdefinierten Stilen (Styled Map) zum Steuerelement oben links auf der Karte hinzugefügt. Das Codebeispiel finden Sie unter Typen für Karten mit benutzerdefinierten Stilen.
Wenn Sie einen Typ für Karten mit benutzerdefinierten Stilen erstellen möchten, setzen Sie das Stilarray auf ein StyledMapType-Objekt. Das Erstellen eines neuen Kartentyps wirkt sich nicht auf den Stil der Standardkartentypen aus.
[null,null,["Zuletzt aktualisiert: 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."]]
