این سند نحوه استفاده از JSON برای ایجاد، ویرایش و صادرات سبک های نقشه را توضیح می دهد. برای اطلاعات در مورد آنچه که می توانید با استفاده از JSON استایل دهید، به مرجع JSON برای طراحی نقشه های مبتنی بر ابر مراجعه کنید.
یک سبک نقشه JSON وارد کنید
برای ایجاد یک سبک نقشه با استفاده از JSON، مراحل زیر را انجام دهید:
در کنسول Google Cloud، به سبک های نقشه بروید و در صورت نیاز پروژه ای را انتخاب کنید.
در سبک های نقشه ، روی ایجاد سبک کلیک کنید.
در گفتگو، تب JSON را انتخاب کنید.
دو راه برای وارد کردن سبک JSON وجود دارد:
کد استایل JSON معتبر خود را در فیلد قرار دهید، یا
science روی آپلود فایل JSON کلیک کنید و یک فایل JSON محلی را برای استفاده انتخاب کنید. کد سبک JSON در فیلد ظاهر می شود.
بررسی کنید که آیا JSON شما خطا دارد یا خیر.
اگر JSON شما دارای خطا باشد، اخطار "JSON شما حاوی N خطا است" ظاهر می شود و می توانید برای کسب اطلاعات بیشتر اخطار را گسترش دهید.
اگر JSON شما معتبر است، پیش‌نمایش نقشه سبک سفارشی شما را نشان می‌دهد و دکمه آبی سفارشی در دسترس است.
برای ایجاد یک سبک نقشه جدید روی Customize کلیک کنید.
در سبک نقشه جدید خود، ویژگی های نقشه را انتخاب کنید و سبک آنها را در صورت نیاز مرور یا تغییر دهید. ویژگی های نقشه با سبک های سفارشی دارای یک نقطه آبی ثابت در کنار آنها هستند.
روی ذخیره کلیک کنید.
در کادر سبک نقشه ذخیره و انتشار ، یک نام برای سبک خود و در صورت تمایل یک توضیح وارد کنید و روی ذخیره کلیک کنید.
سبک به طور خودکار منتشر می شود و صفحه اصلی سبک جدید خود را می بینید.
می توانید سبک های نقشه را با استفاده از زبانه JSON در ویرایشگر سبک ویرایش کنید.
تغییرات ایجاد شده در ویرایشگر JSON در پانل سبک منعکس می شود. علاوه بر این، اگر تغییراتی را در پانل سبک ایجاد کنید، می‌توانید آن تغییرات را در ویرایشگر JSON پیدا کنید. هر دو روش همچنین پیش نمایش نقشه را به روز می کنند.
برای ویرایش یک سبک نقشه با استفاده از JSON، مراحل زیر را ببینید:
در کنسول Google Cloud، به سبک های نقشه بروید و در صورت نیاز پروژه ای را انتخاب کنید.
در سبک های نقشه ، یک سبک موجود را از لیست سبک انتخاب کنید.
در صفحه اصلی سبک، سفارشی کردن را انتخاب کنید.
برای باز کردن ویرایشگر سبک JSON، تب JSON را انتخاب کنید.
تغییرات خود را در ویرایشگر انجام دهید. همچنین می توانید یک فایل JSON را آپلود کنید.
برای به روز رسانی پیش نمایش نقشه روی Commit کلیک کنید.
پس از انجام همه تغییرات، روی ذخیره کلیک کنید. اگر سبک جدیدی ایجاد می کنید، تغییرات به طور خودکار فعال می شوند. اگر در یک سبک موجود تغییراتی ایجاد می‌کنید، تغییرات به‌عنوان پیش‌نویس ذخیره می‌شوند و باید روی انتشار کلیک کنید تا تغییرات شما برای هر شناسه نقشه‌ای که از آن سبک نقشه استفاده می‌کند، فعال شود.
یک سبک نقشه را به عنوان JSON صادر کنید
برای صادر کردن یک سبک نقشه به عنوان یک فایل JSON، مراحل زیر را ببینید:
در کنسول Google Cloud، به سبک های نقشه بروید و در صورت نیاز پروژه ای را انتخاب کنید.
در سبک های نقشه ، یک سبک موجود را از لیست سبک انتخاب کنید.
در صفحه اصلی سبک، سفارشی کردن را انتخاب کنید.
برای باز کردن ویرایشگر سبک JSON، تب JSON را انتخاب کنید.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["Select platform: [Android](/maps/documentation/android-sdk/cloud-customization/json \"View this page for the Android platform docs.\") [iOS](/maps/documentation/ios-sdk/cloud-customization/json \"View this page for the iOS platform docs.\") [JavaScript](/maps/documentation/javascript/cloud-customization/json \"View this page for the JavaScript platform docs.\") [Web Service](/maps/documentation/maps-static/cloud-customization/json \"View this page for the Web Service platform docs.\")\n\n\u003cbr /\u003e\n\n| **Experimental:** Features marked with the science science icon are experimental.\n\nThis document explains how to use JSON to create, edit, and export map styles.\nFor information on what you can style using JSON, see the\n[JSON reference for cloud-based maps styling](/maps/documentation/maps-static/cloud-customization/json-reference).\n\nImport a JSON map style\n\nTo create a map style using JSON, perform the following steps:\n\n1. In the Google Cloud console,\n go to [**Map styles**](https://console.cloud.google.com/google/maps-apis/studio/styles), and select a project, if needed.\n\n2. In **Map styles** , click **Create style**.\n\n3. In the dialog, select the **JSON** tab.\n\n4. There are two ways to import your JSON style:\n\n - Paste your valid JSON styling code into the field, or\n - scienceClick **Upload JSON File** and choose a local JSON file to use. The JSON styling code appears in the field.\n\n | **Note:** When importing legacy JSON, a warning appears and the style is converted to the latest JSON format. The conversion is approximate but sets you up for a richer and more customizable experience. To only use legacy JSON, see [Use embedded JSON style declarations](../styling).\n5. Check whether your JSON has errors.\n\n - If your JSON has errors, the warning \"Your JSON contains N errors\" appears and you can expand the warning to learn more.\n - If your JSON is valid, the map preview shows your custom style and the blue **Customize** button is available.\n6. Click **Customize** to create a new map style.\n\n7. In your new map style, select map features and review or change their style\n as needed. Map features with custom styles have a solid blue dot next to\n them.\n\n | **Note:** Not all styles appear at all zoom levels.\n8. Click **Save**.\n\n9. In the **Save and publish map style** box, enter a name for your style and\n optionally a description, and click **Save**.\n\nThe style is automatically published, and you see your new style's\nmain page.\n\nTo add your map style to a map ID, see\n[Associate your style to a map ID](/maps/documentation/maps-static/cloud-customization/map-styles#associate-style-with-map-id).\n\nEdit a map style with JSON **Experimental:** This feature is experimental.\n\nYou can edit map styles using the JSON tab in the style editor.\n\nChanges made in the JSON editor are reflected in the style panel. Additionally,\nif you make changes in the style panel, you can find those changes in the JSON\neditor. Both methods also update the map preview.\n\nTo edit a map style using JSON, see the following steps:\n\n1. In the Google Cloud console,\n go to [**Map styles**](https://console.cloud.google.com/google/maps-apis/studio/styles), and select a project, if needed.\n\n2. In **Map styles**, select an existing style from the style list.\n\n3. In the style's main page, select **Customize**.\n\n4. Select the **JSON** tab to open the JSON style editor.\n\n5. Make your changes in the editor. You can also upload a JSON file.\n\n6. Click **Commit** to update the map preview.\n\n7. Once you're done with all of your changes, click **Save** . If you're\n creating a new style, the changes go live automatically. If you're making\n changes to an existing style, the changes save as a draft and you must click\n **Publish** to have your changes go live for any map IDs using that map\n style.\n\nExport a map style as JSON **Experimental:** This feature is experimental.\n\nTo export a map style as a JSON file, see the following steps:\n\n1. In the Google Cloud console,\n go to [**Map styles**](https://console.cloud.google.com/google/maps-apis/studio/styles), and select a project, if needed.\n\n2. In **Map styles**, select an existing style from the style list.\n\n3. In the style's main page, select **Customize**.\n\n4. Select the **JSON** tab to open the JSON style editor.\n\n5. Select **Export**."]]
