يمكنك تطبيق أنماط مخصّصة من خلال إدراج تعريفات أنماط JSON على ما يلي:
الخريطة التلقائية
أنواع الخرائط التي يمكن للمستخدم التبديل بينها ضمن إطار خريطة واحد
تحديد الأنماط للعناصر
لتطبيق أنماط على ميزات وعناصر مختلفة في خريطة، أنشئ مجموعة من عناصر MapTypeStyle تحدّد طريقة تصميم الخريطة.
تتّخذ الصفيفة الشكل التالي:
varstylesArray=[{featureType:'',elementType:'',stylers:[{color:''},{visibility:''},// Add any stylers you need.]},{featureType:'',// Add the stylers you need.}]
للاطّلاع على قائمة بجميع القيم المتاحة لكل من featureType وelementType وstylers، يُرجى الرجوع إلى مرجع نمط JSON.
لتعديل أنماط الخريطة التلقائية، اضبط السمة styles الخاصة بالخريطة في العنصر MapOptions على مصفوفة الأنماط عند استيفاء أحد الشرطين التاليين:
إنشاء الخريطة
أو عند استدعاء الطريقة Map.setOptions
تؤثّر التغييرات في التصنيفات والطرق في جميع أنواع الخرائط، بما في ذلك التضاريس والأقمار الصناعية والخرائط المختلطة وأنواع الخرائط التلقائية.
تطبيق أنماط على نوع خريطة
تعرض الصورة التالية نوع خريطة تمت إضافته باسم خريطة منمّقة في عنصر التحكّم في أعلى يمين الخريطة. للاطّلاع على نموذج الرمز، انتقِل إلى أنواع الخرائط ذات الأنماط.
لإنشاء نوع خريطة منمّقة، اضبط مصفوفة الأنماط على كائن StyledMapType. لا يؤثر إنشاء نوع خريطة منمّقة جديد في نمط أنواع الخرائط التلقائية.
تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 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."]]