疑難排解
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
本文說明設定地圖樣式時,可能發生的常見問題及解決方法。
按一下滑鼠,就能回報錯誤或提出功能要求。
已知問題
請參閱「版本資訊」一文,瞭解雲端式地圖樣式設定有哪些最新的已知問題,
訊息
以下列出您可能會看到的訊息和解決方法:
如果已使用 mapId
屬性,就無法設定地圖的 styles
屬性。
您無法同時使用地圖 ID 和樣式。請改用 Cloud 控制台編輯與地圖 ID 相關聯的樣式。另請參閱「載入地圖樣式時發生錯誤」。
目前無法載入樣式編輯器
預覽地圖會使用向量地圖。如果網路瀏覽器無法載入向量地圖,就會轉換回「無地圖」體驗:

如果遇到此問題,請採取以下做法:
如需其他支援,請參閱 GMP WebGL 支援。
樣式問題
您建立或更新樣式後,可能會看到以下訊息:
我對樣式所做的變更沒有反映在應用程式或網站中
樣式變更可能要過幾小時後,才會反映在應用程式和網站中。如果裝置未連上網路,應用程式可能需要更久的時間,才會顯示樣式變更。如果過了幾小時後,還是沒有看到對樣式所做的變更,請確認以下事項:
我對樣式所做的變更沒有反映在預覽地圖上
要是您所做的變更沒有反映在預覽地圖上,不妨採取以下幾種做法。
檢查是否有樣式重疊:詳情請參閱「管理重疊的樣式」一文。
檢查是否有因為沿用樣式,而造成覆蓋的情況:檢查您要設定的樣式之下,是否有任何自訂子樣式會覆蓋父樣式。如要進一步瞭解樣式沿用機制,請參閱「瞭解地圖樣式的沿用機制和階層」一文。
變更地圖縮放等級:地圖可能無法在目前的縮放等級下,顯示您要設定樣式的地圖項目。
我的文字看起來模糊或失焦
要是您選用的填滿和外框顏色對比不夠明顯,外框 (輪廓) 和填滿區域會融為一體,字型看起來就會偏粗且模糊。請選取對比夠明顯的顏色。
我的樣式看起來顏色黯淡或走色
您要設定樣式的地圖項目,可能與另外一或多個地圖項目重疊。如需相關協助,請參閱「管理重疊的樣式」一文。
樣式套用至錯誤的地圖項目
如果發現有些地圖項目的樣式與您設定的樣式相同,可能是因為這些地圖項目的預設地圖樣式與您設定的樣式剛好相同。請嘗試下列幾種處理方式:
嘗試載入地圖樣式時發生錯誤
您無法同時使用地圖 ID 和樣式。您可以執行下列其中一項操作:
如果您已有想用於雲端式地圖樣式設定的 JSON 地圖樣式,可以匯入該樣式。詳情請參閱「匯入 JSON 地圖樣式」。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-08-27 (世界標準時間)。
[null,null,["上次更新時間:2025-08-27 (世界標準時間)。"],[[["\u003cp\u003eThis documentation addresses common issues encountered when setting up map styles within Google Cloud Platform and provides troubleshooting steps.\u003c/p\u003e\n"],["\u003cp\u003eUsers might experience issues with legacy cloud styling access, style updates not propagating, preview map display errors, blurry text, and incorrect feature styling.\u003c/p\u003e\n"],["\u003cp\u003eSolutions include checking style overlaps, inheritance overrides, zoom levels, color contrast, and feature visibility settings.\u003c/p\u003e\n"],["\u003cp\u003eThe document links to relevant resources such as release notes, WebGL support, and specific troubleshooting guides for managing style overlaps and understanding style hierarchy.\u003c/p\u003e\n"],["\u003cp\u003eUsers can report bugs and feature requests through provided links to Google's issue tracker.\u003c/p\u003e\n"]]],[],null,["Select 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\nTo see the latest known issues with cloud-based maps styling, see\nthe [release notes](../cbms-release-notes).\n\nMessages\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/javascript/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\nYou might see the following messages displayed after creating or updating\na style.\n\nMy 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/javascript/cloud-customization/map-styles#associate-style-with-map-id).\n\nI 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/javascript/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/javascript/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\nMy 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\nMy 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/javascript/cloud-customization/overlap).\n\nThe 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\nI 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/javascript/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 [JSON styling](/maps/documentation/javascript/json-styling-overview).\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/javascript/cloud-customization/map-styles#json-import)."]]