במסמך הזה מוסבר איך להשתמש ב-JSON כדי ליצור, לערוך ולייצא סגנונות של מפות.
מידע על מה שאפשר לעצב באמצעות JSON מופיע במאמר הפניה ל-JSON לעיצוב מפות מבוסס-ענן.
ייבוא סגנון מפה מקובץ JSON
כדי ליצור סגנון מפה באמצעות JSON, פועלים לפי השלבים הבאים:
במסוף Google Cloud, עוברים אל Map styles ובוחרים פרויקט, אם צריך.
בקטע סגנונות מפה, לוחצים על יצירת סגנון.
בתיבת הדו-שיח, בוחרים בכרטיסייה JSON.
יש שתי דרכים לייבא סגנון JSON:
מדביקים את קוד הסגנון בפורמט JSON תקין בשדה, או
scienceלוחצים על העלאת קובץ JSON ובוחרים קובץ JSON מקומי לשימוש. קוד הסגנון של ה-JSON מופיע בשדה.
בודקים אם יש שגיאות בקובץ ה-JSON.
אם יש שגיאות ב-JSON, מופיעה האזהרה 'Your JSON contains N errors' (יש N שגיאות ב-JSON), ואפשר להרחיב את האזהרה כדי לקבל מידע נוסף.
אם קובץ ה-JSON תקין, בתצוגה המקדימה של המפה מוצג הסגנון המותאם אישית שלכם, והלחצן הכחול התאמה אישית זמין.
כדי ליצור סגנון מפה חדש, לוחצים על התאמה אישית.
בסגנון המפה החדש, בוחרים את תכונות המפה ומשנים את הסגנון שלהן לפי הצורך. לצד תכונות במפה עם סגנונות מותאמים אישית מופיעה נקודה כחולה מלאה.
לוחצים על שמירה.
בתיבה Save and publish map style, מזינים שם לסגנון ואפשר גם תיאור, ולוחצים על Save.
הסגנון מתפרסם באופן אוטומטי, ומוצג הדף הראשי של הסגנון החדש.
כדי להוסיף את סגנון המפה למזהה מפה, אפשר לעיין במאמר בנושא שיוך סגנון למזהה מפה.
עריכת סגנון מפה באמצעות JSON
אפשר לערוך סגנונות של מפות באמצעות הכרטיסייה JSON בכלי לעריכת סגנונות.
שינויים שמבצעים בכלי לעריכת JSON משתקפים בחלונית הסגנון. בנוסף, אם מבצעים שינויים בחלונית הסגנון, אפשר לראות את השינויים האלה בעורך ה-JSON. שתי השיטות מעדכנות גם את התצוגה המקדימה של המפה.
כדי לערוך סגנון מפה באמצעות JSON, פועלים לפי השלבים הבאים:
במסוף Google Cloud, עוברים אל Map styles ובוחרים פרויקט, אם צריך.
בקטע סגנונות מפה, בוחרים סגנון קיים מרשימת הסגנונות.
בדף הראשי של הסגנון, בוחרים באפשרות התאמה אישית.
בוחרים בכרטיסייה JSON כדי לפתוח את עורך סגנונות ה-JSON.
מבצעים את השינויים בכלי העריכה. אפשר גם להעלות קובץ JSON.
לוחצים על Commit כדי לעדכן את התצוגה המקדימה של המפה.
כשמסיימים לבצע את כל השינויים, לוחצים על שמירה. אם יוצרים סגנון חדש, השינויים מתעדכנים אוטומטית. אם מבצעים שינויים בסגנון קיים, השינויים נשמרים כטיוטה וצריך ללחוץ על פרסום כדי שהשינויים יתעדכנו בכל מזהי המפות שמשתמשים בסגנון המפה הזה.
ייצוא סגנון מפה כ-JSON
כדי לייצא סגנון מפה כקובץ JSON, פועלים לפי השלבים הבאים:
במסוף Google Cloud, עוברים אל Map styles ובוחרים פרויקט, אם צריך.
בקטע סגנונות מפה, בוחרים סגנון קיים מרשימת הסגנונות.
בדף הראשי של הסגנון, בוחרים באפשרות התאמה אישית.
בוחרים בכרטיסייה JSON כדי לפתוח את עורך סגנונות ה-JSON.
[null,null,["עדכון אחרון: 2025-08-31 (שעון UTC)."],[],[],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**."]]
