عیب یابی
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
این سند مشکلات رایجی را که ممکن است هنگام تنظیم سبک نقشه شما رخ دهد و نحوه حل آنها توضیح می دهد.
برای ارسال یک درخواست اشکال یا ویژگی کلیک کنید.
مسائل شناخته شده
برای مشاهده آخرین مشکلات شناخته شده در زمینه طراحی نقشه های مبتنی بر ابر، به یادداشت های انتشار مراجعه کنید.
پیام ها
در اینجا چند پیام وجود دارد که ممکن است مشاهده کنید و راه حل های آنها:
هنگامی که mapId
وجود دارد، یک ویژگی map styles
قابل تنظیم نیست. شما نمی توانید از شناسه ها و سبک های نقشه به طور همزمان استفاده کنید. در عوض، سبک مرتبط با شناسه نقشه را با استفاده از کنسول Cloud ویرایش کنید. همچنین ببینید هنگام بارگیری سبک نقشه خود با خطا مواجه می شوم . ویرایشگر سبک در حال حاضر بارگیری نمی شود نقشه پیش نمایش از نقشه برداری استفاده می کند. در مواردی که نقشه های برداری را نمی توان در مرورگر وب شما بارگذاری کرد، به تجربه "بدون نقشه" برمی گردد:

اگر با این مشکل مواجه شدید، موارد زیر را امتحان کنید:
- تنظیمات مرورگر خود را بررسی کنید تا مطمئن شوید که شتاب سخت افزاری فعال است.
- با مراجعه به get.webgl.org بررسی کنید که آیا دستگاه شما پشتیبانی می شود. اگر نسخه آزمایشی اجرا نشود، ممکن است مرورگر یا دستگاه شما با WebGL سازگار نباشد. مطمئن شوید که ترکیب درایور/مرورگر دستگاه شما مشمول قوانین فهرست انکار تعریف شده در ویکی Khronos WebGL نیست.
- کارت گرافیک خود را به روز کنید و مطمئن شوید که دستگاه شما دارای کارت گرافیک ویدیویی (GPU) است که از WebGL پشتیبانی می کند. الزامات برنامه و وب سایت را ببینید.
برای پشتیبانی بیشتر، به پشتیبانی GMP WebGL مراجعه کنید.
مسائل مربوط به سبک
ممکن است پس از ایجاد یا بهروزرسانی یک سبک، پیامهای زیر را مشاهده کنید.
تغییرات سبک من در برنامه ها یا وب سایت من به روز نمی شود
انتشار تغییرات سبک ممکن است چند ساعت طول بکشد تا در برنامهها و وبسایتهای شما منتشر شود و اگر دستگاهها به اینترنت وصل نباشند، برنامهها ممکن است بیشتر طول بکشد. اگر بعد از چند ساعت هنوز تغییرات استایل خود را مشاهده نکردید، موارد زیر را بررسی کنید:
مطمئن شوید که بهروزرسانی سبک خود را منتشر کردهاید.
اگر تغییرات خود را به سبک تکراری انجام داده اید، مطمئن شوید که شناسه نقشه خود را با سبک تکراری مرتبط کرده اید. برای جزئیات، به مرتبط کردن یا حذف شناسههای نقشه در سبک خود مراجعه کنید.
من نمی توانم تغییرات سبک خود را در نقشه پیش نمایش ببینم
اگر تغییری ایجاد میکنید و نمیتوانید تغییر را در نقشه پیشنمایش ببینید، در اینجا چند چیز وجود دارد که باید امتحان کنید.
بررسی همپوشانی های سبک : برای جزئیات، به مدیریت سبک هایی که همپوشانی دارند مراجعه کنید.
بررسی تغییرات وراثت سبک : بررسی کنید که آیا یک سبک فرزند سفارشی در زیر سبکی که تنظیم میکنید وجود دارد که سبک والد آن را نادیده میگیرد یا خیر. برای جزئیات بیشتر در مورد وراثت سبک، به درک وراثت و سلسله مراتب سبک نقشه مراجعه کنید.
تغییر سطح بزرگنمایی نقشه : ممکن است ویژگیهای نقشهای که در حال طراحی آن هستید، در سطح بزرگنمایی فعلی در نقشه قابل مشاهده نباشند.
بزرگنمایی : اگر مطمئن هستید که این ویژگی روی نقشه وجود دارد، برای نمای دقیق تر زوم کنید و ممکن است ظاهر شود.
کوچکنمایی : با برخی از ویژگیهای نقشه بزرگ، ممکن است لازم باشد کوچکنمایی کنید تا زمانی که ویژگیهای نقشه دقیق قبل از نمایش استایل شما حذف شوند.
متن من تار یا خارج از فوکوس به نظر می رسد
اگر رنگ هایی که برای پر کردن و خط متن انتخاب کرده اید کنتراست کافی ندارند، فونت پررنگ و مبهم به نظر می رسد زیرا خط (طرح کلی) و پر با هم ادغام می شوند. رنگ هایی را انتخاب کنید که کنتراست کافی دارند.
استایل من کسل کننده یا رنگ اشتباه به نظر می رسد
ویژگی نقشه ای که در حال طراحی آن هستید ممکن است با یک یا چند ویژگی نقشه دیگر همپوشانی داشته باشد. برای کمک، به مدیریت سبک هایی که همپوشانی دارند مراجعه کنید.
ویژگی های نقشه اشتباه استایل دهی می شوند
اگر ویژگیهای نقشه را میبینید که با سبکی که تنظیم کردهاید مطابقت دارد، ممکن است سبک پیشفرض نقشه برای آن ویژگیهای نقشه با سبکی که تنظیم میکنید یکسان باشد. در اینجا مواردی وجود دارد که باید امتحان کنید:
قابلیت مشاهده را برای ویژگی نقشه که مطابقت دارد خاموش کنید . به عنوان مثال، اگر میخواهید Winery را روی قرمز تیره تنظیم کنید و متوجه میشوید که POIهای اضطراری قرمز هستند، که میتواند برای کاربران شما گیجکننده باشد. میتوانید برای جلوگیری از این سردرگمی، دید را برای POIهای اضطراری خاموش کنید.
سبک ویژگیهای نقشه را که نمیخواهید مطابقت داشته باشند، تغییر دهید . در مثال بالا، همچنین می توانید برای جلوگیری از سردرگمی، POI های اضطراری را به رنگ نارنجی انتخاب کنید.
در تلاش برای بارگیری سبک نقشه خود با خطا مواجه می شوم
شما نمی توانید از شناسه ها و سبک های نقشه به طور همزمان استفاده کنید. می توانید یکی از موارد زیر را انجام دهید:
توصیه می شود : سبک نقشه را حذف کنید و سبک مرتبط با شناسه نقشه را با استفاده از کنسول Cloud ویرایش کنید. با این روش می توانید یک سبک ایجاد کنید که برای همه پلتفرم ها کاربرد دارد. برای جزئیات، به مرتبط کردن یک سبک با شناسه نقشه مراجعه کنید.
شناسه نقشه را بردارید و با استفاده از افزودن یک نقشه سبک، سبک هر پلتفرم برنامه را ویرایش کنید. از آنجایی که استایلسازی JSON مختص پلتفرم است، باید برای هر پلتفرم برنامهای که نقشههای استایلشده را روی آن نمایش میدهید، سبک ایجاد کنید.
اگر از قبل یک سبک نقشه JSON دارید که میخواهید برای طراحی نقشههای مبتنی بر ابر استفاده کنید، میتوانید آن را وارد کنید. برای جزئیات، وارد کردن سبک نقشه JSON را ببینید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\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)."]]