Dokumen ini menjelaskan cara menggunakan JSON untuk membuat, mengedit, dan mengekspor gaya peta.
Untuk mengetahui informasi tentang elemen yang dapat Anda tata gayanya menggunakan JSON, lihat
Referensi JSON untuk gaya visual peta berbasis cloud.
Mengimpor gaya peta JSON
Untuk membuat gaya peta menggunakan JSON, lakukan langkah-langkah berikut:
Di Konsol Google Cloud, buka Map styles, dan pilih project jika perlu.
Di Gaya peta, klik Buat gaya.
Pada dialog, pilih tab JSON.
Ada dua cara untuk mengimpor gaya JSON:
Tempelkan kode gaya visual JSON yang valid ke kolom, atau
scienceKlik Upload JSON File dan pilih file JSON lokal yang akan digunakan. Kode gaya visual JSON akan muncul di kolom.
Periksa apakah JSON Anda memiliki error.
Jika JSON Anda memiliki error, peringatan "JSON Anda berisi N error" akan muncul dan Anda dapat meluaskan peringatan tersebut untuk mempelajari lebih lanjut.
Jika JSON Anda valid, pratinjau peta akan menampilkan gaya kustom Anda dan tombol Sesuaikan berwarna biru akan tersedia.
Klik Sesuaikan untuk membuat gaya peta baru.
Di gaya peta baru, pilih fitur peta dan tinjau atau ubah gayanya sesuai kebutuhan. Fitur peta dengan gaya kustom memiliki titik biru solid di sebelahnya.
Klik Simpan.
Dalam kotak Save and publish map style, masukkan nama untuk gaya Anda dan deskripsi opsional, lalu klik Save.
Gaya akan otomatis dipublikasikan, dan Anda akan melihat halaman utama untuk gaya baru Anda.
Anda dapat mengedit gaya peta menggunakan tab JSON di editor gaya.
Perubahan yang dibuat di editor JSON akan ditampilkan di panel gaya. Selain itu, jika Anda membuat perubahan di panel gaya, Anda dapat menemukan perubahan tersebut di editor JSON. Kedua metode ini juga memperbarui pratinjau peta.
Untuk mengedit gaya peta menggunakan JSON, lihat langkah-langkah berikut:
Di Konsol Google Cloud, buka Map styles, dan pilih project jika perlu.
Di Gaya peta, pilih gaya yang sudah ada dari daftar gaya.
Di halaman utama gaya, pilih Sesuaikan.
Pilih tab JSON untuk membuka editor gaya JSON.
Buat perubahan Anda di editor. Anda juga dapat mengupload file JSON.
Klik Terapkan untuk memperbarui pratinjau peta.
Setelah selesai melakukan semua perubahan, klik Simpan. Jika Anda membuat gaya baru, perubahan akan ditayangkan secara otomatis. Jika Anda membuat perubahan pada gaya yang ada, perubahan akan disimpan sebagai draf dan Anda harus mengklik Publikasikan agar perubahan tersebut ditayangkan untuk setiap ID peta yang menggunakan gaya peta tersebut.
Mengekspor gaya peta sebagai JSON
Untuk mengekspor gaya peta sebagai file JSON, lihat langkah-langkah berikut:
Di Konsol Google Cloud, buka Map styles, dan pilih project jika perlu.
Di Gaya peta, pilih gaya yang sudah ada dari daftar gaya.
[null,null,["Terakhir diperbarui pada 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**."]]
