Sorun giderme
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bu belgede, harita stilinizi ayarlarken ortaya çıkabilecek yaygın sorunlar ve bunların nasıl çözüleceği açıklanmaktadır.
Hata veya Özellik İsteği göndermek için tıklayın.
Bilinen sorunlar
Bulut tabanlı harita stilleriyle ilgili bilinen en son sorunları görmek için sürüm notlarına göz atın.
Mesajlar
Görebileceğiniz bazı mesajlar ve çözümleri aşağıda verilmiştir:
mapId mevcutken bir haritanın styles özelliği ayarlanamaz.
Harita kimliklerini ve stillerini aynı anda kullanamazsınız. Bunun yerine, Cloud Console'u kullanarak harita kimliğiyle ilişkili stili düzenleyin. Ayrıca, Harita stilimi yüklemeye çalışırken hata alıyorum başlıklı makaleyi de inceleyin.
Stil düzenleyici şu anda yüklenemiyor
Önizleme haritasında vektör harita kullanılır. Vektör haritaların web tarayıcınıza yüklenemediği durumlarda, "harita yok" deneyimine geri dönülür:
Bu sorunla karşılaşırsanız aşağıdakileri deneyin:
- Donanım hızlandırmanın etkinleştirildiğinden emin olmak için tarayıcı ayarlarınızı kontrol edin.
- Cihazınızın desteklenip desteklenmediğini kontrol etmek için get.webgl.org adresini ziyaret edin. Demo çalışmıyorsa tarayıcınız veya cihazınız WebGL ile uyumlu olmayabilir. Cihazınızın sürücü/tarayıcı kombinasyonunun, Khronos WebGL wiki'de tanımlanan reddetme listesi kurallarına tabi olmadığından emin olun.
- Grafik kartınızı güncelleyin ve cihazınızda WebGL'yi destekleyen bir video grafik kartı (GPU) olduğundan emin olun. Uygulama ve web sitesi
şartları başlıklı makaleyi inceleyin.
Ek destek için GMP WebGL desteği başlıklı makaleyi inceleyin.
Stil sorunları
Stil oluşturduktan veya güncelledikten sonra aşağıdaki mesajlar gösterilebilir.
Stil değişikliklerim uygulamalarımda veya web sitemde güncellenmiyor
Stil değişikliklerinin uygulamalarınıza ve web sitelerinize yansıtılması birkaç saat sürebilir. Cihazlar internete bağlı değilse uygulamaların güncellenmesi daha uzun sürebilir. Birkaç saat geçmesine rağmen stil değişikliklerinizi hâlâ görmüyorsanız aşağıdakileri kontrol edin:
Stil değişikliklerimi önizleme haritasında göremiyorum
Bir değişiklik yaparsanız ve bu değişikliği önizleme haritasında göremezseniz deneyebileceğiniz bazı yöntemler aşağıda verilmiştir.
Stil çakışmalarını kontrol etme: Ayrıntılı bilgi için Çakışan stilleri yönetme başlıklı makaleyi inceleyin.
Stil devralma geçersiz kılmalarını kontrol edin: Ayarladığınız stilin altında, üst stilini geçersiz kılan özel bir alt stil olup olmadığını kontrol edin. Stil devralma hakkında ayrıntılı bilgi için Harita stili devralma ve hiyerarşisini anlama başlıklı makaleyi inceleyin.
Harita yakınlaştırma düzeyini değiştirme: Şekillendirdiğiniz harita özellikleri, mevcut yakınlaştırma düzeyinde haritada görünmüyor olabilir.
Yakınlaştırma: Özelliğin haritada bulunduğundan eminseniz daha ayrıntılı bir görünüm için yakınlaştırın. Özellik görünebilir.
Uzaklaştırma: Bazı büyük harita özelliklerinde, stiliniz görünmeden önce ayrıntılı harita özelliklerinin kaybolması için uzaklaştırmanız gerekebilir.
Metnim bulanık veya net değil görünüyor
Metin için dolgu ve kontur olarak seçtiğiniz renkler yeterli kontrasta sahip değilse kontur (ana hat) ve dolgu birleştiğinden yazı tipi kalın ve bulanık görünür. Yeterli kontrasta sahip renkler seçin.
Stilim soluk veya yanlış renkte görünüyor
Stil uyguladığınız harita özelliği, bir veya daha fazla harita özelliğiyle çakışıyor olabilir. Yardım için Çakışan stilleri yönetme başlıklı makaleyi inceleyin.
Yanlış harita özellikleri şekillendiriliyor
Belirlediğiniz stile uygun harita özellikleri görüyorsanız bu harita özelliklerinin varsayılan harita stili, belirlediğiniz stille aynı olabilir. Deneyebileceğiniz birkaç öneri:
Eşleşen harita özelliğinin görünürlüğünü devre dışı bırakın. Örneğin, Şaraphaneyi koyu kırmızı olarak ayarlamaya çalışıyorsanız ve Acil Durum Önemli Yerleri'nin kırmızı olduğunu fark ederseniz bu durum kullanıcılarınız için kafa karıştırıcı olabilir. Bu karışıklığı önlemek için acil durum önemli yerlerinin görünürlüğünü kapatabilirsiniz.
Eşleşmesini istemediğiniz harita özelliklerinin stilini değiştirin.
Yukarıdaki örnekte, karışıklığı önlemek için Acil Durum Önemli Yerleri'ni turuncu renkte stilize etmeyi de seçebilirsiniz.
Harita stilimi yüklemeye çalışırken hata alıyorum
Harita kimliklerini ve stillerini aynı anda kullanamazsınız. Aşağıdakilerden birini yapabilirsiniz:
Önerilen: Harita stilini kaldırın ve Cloud Console'u kullanarak harita kimliğiyle ilişkili stili düzenleyin. Bu yöntemle, tüm platformlarda geçerli olacak bir stil oluşturabilirsiniz. Ayrıntılar için Stili harita kimliğiyle ilişkilendirme başlıklı makaleyi inceleyin.
Harita kimliğini kaldırın ve JSON stilini kullanarak her uygulama platformunun stilini düzenleyin.
JSON stili platforma özgü olduğundan, stillendirilmiş haritaları gösterdiğiniz her uygulama platformu için stili oluşturmanız gerekir.
Bulut tabanlı harita stilleri için kullanmak istediğiniz bir JSON harita stiliniz varsa bunu içe aktarabilirsiniz. Ayrıntılar için JSON harita stili içe aktarma başlıklı makaleyi inceleyin.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-31 UTC.
[null,null,["Son güncelleme tarihi: 2025-08-31 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)."]]
