Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Dokumen ini menjelaskan masalah umum yang mungkin terjadi saat menyiapkan gaya peta, dan cara mengatasinya.
Untuk melaporkan masalah atau mengajukan permintaan fitur, klik Bug atau Feature Request.
Masalah Umum
Sebagian lokasi menarik mengabaikan gaya visual kustom dan visibilitas:
Pada tingkat zoom tertentu, jika lokasi menarik ditandai (teks tebal) di peta dasar, gaya visual kustom tidak akan berfungsi, dan lokasi menarik masih terlihat meskipun jika Anda menonaktifkan visibilitas. Masalah ini hanya terjadi di tingkat zoom tempat lokasi menarik ditandai di peta dasar.
Goresan teks terkadang tidak berfungsi: Gaya visual goresan teks tidak selalu berfungsi jika tidak digunakan di peta dasar. Kasus yang telah diketahui terjadi pada Perairan.
Peta pratinjau terkadang tidak dimuat: Peta pratinjau untuk rilis ini menggunakan peta vektor. Jika tidak dapat dimuat di browser web Anda, peta vektor akan beralih kembali menjadi pengalaman "tidak ada peta":
Jika Anda mengalami masalah ini, coba lakukan tindakan berikut:
Coba gunakan kombinasi perangkat dan browser yang berbeda.
Masalah Umum iOS
Klien iOS tidak menginterpolasi warna goresan teks untuk label.
Pesan
Anda mungkin melihat pesan berikut ditampilkan setelah membuat atau memperbarui gaya.
Perubahan gaya lebih lanjut mungkin tidak ditampilkan dengan benar di semua browser. Sebaiknya hindari perubahan gaya lebih lanjut.
Gaya peta di gaya visual cloud versi lama memiliki batas jumlah perubahan gaya yang dapat Anda lakukan. Jika Anda mencoba mengedit gaya yang telah mencapai batas tersebut, Anda akan menerima pesan ini. Anda dapat memilih gaya yang berbeda untuk diedit, atau pertimbangkan untuk beralih ke gaya visual cloud terbaru yang telah memperbaiki masalah ini.
Masalah Gaya
Anda mungkin melihat pesan berikut ditampilkan setelah membuat atau memperbarui gaya.
Beberapa lokasi menarik mengabaikan gaya visual kustom dan visibilitas di beberapa tingkat zoom
Jika lokasi menarik disorot (teks tebal) di peta dasar, gaya visual kustom tidak akan berfungsi, dan lokasi menarik masih terlihat meskipun Anda menonaktifkan Visibilitas. Masalah ini hanya terjadi di tingkat zoom tempat lokasi menarik ditandai di peta dasar. Ini adalah masalah umum.
Perubahan gaya tidak diperbarui di peta atau situs saya
Perubahan gaya memerlukan waktu beberapa jam agar diterapkan di aplikasi dan situs Anda, dan aplikasi dapat memerlukan waktu lebih lama jika perangkat tidak terhubung ke internet. Jika Anda masih tidak melihat perubahan gaya setelah beberapa jam, periksa hal berikut:
Pastikan Anda telah memublikasikan pembaruan gaya.
Jika Anda telah melakukan perubahan pada gaya duplikat, pastikan Anda telah mengaitkan ID peta dengan gaya duplikat tersebut. Untuk mengetahui detailnya, lihat
Mengaitkan atau menghapus ID peta pada gaya Anda.
Saya tidak dapat melihat perubahan gaya di peta pratinjau
Jika Anda membuat perubahan, dan tidak dapat melihat perubahan di peta pratinjau, berikut beberapa hal yang bisa dicoba.
Periksa apakah ada penggantian warisan gaya: Periksa untuk melihat apakah ada gaya turunan kustom di bawah gaya yang sedang Anda siapkan yang menggantikan gaya induknya. Untuk mengetahui detail tentang warisan gaya, lihat Memahami warisan dan hierarki gaya peta.
Ubah tingkat zoom peta: Fitur peta yang sedang Anda tata gayanya mungkin tidak terlihat di peta pada tingkat zoom saat ini.
Perbesar: Jika Anda yakin bahwa fitur akan ada di peta, perbesar ke tampilan yang lebih detail dan fitur akan muncul.
Perkecil: Pada beberapa fitur peta yang besar, fitur peta mungkin perlu diperkecil sampai fitur peta yang detail menghilang agar gaya visual Anda ditampilkan.
Teks saya terlihat buram atau tidak fokus
Jika warna yang Anda pilih untuk isian dan goresan teks tidak cukup kontras, font akan terlihat tebal dan kabur karena goresan (garis batas) dan isian akan menyatu. Pilih warna yang cukup kontras.
Gaya saya terlihat tidak menarik atau salah warnanya
Fitur peta yang sedang Anda tata gayanya mungkin tumpang-tindih dengan satu atau beberapa fitur peta lainnya. Untuk mendapatkan bantuan, lihat Mengelola gaya yang tumpang-tindih.
Fitur peta yang salah sedang ditata gayanya
Jika Anda melihat fitur peta yang mirip dengan gaya yang Anda tetapkan, kemungkinan gaya peta default untuk fitur peta tersebut sama dengan gaya yang sedang Anda tetapkan. Anda dapat mencoba beberapa tindakan berikut ini:
Nonaktifkan visibilitas untuk fitur peta yang mirip. Misalnya,
jika Anda mencoba menetapkan Pabrik Anggur ke warna merah tua, dan melihat bahwa warna POI Darurat adalah merah, yang bisa membingungkan bagi pengguna Anda. Anda dapat memilih untuk menonaktifkan visibilitas untuk POI Darurat untuk menghindari kebingungan.
Ubah gaya fitur peta yang Anda tidak ingin terlihat mirip.
Menggunakan contoh di atas, Anda dapat juga memilih untuk menata gaya POI Darurat ke oranye untuk menghindari kebingungan.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2023-12-26 UTC."],[[["\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)."]]
