Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Auf dieser Seite finden Sie Informationen zu bekannten Problemen sowie Problemumgehungen für Vektorkarten und WebGL-Funktionen.
Browser-/Geräteunterstützung
Die WebGL-Funktionsvorschau wird von denselben Browsern und Geräten unterstützt wie die Maps JavaScript API.
Ob WebGL im Browser eines bestimmten Geräts unterstützt wird, können Sie unter get.webgl.org oder caniuse.com prüfen. Außerdem muss die Hardwarebeschleunigung in den Browsereinstellungen aktiviert sein. Sonst werden Vektorkarten in Rasterkarten umgewandelt.
Raster oder Vektor?
Manchmal werden Vektorkarten als Ausweichlösung in Rasterkarten umgewandelt. In diesem Fall sind Funktionen, für die die Vektorkarte erforderlich ist, nicht verfügbar. Es kann mehrere Gründe geben, warum eine Rasterkarte in eine Vektorkarte umgewandelt wird. In diesem Abschnitt erfahren Sie, wie Sie Ihren Browser richtig konfigurieren und wie Sie programmatisch prüfen können, ob Vektorkarten unterstützt werden.
Browserfunktionen in Chrome prüfen
Um herauszufinden, welche Funktionen für die Hardwarebeschleunigung in einer bestimmten Chrome-Installation aktiviert sind, rufen Sie chrome://gpu/ auf. Die folgenden Elemente müssen aktiviert (grün) sein:
OpenGL: Enabled
WebGL: Hardware accelerated
WebGL2: Hardware accelerated
Dies sind nur die Grundvoraussetzungen. Es können andere Faktoren zutreffen, die sich auf die Unterstützung auswirken, siehe „Bekannte Programmfehler“ weiter unten.
Hardwarebeschleunigung aktivieren
Damit Vektorkarten dargestellt werden können, muss in den meisten Browsern die Hardwarebeschleunigung aktiviert sein. Um die Hardwarebeschleunigung in Chrome und Microsoft Edge zu aktivieren, rufen Sie die Einstellungen auf und wählen Sie System aus. Hardwarebeschleunigung verwenden, falls verfügbar muss aktiviert sein.
Programmatisch prüfen, ob eine Raster- oder Vektorkarte verwendet wird
Sie können map.getRenderingType() aufrufen, um programmatisch zu prüfen, ob eine Raster- oder Vektorkarte verwendet wird. Das folgende Beispiel zeigt Code zur Überwachung des Ereignisses renderingtype_changed und zur Anzeige eines Infofensters, in dem angegeben wird, ob eine Raster- oder Vektorkarte verwendet wird.
TypeScript
/** * This example creates a map with an info window that shows whether * the map render type is raster or vector. */functioninitMap(){constcenter={lat:0,lng:0};constmap=newgoogle.maps.Map(document.getElementById('map')asHTMLElement,{center,zoom:10,heading:0.0,tilt:0.0,// Map ID for a vector map.mapId:'6ff586e93e18149f',});constcanvas=document.createElement("canvas");constinfoWindow=newgoogle.maps.InfoWindow({content:'',ariaLabel:'Raster/Vector',position:center,});infoWindow.open({map,});map.addListener('renderingtype_changed',()=>{infoWindow.setContent(`${map.getRenderingType()}`);});}declareglobal{interfaceWindow{initMap:()=>void;}}window.initMap=initMap;
/** * This example creates a map with an info window that shows whether * the map render type is raster or vector. */functioninitMap(){constcenter={lat:0,lng:0};constmap=newgoogle.maps.Map(document.getElementById("map"),{center,zoom:10,heading:0.0,tilt:0.0,// Map ID for a vector map.mapId:"6ff586e93e18149f",});constcanvas=document.createElement("canvas");constinfoWindow=newgoogle.maps.InfoWindow({content:"",ariaLabel:"Raster/Vector",position:center,});infoWindow.open({map,});map.addListener("renderingtype_changed",()=>{infoWindow.setContent(`${map.getRenderingType()}`);});}window.initMap=initMap;
Um zu prüfen, ob WebGL 2 unterstützt wird, können Sie auch den WebGL-Renderingkontext verwenden.
constcanvas=document.createElement("canvas");canvas.getContext("webgl2")?console.log("WebGL 2 is supported"):console.log("WebGL 2 is NOT supported");
Andere Möglichkeiten zum programmatischen Erkennen von WebGL-Renderingkontext finden Sie hier.
Unterstützung im mobilen Web
Die Unterstützung von Vektorkarten im mobilen Web befindet sich noch in einer experimentellen Phase. Entwickler können über Client-APIs den mobilen Webbrowser ermitteln und eine Karten-ID verwenden, die mit einer Rasterkarte und nicht mit einer Vektorkarte verknüpft ist. Bei einigen Mobilgeräten dauert das Rendering voraussichtlich länger. Wenn Sie sich für den Einsatz von Vektorkarten im mobilen Web entscheiden, freuen wir uns auf Ihr Feedback sowie Informationen zur Leistung. Falls Vektorkarten nicht unterstützt werden, wird wie oben beschrieben für eine Vektorkarten-ID automatisch eine Rasterkarte verwendet.
Programmfehler
Bekannte Programmfehler
Es gibt ein bekanntes Problem in Chrome bei einigen macOS-Geräten mit AMD-GPUs. Das Problem kann besonders schwer durchschaubar sein, wenn macOS bei Geräten mit mehreren GPUs dynamisch zwischen GPUs wechselt, sodass Vektorkarten eventuell nicht verfügbar sind, wenn bestimmte andere Anwendungen laufen oder ein externer Bildschirm angeschlossen ist.
In manchen Fällen scheint es zu helfen, das für Chrome angekündigte ANGLE Metal-Backend in Chrome zu aktivieren. Allgemeine Pläne für das Roll-out finden Sie unter
https://bugs.chromium.org/p/chromium/issues/detail?id=1322521.
Fehler melden
Aktualisieren Sie den Browser und GPU-Treiber auf die neueste Version, bevor Sie den Fehler melden.
Die Einstellung für die Hardwarebeschleunigung muss unter chrome://settings/system (Chrome), about:preferences#general (Firefox) oder edge://settings/system (Microsoft Edge) aktiviert sein. In Safari ist sie ab macOS-Version 10.15 automatisch aktiviert. Rufen Sie bei älteren macOS-Versionen die erweiterten Safari-Einstellungen auf und sehen Sie nach, ob die Option zur Nutzung der Hardwarebeschleunigung aktiviert ist.
Geben Sie im Fehlerbericht den Link zum JSFiddle-Beispielcode an.
Falls Probleme beim Rendering auftreten, machen Sie einen Screenshot von chrome://gpu (Chrome), about:support (Firefox) oder edge://gpu (Microsoft Edge) und fügen Sie Informationen zur GPU an den Fehlerbericht an.
Feedback geben
Ihr Feedback ist uns wichtig, weil wir möchten, dass die Nutzung von Vektorkarten für Sie und Ihre Endnutzer möglichst reibungslos funktioniert. Bitte wenden Sie sich an uns, wenn Folgendes zutrifft:
Sie haben in Ihren Webanwendungen neue JavaScript-Fehler, allgemeine Fehler oder Abstürze festgestellt.
Die Latenz beim Start ist bei Vektorkarten erheblich schlechter als bei Rasterkarten. In diesem Fall ist es hilfreich, wenn Sie uns Messwerte für die Regression der Startlatenz senden. In der Regel möchten wir von Ihnen wissen, ob die Startlatenz die zulässigen Grenzwerte überschreitet.
Die Vektorkarten funktionieren nicht wie erwartet. Wie unterscheiden sich die Messwerte zur Framerate oder zu Verzögerungen zwischen Vektor- und Rasterkarten?
Die Leistung kann je nach Browser stark variieren.
Wenn Sie A/B-Tests für einen Vergleich zwischen Vektor- und Rasterkarten eingerichtet haben, teilen Sie uns bitte Feedback zur Leistung mit. Das hilft uns, die Funktion gezielt weiterzuentwickeln.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-09-05 (UTC)."],[[["\u003cp\u003eThis page addresses known issues and workarounds for vector maps and WebGL features in Google Maps.\u003c/p\u003e\n"],["\u003cp\u003eHardware acceleration must be enabled in your browser settings for vector maps to function correctly; instructions for various browsers are provided.\u003c/p\u003e\n"],["\u003cp\u003eYou can programmatically determine if a map is rendering in vector or raster mode using the \u003ccode\u003emap.getRenderingType()\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eThere are known issues with vector maps on certain macOS devices with AMD GPUs in Chrome, potentially due to dynamic GPU switching.\u003c/p\u003e\n"],["\u003cp\u003eFeedback on performance, bugs, and user experience with vector maps is encouraged to help improve the feature.\u003c/p\u003e\n"]]],["This document details vector map and WebGL feature support, troubleshooting, and usage. Key actions include: checking browser support via `get.webgl.org` or `caniuse.com`; enabling hardware acceleration in browser settings; using `chrome://gpu/` to verify hardware acceleration in Chrome; and programmatically checking for raster or vector maps using `map.getRenderingType()`. The document also covers mobile web support limitations, known bugs, and how to report them, including updating browsers/drivers and providing relevant diagnostic information.\n"],null,["# Support\n\nThis page lists known issues and workarounds for vector maps and WebGL features.\n\nBrowser/device support\n----------------------\n\nThe WebGL feature preview supports the same browsers and devices as the Maps JavaScript API.\nTo check whether the browser on a particular device will support WebGL, visit [get.webgl.org](https://get.webgl.org/)\nor [caniuse.com](https://caniuse.com/?search=webgl). Please also ensure the\nhardware acceleration is enabled in the browser settings, otherwise vector maps\nwill revert to [raster](#raster-fallback).\n\nRaster or vector?\n-----------------\n\nOccasionally, a vector map may fall back to raster. When this happens, features\ndepending on the vector map are unavailable. Fallback to a raster map may occur\nfor a variety of reasons. This section shows you how to correctly configure\nyour web browser, and how to programmatically check whether vector map\ncapability is present.\n\n### Check browser capabilities on Chrome\n\nTo determine which hardware acceleration capabilities are enabled in a specific\ninstallation of Chrome, navigate to \u003cchrome://gpu/\u003e, and ensure\nthat the following items are enabled (in green):\n\n- \"OpenGL: Enabled\"\n- \"WebGL: Hardware accelerated\"\n- \"WebGL2: Hardware accelerated\"\n\n(These are just baseline requirements, there can be other factors which\nimpact support, see \"Known bugs\" below.)\n\n### Enable hardware acceleration\n\nIn order to support vector maps, hardware acceleration must be enabled in most\nbrowsers. To enable hardware acceleration in Chrome and Microsoft Edge, open\n**Settings** , select **System** , and ensure that **Use hardware acceleration\nwhen available** is enabled.\n\n- Learn how to [change websites preferences in Safari](https://support.apple.com/guide/safari/websites-ibrwe2159f50/14.0/mac/11.0).\n- Learn about [Firefox's performance settings](https://support.mozilla.org/en-US/kb/performance-settings).\n\n### Programmatically check for raster or vector\n\nYou can programmatically check to see whether a map is raster or vector, by\ncalling `map.getRenderingType()`. The following example shows code to monitor\nthe `renderingtype_changed` event, and show an info window displaying whether a\nraster or vector map is in use.\n\n\n### TypeScript\n\n```typescript\n/**\n * This example creates a map with an info window that shows whether\n * the map render type is raster or vector.\n */\n\n function initMap() {\n const center = {lat: 0, lng: 0};\n const map = new google.maps.Map(document.getElementById('map') as HTMLElement, {\n center,\n zoom: 10,\n heading: 0.0,\n tilt: 0.0,\n // Map ID for a vector map.\n mapId: '6ff586e93e18149f',\n });\n const canvas = document.createElement(\"canvas\");\n const infoWindow = new google.maps.InfoWindow({\n content: '',\n ariaLabel: 'Raster/Vector',\n position: center,\n });\n infoWindow.open({\n map,\n });\n\n map.addListener('renderingtype_changed', () =\u003e {\n infoWindow.setContent(`${map.getRenderingType()}`);\n });\n }\n\n declare global {\n interface Window {\n initMap: () =\u003e void;\n }\n }\n window.initMap = initMap;https://github.com/googlemaps/js-samples/blob/2683f7366fb27829401945d2a7e27d77ed2df8e5/samples/vector-detector/index.ts#L8-L43\n```\n| **Note:** Read the [guide](/maps/documentation/javascript/using-typescript) on using TypeScript and Google Maps.\n\n### JavaScript\n\n```javascript\n/**\n * This example creates a map with an info window that shows whether\n * the map render type is raster or vector.\n */\nfunction initMap() {\n const center = { lat: 0, lng: 0 };\n const map = new google.maps.Map(document.getElementById(\"map\"), {\n center,\n zoom: 10,\n heading: 0.0,\n tilt: 0.0,\n // Map ID for a vector map.\n mapId: \"6ff586e93e18149f\",\n });\n const canvas = document.createElement(\"canvas\");\n const infoWindow = new google.maps.InfoWindow({\n content: \"\",\n ariaLabel: \"Raster/Vector\",\n position: center,\n });\n\n infoWindow.open({\n map,\n });\n map.addListener(\"renderingtype_changed\", () =\u003e {\n infoWindow.setContent(`${map.getRenderingType()}`);\n });\n}\n\nwindow.initMap = initMap;https://github.com/googlemaps/js-samples/blob/2683f7366fb27829401945d2a7e27d77ed2df8e5/dist/samples/vector-detector/docs/index.js#L7-L36\n```\n\n\u003cbr /\u003e\n\nYou can also use the WebGL rendering context to check support for WebGL 2: \n\n const canvas = document.createElement(\"canvas\");\n canvas.getContext(\"webgl2\") ? console.log(\"WebGL 2 is supported\") : console.log(\"WebGL 2 is NOT supported\");\n\nLearn other ways to [programmatically detect WebGL rendering context](https://developer.mozilla.org/en-US/docs/Web/API/WebGL_API/By_example/Detect_WebGL).\n\nMobile web support\n------------------\n\nMobile web support for vector maps is still experimental. Developers can use\nclient APIs to detect mobile web browsers and use a map ID associated with a\nraster map instead of a vector map. We anticipate slower rendering performance\nfor some mobile devices. If you choose to use vector maps on mobile web, we\nwould greatly appreciate performance statistics and feedback. As above, if\nVector Maps support is not available, a vector map ID will automatically\nfallback to using a raster map.\n\nBugs\n----\n\n### Known bugs\n\n- There is a known issue in Chrome on some macOS devices with AMD GPUs. This can be particularly confusing when macOS dynamically switches between GPUs on devices with multiple GPUs, so vector maps may not be available depending on what other apps are running, or whether an external monitor is connected. Turning on Chrome's upcoming ANGLE Metal backend appears to fix this issue in some cases. You can follow general rollout plans for this at \u003chttps://bugs.chromium.org/p/chromium/issues/detail?id=1322521\u003e.\n\n### Reporting bugs\n\n- Please update the browser and GPU driver to the latest version before reporting the bug.\n- Ensure that the hardware acceleration setting at `chrome://settings/system` (Chrome), `about:preferences#general` (Firefox), `edge://settings/system` (Microsoft Edge) is enabled. In Safari, this setting is enabled automatically in macOS version 10.15 or newer. For older MacOS version(s), please go to the Safari advanced settings and ensure that the \"Use hardware acceleration\" option is enabled.\n- Include [jsfiddle](https://jsfiddle.net/L320szg9/) sample code link in the bug report.\n- Please also take a screenshot of `chrome://gpu` (Chrome), `about:support` (Firefox) or `edge://gpu` (Microsoft Edge), attach GPU related info in bug report if you encounter any rendering issues.\n\nTell us what you think!\n-----------------------\n\nWe value your feedback as we strive to make the best vector map experience for\nyou and your end-users. Please let us know if:\n\n- There are any new JavaScript errors or bugs/crashes that you detect in your web apps.\n- Startup latency for vector maps is significantly worse than that for raster maps. If this is the case, metrics for startup latency regression are very helpful. In general, we want to know if startup latency regresses beyond acceptable thresholds.\n- The vector maps experience is not as smooth as it could be. If you log FPS or jank metrics, how do they compare between vector and raster maps?\n- Performance differs greatly by browser.\n\nIf you have set up A/B testing for a comparison of vector maps vs. raster maps,\nplease share any performance feedback you acquire, as this will be very useful\nto help us refine the feature."]]
