Dépannage
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Ce document décrit les problèmes courants qui peuvent survenir lorsque vous configurez votre style de carte et explique comment les résoudre.
Cliquez pour signaler un bug
ou demander une fonctionnalité.
Problèmes connus
Certains points d'intérêt ignorent le style personnalisé et la visibilité : à certains niveaux de zoom, si un point d'intérêt est mis en évidence (texte en gras) sur la carte de base, il reste visible même si vous désactivez la visibilité, et le style personnalisé ne fonctionne pas. Ce problème ne survient qu'aux niveaux de zoom où le point d'intérêt est mis en évidence sur la carte de base.
Le trait du texte ne fonctionne pas toujours : il arrive que ce style ne fonctionne pas lorsqu'il n'est pas utilisé dans la carte de base (c'est le cas pour l'eau).
L'aperçu de la carte ne se charge pas toujours : dans cette version, l'aperçu de la carte utilise une carte vectorielle. Lorsqu'il est impossible de charger des cartes vectorielles dans votre navigateur Web, celui-ci a recours à une interface "sans carte" :

Si vous rencontrez ce problème, essayez ce qui suit :
Problèmes connus sous iOS
- Le client iOS n'interpole pas la couleur du trait du texte pour les libellés.
Messages
Les messages suivants peuvent s'afficher après la création ou la mise à jour d'un style.
Les modifications de style ultérieures risquent de ne pas s'afficher correctement dans tous les navigateurs. Nous vous recommandons d'éviter ce type de modification.
Dans l'ancienne version de la personnalisation dans le cloud, les styles de carte limitent le nombre de modifications de style que vous pouvez effectuer. Ce message s'affiche lorsque vous essayez de modifier des styles qui ont atteint cette limite. Vous pouvez sélectionner un autre style à modifier ou passer à la dernière version de la personnalisation dans le cloud, qui a résolu ce problème.
Problèmes de style
Les messages suivants peuvent s'afficher après la création ou la mise à jour d'un style.
Certains points d'intérêt ignorent le style et la visibilité personnalisés à certains niveaux de zoom
Si un point d'intérêt est mis en avant (texte en gras) sur la carte de base, le style personnalisé ne fonctionne pas et il reste visible même si vous désactivez l'option Visibilité. Ce problème ne survient qu'aux niveaux de zoom où le point d'intérêt est mis en évidence sur la carte de base. Il s'agit d'un problème connu.
Mes changements de style ne sont pas reflétés dans mes applications ni sur mon site Web
La propagation des modifications de style dans les applications et les sites Web peut prendre quelques heures. Le délai pour les applications peut être plus long si les appareils ne sont pas connectés à Internet. Si vous ne voyez toujours pas les modifications de votre style au bout de quelques heures, vérifiez les points suivants :
Assurez-vous d'avoir publié la mise à jour de votre style.
Si vous avez apporté vos modifications dans un style dupliqué, assurez-vous d'avoir associé votre ID de carte au style dupliqué. Pour en savoir plus, consultez Associer des ID de carte à votre style ou en supprimer.
Mes modifications de style ne s'affichent pas sur l'aperçu de la carte
Si vous effectuez une modification et qu'elle ne s'affiche pas sur la carte d'aperçu, voici quelques conseils à suivre.
Rechercher les chevauchements de styles : pour en savoir plus, consultez Gérer les styles qui se chevauchent.
Rechercher des remplacements d'héritage de style : vérifiez si un style enfant personnalisé sous le style que vous définissez remplace son style parent. Pour en savoir plus sur l'héritage des styles, consultez Comprendre l'héritage et la hiérarchie des styles de carte.
Modifier le niveau de zoom de la carte : il est possible que les éléments cartographiques auxquels vous appliquez un style ne sont pas visibles sur la carte au niveau de zoom actuel.
Faire un zoom avant : si vous êtes sûr que l'élément cartographique est bien présent sur la carte, faites un zoom avant pour afficher une vue plus détaillée et le faire apparaître.
Faire un zoom arrière : pour certains éléments cartographiques volumineux, vous devrez peut-être effectuer un zoom arrière jusqu'à ce que les éléments détaillés de la carte soient supprimés avant que le style ne s'affiche.
Mon texte est flou
Si les couleurs de remplissage et de trait que vous avez choisies pour le texte ne sont pas assez contrastées, la police est floue, car le trait (contour) et le remplissage fusionnent. Sélectionnez des couleurs qui offrent un contraste suffisant.
Mon style est terne ou de couleur incorrecte
L'élément cartographique auquel vous appliquez un style peut chevaucher un ou plusieurs autres éléments cartographiques. Pour obtenir de l'aide, consultez Gérer les styles qui se chevauchent.
Le style n'est pas appliqué aux bons éléments cartographiques
Si vous constatez que des éléments cartographiques correspondent au style que vous avez défini, il est possible que le style de carte par défaut de ces éléments est identique à celui que vous avez défini. Voici quelques conseils que vous pouvez appliquer :
Désactivez la visibilité de l'élément cartographique correspondant. Par exemple, si vous essayez de définir "Vignoble" sur un rouge foncé et que vous remarquez que les POI d'urgence sont rouges, cela peut prêter à confusion pour vos utilisateurs. Pour éviter toute confusion, vous pouvez choisir de désactiver la visibilité des POI d'urgence.
Modifiez le style des éléments cartographiques de la carte que vous ne souhaitez pas faire correspondre. Dans l'exemple ci-dessus, vous pouvez également appliquer un style orange aux POI d'urgence pour éviter toute confusion.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2023/12/26 (UTC).
[null,null,["Dernière mise à jour le 2023/12/26 (UTC)."],[[["\u003cp\u003eThis guide addresses common issues encountered when setting up or customizing map styles in Google Cloud Platform.\u003c/p\u003e\n"],["\u003cp\u003eTroubleshooting steps are provided for various scenarios, such as style updates not appearing, preview map issues, blurry text, incorrect colors, and unintended feature styling.\u003c/p\u003e\n"],["\u003cp\u003eUsers can find information about legacy cloud styling access, known issues, and specific error messages within the document.\u003c/p\u003e\n"],["\u003cp\u003eSolutions offered include checking for style overlaps and inheritance overrides, adjusting zoom levels, ensuring sufficient color contrast, and managing feature visibility.\u003c/p\u003e\n"],["\u003cp\u003eLinks to relevant resources like release notes, WebGL support documentation, and specific setup guides are incorporated throughout the troubleshooting steps.\u003c/p\u003e\n"]]],["This document addresses troubleshooting map style issues across Android, iOS, JavaScript, and Web Service platforms. Common problems include style changes not updating, the style editor failing to load, and blurry text. Solutions involve checking browser settings, enabling hardware acceleration, updating graphics, and ensuring style publication. Issues may also arise from style overlaps, inheritance overrides, zoom level discrepancies, and insufficient color contrast. The document suggests managing overlapping features, adjusting visibility, and modifying unwanted matching styles. It highlights known issues with cloud based maps styling found in the release notes.\n"],null,["# Troubleshoot\n\nSelect platform: [Android](/maps/documentation/android-sdk/cloud-customization/troubleshoot \"View this page for the Android platform docs.\") [iOS](/maps/documentation/ios-sdk/cloud-customization/troubleshoot \"View this page for the iOS platform docs.\") [JavaScript](/maps/documentation/javascript/cloud-customization/troubleshoot \"View this page for the JavaScript platform docs.\") [Web Service](/maps/documentation/maps-static/cloud-customization/troubleshoot \"View this page for the Web Service platform docs.\")\n\n\u003cbr /\u003e\n\nThis document describes common issues that might occur when setting up your\nmap style, and how to resolve them.\n\nClick to file a\n[Bug](https://issuetracker.google.com/issues/new?component=1415514&template=1863115)\nor [Feature Request](https://issuetracker.google.com/issues/new?component=1415514&template=1863479).\n\nKnown issues\n------------\n\nTo see the latest known issues with cloud-based maps styling, see\nthe [release notes](../cbms-release-notes).\n\nMessages\n--------\n\nHere are some messages you might see and their solutions:\n\n\u003cbr /\u003e\n\nA map `styles` property cannot be set when a `mapId` is present. You cannot use map IDs and styles at the same time. Instead, edit the style associated with the map ID using the Cloud console. See also [I get an error trying to load my map style](#mapid-w-style).\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nThe style editor can't be loaded right now The preview map uses a vector map. In cases when vector maps cannot\nbe loaded on your web browser, it falls back to a \"no map\" experience:\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nIf you run into this issue, try the following:\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n- Check your browser settings to make sure hardware acceleration is enabled.\n- Check if your device is supported by visiting [get.webgl.org](https://get.webgl.org/). If the demo does not run, your browser or device may not be compatible with WebGL. Make sure your device's drivers/browser combination is not subject to the denylist rules defined in the [Khronos WebGL wiki](https://www.khronos.org/webgl/wiki/BlacklistsAndWhitelists).\n- Update your graphics card and make sure that your device has a video graphics card (GPU) that supports WebGL. See [Application and website\n requirements](/maps/documentation/ios-sdk/cloud-customization/setup#reqs).\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nFor additional support, see [GMP WebGL support](/maps/documentation/javascript/webgl/support).\n\n\u003cbr /\u003e\n\nStyle issues\n------------\n\nYou might see the following messages displayed after creating or updating\na style.\n\n### My style changes aren't updating in my apps or website\n\nStyle changes can take a few hours to propagate to your apps and websites, and\napps can take longer if the devices aren't connected to the internet. If you're\nstill not seeing your style changes after a few hours, check the following\nthings:\n\n- Make sure you've published your style update.\n\n- If you made your changes in a duplicated style, make sure you've associated\n your map ID with the duplicated style. For details, see\n [Associate or remove map IDs on your style](/maps/documentation/ios-sdk/cloud-customization/map-styles#associate-style-with-map-id).\n\n### I can't see my style changes on the preview map\n\nIf you make a change, and can't see the change on the preview map, here\nare some things to try.\n\n- **Check for style overlaps** : For details, see\n [Manage styles that overlap](/maps/documentation/ios-sdk/cloud-customization/overlap).\n\n- **Check for style inheritance overrides** : Check to see if there is a\n custom child style underneath the style you're setting that is overriding\n its parent style. For details on style inheritance, see\n [Understand map style inheritance and hierarchy](/maps/documentation/ios-sdk/cloud-customization/map-hier).\n\n- **Change the map zoom level**: It's possible that the map features you are\n styling are not visible in the map at the current zoom level.\n\n - **Zoom in**: If you are sure the feature is present on the map,\n zoom in to a more detailed view and it may appear.\n\n - **Zoom out**: With some large map features, you may need to zoom out\n until the detailed map features drop out before your styling shows up.\n\n### My text looks blurry or out of focus\n\nIf the colors you've chosen for your fill and stroke for text don't have\nenough contrast, the font looks bold and fuzzy because the stroke (outline)\nand fill merge together. Select colors that have enough contrast.\n\n### My style looks dull or the wrong color\n\nThe map feature you are styling may overlap with one or more other map\nfeatures. For assistance, see [Manage styles that overlap](/maps/documentation/ios-sdk/cloud-customization/overlap).\n\n### The wrong map features are being styled\n\nIf you are seeing map features that match the style you've set, it may be that\nthe default map style for those map features are the same as the style you're\nsetting. Here are some things to try:\n\n- **Turn off visibility for the map feature that matches**. For example,\n if you are trying to set Winery to a dark red, and notice that Emergency\n POIs are red, which could be confusing for your users. You can choose to\n turn off visibility for Emergency POIs to avoid this confusion.\n\n- **Change the style of the map features that you don't want to match**.\n the example above, you could also choose to style Emergency POIs to orange\n to avoid confusion.\n\n### I get an error trying to load my map style\n\nYou cannot use map IDs and styles at the same time. You can do one of the\nfollowing:\n\n- **Recommended** : Remove the map style, and edit the style associated with\n the map ID using the Cloud console. With this method, you can create one\n style that applies to all platforms. For details, see\n [Associate a style with a map ID](/maps/documentation/ios-sdk/cloud-customization/map-styles#associate-style-with-map-id).\n\n- Remove the map ID, and edit the style for each app platform using\n\n [Add a styled map](../styling).\n\n Since JSON styling is platform-specific, you need to create the style for each\n app platform on which you display the styled maps.\n\nIf you already have a JSON map style that you want to use for cloud-based\nmaps styling, you can import it. For details, see\n[Import a JSON map style](/maps/documentation/ios-sdk/cloud-customization/map-styles#json-import)."]]