Najnowsze znane problemy z definiowaniem stylów map w Google Cloud znajdziesz w informacjach o wersji.
Wiadomości
Oto niektóre komunikaty, które możesz zobaczyć, i sposoby ich rozwiązania:
Jeśli atrybut mapId jest obecny, nie można ustawić atrybutu styles obiektu Map.
Nie możesz używać jednocześnie identyfikatorów map i stylów. Zamiast tego edytuj styl powiązany z identyfikatorem mapy za pomocą konsoli Google Cloud. Zobacz też:Podczas próby wczytania stylu mapy pojawia się błąd.
W tej chwili nie można wczytać edytora stylów
Mapa podglądu korzysta z mapy wektorowej. Jeśli map wektorowych nie można wczytać w przeglądarce, wyświetla się komunikat „Brak mapy”:
Jeśli napotkasz ten problem, spróbuj wykonać te czynności:
Sprawdź ustawienia przeglądarki, aby upewnić się, że akceleracja sprzętowa jest włączona.
Sprawdź, czy Twoje urządzenie jest obsługiwane, na stronie get.webgl.org. Jeśli wersja demonstracyjna nie działa, Twoja przeglądarka lub urządzenie może nie być zgodne z technologią WebGL. Sprawdź, czy kombinacja sterowników urządzenia i przeglądarki nie podlega regułom odrzucania zdefiniowanym w wiki Khronos WebGL.
Zaktualizuj kartę graficzną i sprawdź, czy urządzenie jest wyposażone w kartę graficzną (GPU) z obsługą technologii WebGL. Zobacz wymagania dotyczące aplikacji i strony.
Po utworzeniu lub zaktualizowaniu stylu mogą się wyświetlić te komunikaty:
Zmiany stylu nie są aktualizowane w aplikacjach ani w witrynie
Wprowadzenie zmian w stylu w aplikacjach i witrynach może potrwać kilka godzin. W przypadku aplikacji może to zająć więcej czasu, jeśli urządzenia nie są połączone z internetem. Jeśli po kilku godzinach nadal nie widzisz zmian stylu, sprawdź następujące kwestie:
Sprawdź, czy aktualizacja stylu została opublikowana.
Sprawdź, czy nie ma zastąpień dziedziczenia stylu: sprawdź, czy pod stylem, który ustawiasz, nie ma niestandardowego stylu podrzędnego, który zastępuje styl nadrzędny. Więcej informacji o dziedziczeniu stylów znajdziesz w artykule Omówienie dziedziczenia i hierarchii stylów map.
Zmień poziom powiększenia mapy: może się zdarzyć, że elementy mapy, które chcesz ostylować, nie są widoczne na mapie przy obecnym poziomie powiększenia.
Powiększ: jeśli masz pewność, że element znajduje się na mapie, powiększ widok, aby zobaczyć więcej szczegółów.
Pomniejszanie: w przypadku niektórych dużych elementów mapy może być konieczne pomniejszenie, aż szczegółowe elementy mapy znikną, zanim pojawi się styl.
Tekst jest rozmyty lub nieostry
Jeśli wybrane przez Ciebie kolory wypełnienia i kreski tekstu nie mają wystarczającego kontrastu, czcionka wygląda na pogrubioną i rozmazaną, ponieważ kreska (kontur) i wypełnienie zlewają się ze sobą. Wybierz kolory o wystarczającym kontraście.
Mój styl wygląda na matowy lub ma niewłaściwy kolor
Stylizowany element mapy może nakładać się na co najmniej 1 inny element mapy. Więcej informacji znajdziesz w artykule Zarządzanie stylami, które się pokrywają.
Stylizowane są nieprawidłowe elementy mapy
Jeśli widzisz funkcje mapy, które pasują do ustawionego stylu, może to oznaczać, że domyślny styl mapy dla tych funkcji jest taki sam jak ustawiony przez Ciebie styl. Oto kilka czynności, które możesz wykonać:
Wyłącz widoczność elementu mapy, który pasuje do kryteriów. Jeśli na przykład chcesz ustawić kolor winiarni na ciemnoczerwony i zauważysz, że punkty POI związane z sytuacjami awaryjnymi są czerwone, co może być mylące dla użytkowników. Aby uniknąć nieporozumień, możesz wyłączyć widoczność alarmowych punktów POI.
Zmień styl elementów mapy, które nie mają być dopasowane. W przykładzie powyżej możesz też zmienić styl ważnych obiektów związanych z sytuacjami awaryjnymi na pomarańczowy, aby uniknąć pomyłki.
Podczas próby wczytania stylu mapy pojawia się błąd
Nie możesz jednocześnie używać identyfikatorów map i stylów. Możesz wykonać jedną z tych czynności:
Zalecane: usuń styl mapy i edytuj styl powiązany z identyfikatorem mapy za pomocą konsoli Cloud. W ten sposób możesz utworzyć jeden styl, który będzie stosowany na wszystkich platformach. Szczegółowe informacje znajdziesz w artykule Powiązywanie stylu z identyfikatorem mapy.
Usuń identyfikator mapy i edytuj styl dla każdej platformy aplikacji za pomocą stylów JSON.
Dostosowywanie stylu za pomocą JSON-a jest specyficzne dla platformy, dlatego musisz utworzyć styl dla każdej platformy aplikacji, na której wyświetlasz mapy ze stylem.
Jeśli masz już styl mapy w formacie JSON, którego chcesz użyć do definiowania stylów map w Google Cloud, możesz go zaimportować. Więcej informacji znajdziesz w artykule Importowanie stylu mapy JSON.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-09-05 UTC."],[[["\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)."]]
