Bu belgede, harita stillerini oluşturmak, düzenlemek ve dışa aktarmak için JSON'un nasıl kullanılacağı açıklanmaktadır.
JSON kullanarak hangi öğeleri stilize edebileceğiniz hakkında bilgi edinmek için Bulut tabanlı harita stilleri için JSON referansı başlıklı makaleyi inceleyin.
JSON harita stili içe aktarma
JSON kullanarak harita stili oluşturmak için aşağıdaki adımları uygulayın:
Google Cloud Console'da Harita stilleri'ne gidin ve gerekirse bir proje seçin.
Harita stilleri'nde Stil oluştur'u tıklayın.
İletişim kutusunda JSON sekmesini seçin.
JSON stilinizi içe aktarmanın iki yolu vardır:
Geçerli JSON stil kodunuzu alana yapıştırın veya
scienceJSON Dosyasını Yükle'yi tıklayın ve kullanılacak yerel bir JSON dosyası seçin. JSON stil kodu alanda görünür.
JSON'unuzda hata olup olmadığını kontrol edin.
JSON'unuzda hatalar varsa "JSON'unuz N hata içeriyor" uyarısı gösterilir ve daha fazla bilgi edinmek için uyarıyı genişletebilirsiniz.
JSON'ınız geçerliyse harita önizlemesinde özel stiliniz gösterilir ve mavi Özelleştir düğmesi kullanılabilir.
Yeni bir harita stili oluşturmak için Özelleştir'i tıklayın.
Yeni harita stilinizde harita özelliklerini seçin ve stillerini gerektiği gibi inceleyin veya değiştirin. Özel stillere sahip harita özelliklerinin yanında mavi bir nokta bulunur.
Kaydet'i tıklayın.
Harita stilini kaydet ve yayınla kutusunda stiliniz için bir ad ve isteğe bağlı olarak bir açıklama girip Kaydet'i tıklayın.
Stil otomatik olarak yayınlanır ve yeni stilinizin ana sayfasını görürsünüz.
Harita stillerini, stil düzenleyicideki JSON sekmesini kullanarak düzenleyebilirsiniz.
JSON düzenleyicide yapılan değişiklikler stil paneline yansıtılır. Ayrıca, stil panelinde yaptığınız değişiklikleri JSON düzenleyicide de görebilirsiniz. Her iki yöntem de harita önizlemesini günceller.
JSON kullanarak harita stili düzenlemek için aşağıdaki adımları inceleyin:
Google Cloud Console'da Harita stilleri'ne gidin ve gerekirse bir proje seçin.
Harita stilleri'nde stil listesinden mevcut bir stili seçin.
Stilin ana sayfasında Özelleştir'i seçin.
JSON stil düzenleyiciyi açmak için JSON sekmesini seçin.
Düzenleyicide değişikliklerinizi yapın. JSON dosyası da yükleyebilirsiniz.
Harita önizlemesini güncellemek için Kaydet'i tıklayın.
Tüm değişikliklerinizi tamamladığınızda Kaydet'i tıklayın. Yeni bir stil oluşturuyorsanız değişiklikler otomatik olarak yayınlanır. Mevcut bir stilde değişiklik yapıyorsanız değişiklikler taslak olarak kaydedilir ve bu harita stilini kullanan tüm harita kimliklerinde değişikliklerin yayınlanması için Yayınla'yı tıklamanız gerekir.
Harita stilini JSON olarak dışa aktarma
Bir harita stilini JSON dosyası olarak dışa aktarmak için aşağıdaki adımları inceleyin:
Google Cloud Console'da Harita stilleri'ne gidin ve gerekirse bir proje seçin.
Harita stilleri'nde stil listesinden mevcut bir stili seçin.
Stilin ana sayfasında Özelleştir'i seçin.
JSON stil düzenleyiciyi açmak için JSON sekmesini seçin.
[null,null,["Son güncelleme tarihi: 2025-08-31 UTC."],[],[],null,["# Use JSON with cloud-based maps styling\n\nSelect 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/android-sdk/cloud-customization/json-reference).\n\nImport a JSON map style\n-----------------------\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/android-sdk/cloud-customization/map-styles#associate-style-with-map-id).\n\nEdit a map style with JSON\n--------------------------\n\n| **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\n--------------------------\n\n| **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**."]]
