Para criar um estilo de mapa usando JSON, siga estas etapas:
No console do Google Cloud, acesse Estilos de mapa e selecione um projeto, se necessário.
Em Estilos de mapa, clique em Criar estilo.
Na caixa de diálogo, selecione a guia JSON.
Há duas maneiras de importar seu estilo JSON:
Cole seu código de estilo JSON válido no campo ou
scienceClique em Fazer upload do arquivo JSON e escolha um arquivo JSON local para usar. O código de estilo JSON aparece no campo.
Verifique se o JSON tem erros.
Se o JSON tiver erros, a mensagem "Seu JSON contém N erros" vai aparecer. Clique nela para saber mais.
Se o JSON for válido, a prévia do mapa vai mostrar seu estilo personalizado e o botão azul Personalizar vai estar disponível.
Clique em Personalizar para criar um novo estilo de mapa.
No novo estilo de mapa, selecione os elementos e revise ou mude o estilo conforme necessário. Um ponto azul aparece ao lado dos elementos do mapa com estilos personalizados.
Clique em Salvar.
Na caixa Salvar e publicar estilo de mapa, insira um nome e, se quiser, uma descrição para o estilo. Depois, clique em Salvar.
O novo estilo é publicado automaticamente, e a página principal dele aparece.
É possível editar estilos de mapa usando a guia "JSON" no editor de estilos.
As mudanças feitas no editor JSON são refletidas no painel de estilo. Além disso, se você fizer mudanças no painel de estilo, elas vão aparecer no editor JSON. Os dois métodos também atualizam a prévia do mapa.
Para editar um estilo de mapa usando JSON, siga estas etapas:
No console do Google Cloud, acesse Estilos de mapa e selecione um projeto, se necessário.
Em Estilos de mapa, selecione um estilo na lista.
Na página principal do estilo, selecione Personalizar.
Selecione a guia JSON para abrir o editor de estilo JSON.
Faça as mudanças no editor. Você também pode fazer upload de um arquivo JSON.
Clique em Confirmar para atualizar a prévia do mapa.
Quando terminar as mudanças, clique em Salvar. Se você estiver criando um novo estilo, as mudanças serão publicadas automaticamente. Se você estiver fazendo mudanças em um estilo atual, elas serão salvas como rascunho. Clique em Publicar para que as alterações sejam ativadas nos IDs de mapa que usam esse estilo.
Exportar um estilo de mapa como JSON
Para exportar um estilo de mapa como um arquivo JSON, siga estas etapas:
No console do Google Cloud, acesse Estilos de mapa e selecione um projeto, se necessário.
Em Estilos de mapa, selecione um estilo na lista.
Na página principal do estilo, selecione Personalizar.
Selecione a guia JSON para abrir o editor de estilo JSON.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-27 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/ios-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/ios-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**."]]