میتوانید استایل سفارشیشده را از طریق اعلانهای سبک JSON تعبیهشده در موارد زیر اعمال کنید:
نقشه پیش فرض
انواع نقشه ای که کاربر می تواند در یک قاب نقشه جابجا شود.
استایل ها را به ویژگی ها مشخص کنید
برای اعمال سبک ها به ویژگی ها و عناصر مختلف در نقشه، آرایه ای از اشیاء MapTypeStyle ایجاد کنید که نحوه استایل دهی نقشه را مشخص می کند.
آرایه به شکل زیر است:
varstylesArray=[{featureType:'',elementType:'',stylers:[{color:''},{visibility:''},// Add any stylers you need.]},{featureType:'',// Add the stylers you need.}]
برای لیستی از تمام مقادیر موجود برای featureType , elementType و stylers , به مرجع سبک JSON مراجعه کنید.
در زیر یک نمونه نقشه پیش فرض را نشان می دهد که با استفاده از متن و نمادهای رنگ روشن در پس زمینه تیره (به عنوان مثال حالت تاریک) استایل شده است. برای دیدن نمونه کد، به Styled Maps - Night Mode Code بروید.
برای تغییر سبکهای نقشه پیشفرض، ویژگی styles نقشه را در شی MapOptions به آرایه سبک خود تنظیم کنید زمانی که:
ایجاد نقشه شما
یا هنگام فراخوانی روش Map.setOptions .
تغییرات در برچسبها و جادهها بر همه انواع نقشهها از جمله زمین، ماهواره، ترکیبی و انواع نقشه راه پیشفرض تأثیر میگذارد.
اعمال سبک ها به نوع نقشه
شکل زیر یک نوع نقشه اضافه شده به نام Styled Map را در کنترل سمت چپ بالای نقشه نشان می دهد. برای دیدن نمونه کد، به Styled Map Types بروید.
برای ایجاد یک نوع نقشه سبک، آرایه سبک را روی یک شی StyledMapType تنظیم کنید. ایجاد یک نوع نقشه سبک جدید تأثیری بر سبک انواع نقشه پیشفرض ندارد.
تاریخ آخرین بهروزرسانی 2025-08-27 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-08-27 بهوقت ساعت هماهنگ جهانی."],[[["\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."]]