تحديد المشاكل وحلّها
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يوضّح هذا المستند المشاكل الشائعة التي قد تحدث عند إعداد نمط الخريطة وكيفية حلّها.
انقر على خطأ أو طلب ميزة.
المشاكل المعروفة
للاطّلاع على أحدث المشاكل المعروفة في تصميم الخرائط باستخدام السحابة الإلكترونية، يُرجى الاطّلاع على ملاحظات الإصدار.
الرسائل
في ما يلي بعض الرسائل التي قد تظهر لك والحلول المقترَحة لها:
لا يمكن ضبط سمة styles للخريطة في حال توفّر mapId.
لا يمكنك استخدام معرّفات الخرائط وأنماطها في الوقت نفسه. بدلاً من ذلك، عدِّل النمط المرتبط بمعرّف الخريطة باستخدام Cloud Console. راجِع أيضًا
تظهر لي رسالة خطأ عند محاولة تحميل نمط الخريطة.
يتعذّر تحميل "محرِّر الأنماط" الآن
تستخدِم خريطة المعاينة خريطة متجهة. في الحالات التي يتعذّر فيها تحميل الخرائط المتجهة على متصفّح الويب، يتم الرجوع إلى تجربة "لا توجد خريطة":
إذا واجهت هذه المشكلة، جرِّب ما يلي:
- تحقَّق من إعدادات المتصفّح للتأكّد من تفعيل ميزة "تسريع الأجهزة".
- تحقَّق مما إذا كان جهازك متوافقًا من خلال الانتقال إلى get.webgl.org. إذا لم يعمل العرض التوضيحي، قد لا يكون المتصفّح أو الجهاز متوافقًا مع WebGL. تأكَّد من أنّ مجموعة برامج التشغيل/المتصفح في جهازك لا تخضع لقواعد القائمة المرفوضة المحدّدة في موقع Khronos WebGL الإلكتروني.
- حدِّث بطاقة الرسومات وتأكَّد من أنّ جهازك يحتوي على بطاقة رسومات فيديو (وحدة معالجة الرسومات) متوافقة مع WebGL. يُرجى الاطّلاع على متطلبات التطبيقات والمواقع الإلكترونية.
للحصول على مزيد من الدعم، يُرجى الاطّلاع على التوافق مع WebGL في "منصة Google للتسويق".
مشاكل في الأسلوب
قد تظهر لك الرسائل التالية بعد إنشاء نمط أو تعديله.
لا يتم تعديل تغييرات الأسلوب في تطبيقاتي أو موقعي الإلكتروني
قد يستغرق نشر تغييرات الأنماط إلى تطبيقاتك ومواقعك الإلكترونية بضع ساعات، وقد يستغرق نشرها وقتًا أطول إذا كانت الأجهزة غير متصلة بالإنترنت. إذا لم تظهر لك تغييرات الأنماط بعد بضع ساعات، تحقَّق من ما يلي:
لا يمكنني رؤية التغييرات التي أجريتها على الأنماط في خريطة المعاينة
إذا أجريت تغييرًا ولم يظهر على خريطة المعاينة، إليك بعض الإجراءات التي يمكنك تجربتها.
التحقّق من تداخل الأنماط: لمزيد من التفاصيل، يُرجى الاطّلاع على إدارة الأنماط المتداخلة.
التحقّق من عمليات إلغاء وراثة الأنماط: تحقَّق مما إذا كان هناك نمط مخصّص للعنصر التابع ضمن النمط الذي تريد ضبطه، والذي يلغي نمط العنصر الرئيسي. للحصول على تفاصيل حول توريث الأنماط، يُرجى الاطّلاع على فهم توريث أنماط الخرائط وتسلسلها الهرمي.
تغيير مستوى التكبير أو التصغير في الخريطة: من المحتمل أنّ ميزات الخريطة التي تعمل على تصميمها غير مرئية في الخريطة عند مستوى التكبير أو التصغير الحالي.
التكبير: إذا كنت متأكدًا من أنّ الميزة متوفرة على الخريطة، يمكنك التكبير للحصول على عرض أكثر تفصيلاً، وقد تظهر الميزة.
التصغير: مع بعض عناصر الخريطة الكبيرة، قد تحتاج إلى التصغير
إلى أن تختفي عناصر الخريطة التفصيلية قبل ظهور التصميم.
يبدو النص مموَّهًا أو غير واضح
إذا لم يكن هناك تباين كافٍ بين الألوان التي اخترتها لملء النص وتعبئته، سيظهر الخط غامقًا وغير واضح لأنّ التعبئة والملء يندمجان معًا. اختَر ألوانًا ذات تباين كافٍ.
يبدو أسلوبي باهتًا أو باللون الخاطئ
قد تتداخل ميزة الخريطة التي تعمل على تصميمها مع ميزة واحدة أو أكثر من ميزات الخريطة الأخرى. للحصول على المساعدة، يُرجى الاطّلاع على إدارة الأنماط المتداخلة.
يتم تنسيق ميزات الخريطة غير الصحيحة
إذا كنت ترى عناصر خريطة تتطابق مع التصميم الذي حدّدته، قد يكون ذلك لأنّ تصميم الخريطة التلقائي لعناصر الخريطة هذه هو نفسه التصميم الذي حدّدته. إليك بعض الإجراءات التي يمكنك اتّخاذها:
أوقِف إمكانية الوصول إلى ميزة الخريطة المطابقة. على سبيل المثال، إذا كنت تحاول ضبط لون Winery على أحمر داكن، ولاحظت أنّ نقاط الاهتمام الخاصة بخدمات الطوارئ هي باللون الأحمر، قد يؤدي ذلك إلى إرباك المستخدمين. يمكنك اختيار إيقاف عرض "نقاط الاهتمام في حالات الطوارئ" لتجنُّب هذا الالتباس.
تغيير نمط عناصر الخريطة التي لا تريد مطابقتها
في المثال أعلاه، يمكنك أيضًا اختيار نمط باللون البرتقالي لنقاط الاهتمام الخاصة بالطوارئ
لتجنُّب حدوث أي التباس.
تظهر لي رسالة خطأ عند محاولة تحميل نمط الخريطة
لا يمكنك استخدام أرقام تعريف الخرائط وأنماطها في الوقت نفسه. يمكنك اتّخاذ أحد الإجراءات التالية:
يُنصح بما يلي: أزِل نمط الخريطة، وعدِّل النمط المرتبط بمعرّف الخريطة باستخدام Cloud Console. باستخدام هذه الطريقة، يمكنك إنشاء نمط واحد ينطبق على جميع الأنظمة الأساسية. لمعرفة التفاصيل، يُرجى الاطّلاع على
ربط نمط بمعرّف خريطة.
أزِل معرّف الخريطة، وعدِّل النمط لكل منصة تطبيق باستخدام تنسيق JSON.
بما أنّ تصميم JSON خاص بنظام أساسي معيّن، عليك إنشاء التصميم لكل نظام أساسي للتطبيق تعرض عليه الخرائط المصمَّمة.
إذا كان لديك حاليًا نمط خريطة بتنسيق JSON تريد استخدامه لتصميم الخرائط باستخدام السحابة الإلكترونية، يمكنك استيراده. للحصول على التفاصيل، يُرجى الاطّلاع على استيراد نمط خريطة بتنسيق JSON.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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)."]]
