문제 해결
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 문서에서는 지도 스타일을 설정할 때 발생할 수 있는 일반적인 문제와 해결 방법에 대해 설명합니다.
버그를 신고하거나 기능 요청을 제출하려면 클릭하세요.
알려진 문제
일부 관심 장소는 특정 확대/축소 수준에서 맞춤 스타일 지정 및 공개 상태 무시:
기본 지도에서 관심 장소가 강조 표시되면(굵게 표시된 텍스트) 맞춤 스타일 지정이 작동하지 않으며 공개 상태를 끄더라도 계속 표시됩니다. 이 문제는 관심 장소가 기본 지도에서 강조 표시되는 확대/축소 수준에서만 발생합니다.
텍스트 획이 경우에 따라 작동하지 않음: 텍스트 획 스타일 지정은 기본 지도에서 사용하지 않는 경우 항상 작동하지는 않습니다. 물의 경우 이러한 것으로 알려져 있습니다.
미리보기 지도가 경우에 따라 작동하지 않음: 이 버전의 미리보기 지도는 벡터 지도를 사용합니다. 벡터 지도를 웹브라우저에 로드할 수 없는 경우 '지도 없음' 환경으로 대체됩니다.
이 문제가 발생하면 다음을 시도해 보세요.
iOS 알려진 문제
- iOS 클라이언트는 라벨의 텍스트 획 색상을 보간하지 않습니다.
메시지
스타일을 작성하거나 업데이트한 후 다음 메시지가 표시될 수 있습니다.
일부 브라우저에는 추가 스타일 변경사항이 올바르게 표시되지 않을 수 있습니다. 추가로 스타일을 변경하지 않는 것이 좋습니다.
기존 버전 클라우드 스타일 지정의 지도 스타일에는 경할 수 있는 스타일 변경 횟수에 제한이 있습니다. 해당 제한에 도달한 스타일을 편집하려고 할 때 다음 메시지가 표시됩니다. 편집할 다른 스타일을 선택하거나 이 문제를 해결한 최신 클라우드 스타일 지정으로 이동할 수도 있습니다.
스타일 문제
스타일을 작성하거나 업데이트한 후 다음 메시지가 표시될 수 있습니다.
일부 관심 장소는 일부 확대/축소 수준에서 맞춤 스타일 지정 및 공개 상태를 무시합니다
기본 지도에서 관심 장소가 강조 표시되면(굵게 표시된 텍스트) 맞춤 스타일 지정이 적용되지 않으며 공개 상태를 끄더라도 계속 표시됩니다. 이 문제는 관심 장소가 기본 지도에서 강조 표시되는 확대/축소 수준에서만 발생합니다. 이는 알려진 문제입니다.
스타일 변경사항이 앱이나 웹사이트에서 업데이트되지 않습니다
스타일 변경사항이 앱과 웹사이트에 반영되기까지는 몇 시간이 걸릴 수 있으며, 앱의 경우 기기가 인터넷에 연결되어 있지 않으면 시간이 더 걸릴 수 있습니다. 몇 시간 후에도 스타일 변경사항이 표시되지 않으면 다음 사항을 확인하세요.
미리보기 지도에서 스타일 변경사항을 볼 수 없습니다
변경했는데 미리보기 지도에서 변경한 내용을 볼 수 없는 경우 다음과 같은 몇 가지 방법을 시도해 볼 수 있습니다.
스타일 겹침 확인: 자세한 내용은 겹치는 스타일 관리를 참고하세요.
스타일 상속 재정의 확인: 설정 중인 스타일 아래에 상위 스타일을 재정의하는 맞춤 하위 스타일이 있는지 확인합니다. 스타일 상속에 대한 자세한 내용은 지도 스타일 상속 및 계층 구조의 이해를 참고하세요.
지도 확대/축소 수준 변경: 스타일을 지정하고 있는 지도 지형지물이 현재 확대/축소 수준에서 지도에 표시되지 않을 수 있습니다.
텍스트가 흐리거나 초점이 맞지 않습니다
텍스트의 채우기와 획에 선택한 색상이 충분히 대비되지 않으면 획(윤곽선)과 채우기의 경계가 겹치면서 글꼴이 굵고 흐릿하게 보입니다. 대비가 충분한 색상을 선택합니다.
내가 지정한 스타일의 색깔이 탁하거나 다른 색으로 보입니다
스타일을 지정하는 지도 지형지물은 하나 이상의 다른 지도 지형지물과 겹칠 수 있습니다. 자세한 내용은 겹치는 스타일 관리를 참고하세요.
잘못된 지도 지형지물의 스타일이 지정되었습니다
설정한 스타일과 일치하는 지도 지형지물이 표시되는 경우 해당 지도 지형지물의 기본 지도 스타일이 설정 중인 스타일과 동일할 수 있습니다. 다음 방법을 시도해 보세요.
일치하는 지도 지형지물의 공개 상태를 끕니다. 예를 들어 와이너리를 진한 빨간색으로 설정하려고 할 때 응급 시설 관심 장소가 빨간색으로 표시되어 사용자에게 혼란을 줄 수 있습니다. 이러한 혼란을 피하기 위해 응급 시설 관심 장소의 공개 상태를 끌 수 있습니다.
일치시키지 않으려는 지도 지형지물의 스타일을 변경합니다.
위의 예에서 혼동을 피하기 위해 응급 시설 관심 장소의 스타일을 주황색으로 선택할 수도 있습니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2023-12-26(UTC)
[null,null,["최종 업데이트: 2023-12-26(UTC)"],[[["\u003cp\u003eThis document outlines troubleshooting steps for common issues encountered when using cloud-based map styling in the Google Maps Platform.\u003c/p\u003e\n"],["\u003cp\u003eIt addresses problems related to style updates, map display, visual appearance of map elements, and unintended styling of features.\u003c/p\u003e\n"],["\u003cp\u003eThe document provides guidance on resolving issues with legacy cloud styling access, style editor loading, style propagation delays, and overlapping or inherited styles.\u003c/p\u003e\n"],["\u003cp\u003eIt also offers suggestions for improving text clarity and color accuracy, and managing the styling of overlapping map features.\u003c/p\u003e\n"],["\u003cp\u003eUsers are encouraged to refer to the release notes for the latest known issues and utilize provided links for bug reporting and feature requests.\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/maps-static/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/maps-static/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/maps-static/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/maps-static/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/maps-static/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/maps-static/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/maps-static/cloud-customization/map-styles#json-import)."]]
