Para crear un estilo de mapa con JSON, sigue estos pasos:
En la consola de Google Cloud, ve a Diseños de mapa y selecciona un proyecto si es necesario.
En Diseños de mapa, haz clic en Crear diseño.
En el diálogo, selecciona la pestaña JSON.
Existen dos formas de importar tu diseño JSON:
Pega el código de diseño JSON válido en el campo.
scienceHaz clic en Subir archivo JSON y elige un archivo JSON local para usar. El código de diseño JSON aparece en el campo.
Comprueba si tu código JSON tiene errores.
Si tu JSON tiene errores, aparecerá la advertencia "Tu JSON contiene N errores", y podrás expandirla para obtener más información.
Si tu archivo JSON es válido, la vista previa del mapa mostrará tu diseño personalizado y estará disponible el botón azul Personalizar.
Haz clic en Personalizar para crear un nuevo estilo de mapa.
En tu nuevo diseño de mapa, selecciona los componentes de mapa y revisa o cambia su diseño según sea necesario. Los componentes de mapa con diseños personalizados tienen un punto azul a su lado.
Haz clic en Guardar.
En el cuadro Guardar y publicar el diseño de mapa, ingresa el nombre de tu diseño y, opcionalmente, una descripción, y haz clic en Guardar.
El diseño se publicará automáticamente, y podrás ver la página principal de tu nuevo diseño.
Puedes editar los estilos de mapa con la pestaña JSON del editor de estilos.
Los cambios que se realizan en el editor de JSON se reflejan en el panel de diseño. Además, si realizas cambios en el panel de diseño, puedes encontrarlos en el editor de JSON. Ambos métodos también actualizan la vista previa del mapa.
Para editar un estilo de mapa con JSON, sigue estos pasos:
En la consola de Google Cloud, ve a Diseños de mapa y selecciona un proyecto si es necesario.
En Diseños de mapa, selecciona un diseño existente de la lista.
En la página principal del diseño, selecciona Personalizar.
Selecciona la pestaña JSON para abrir el editor de diseño JSON.
Realiza los cambios en el editor. También puedes subir un archivo JSON.
Haz clic en Commit para actualizar la vista previa del mapa.
Cuando termines de realizar todos los cambios, haz clic en Guardar. Si creas un diseño nuevo, los cambios se publicarán automáticamente. Si realizas cambios en un diseño existente, estos se guardarán como borrador y deberás hacer clic en Publicar para que se publiquen en los IDs de mapa que usen ese diseño de mapa.
Cómo exportar un diseño de mapa como JSON
Para exportar un diseño de mapa como un archivo JSON, sigue estos pasos:
En la consola de Google Cloud, ve a Diseños de mapa y selecciona un proyecto si es necesario.
En Diseños de mapa, selecciona un diseño existente de la lista.
En la página principal del diseño, selecciona Personalizar.
Selecciona la pestaña JSON para abrir el editor de diseño JSON.
[null,null,["Última actualización: 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**."]]