Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa pagina elenca i problemi noti e le soluzioni alternative per le mappe vettoriali e le funzionalità WebGL.
Supporto per browser/dispositivi
L'anteprima della funzionalità WebGL supporta gli stessi browser e dispositivi dell'API Maps JavaScript.
Per verificare se il browser di un determinato dispositivo supporta WebGL, visita get.webgl.org
o caniuse.com. Assicurati inoltre che
l'accelerazione hardware sia attivata nelle impostazioni del browser, altrimenti le mappe vettoriali
torneranno al formato raster.
Raster o vettoriale?
A volte, una mappa vettoriale potrebbe tornare al formato raster. In questi casi, le funzionalità
che dipendono dalla mappa vettoriale non sono disponibili. Il fallback a una mappa raster può verificarsi
per diversi motivi. Questa sezione mostra come configurare correttamente
il browser web e come verificare a livello di programmazione se è presente la funzionalità
delle mappe vettoriali.
Controllare le funzionalità del browser su Chrome
Per determinare quali funzionalità di accelerazione hardware sono attive in una specifica
installazione di Chrome, vai a chrome://gpu/ e assicurati
che i seguenti elementi siano attivi (in verde):
"OpenGL: Enabled" (OpenGL: abilitato)
"WebGL: accelerazione hardware"
"WebGL2: accelerazione hardware"
Questi sono solo i requisiti di base, possono esserci altri fattori che
influiscono sull'assistenza. Vedi "Bug noti" di seguito.
Attivare l'accelerazione hardware
Per supportare le mappe vettoriali, l'accelerazione hardware deve essere attivata nella maggior parte dei browser. Per attivare l'accelerazione hardware in Chrome e Microsoft Edge, apri
Impostazioni, seleziona Sistema e assicurati che l'opzione Usa accelerazione hardware
quando disponibile sia attivata.
Controllare in modo programmatico se è presente un raster o un vettore
Puoi controllare in modo programmatico se una mappa è raster o vettoriale chiamando map.getRenderingType(). L'esempio seguente mostra il codice per monitorare
l'evento renderingtype_changed e mostrare una finestra informativa che indica se è in uso una
mappa raster o vettoriale.
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;
Il supporto del web mobile per le mappe vettoriali è ancora sperimentale. Gli sviluppatori possono utilizzare
le API client per rilevare i browser web mobile e utilizzare un ID mappa associato a una
mappa raster anziché a una mappa vettoriale. Prevediamo un rendimento di rendering più lento
per alcuni dispositivi mobili. Se scegli di utilizzare le mappe vettoriali sul web mobile, ti saremmo grati se ci fornissi statistiche sul rendimento e feedback. Come sopra, se
il supporto delle mappe vettoriali non è disponibile, un ID mappa vettoriale
tornerà automaticamente all'utilizzo di una mappa raster.
Bug
Bug noti
Esiste un problema noto in Chrome su alcuni dispositivi macOS con GPU AMD. Ciò può
essere particolarmente confusionario quando macOS passa dinamicamente da una GPU all'altra sui
dispositivi con più GPU, quindi le mappe vettoriali potrebbero non essere disponibili a seconda
delle altre app in esecuzione o se è collegato un monitor esterno.
L'attivazione del backend ANGLE Metal di Chrome in arrivo sembra risolvere il problema in
alcuni casi. Puoi seguire i piani di implementazione generali per questo all'indirizzo
https://bugs.chromium.org/p/chromium/issues/detail?id=1322521.
Segnalazione di bug
Aggiorna il browser e il driver GPU all'ultima versione prima di segnalare il bug.
Assicurati che l'impostazione di accelerazione hardware sia attivata in chrome://settings/system (Chrome), about:preferences#general (Firefox) e edge://settings/system (Microsoft Edge). In Safari, questa impostazione viene attivata automaticamente in macOS versione 10.15 o successive. Per le versioni precedenti di macOS, vai alle impostazioni avanzate di Safari e assicurati che l'opzione "Usa accelerazione hardware" sia attivata.
Includi il link al codice di esempio jsfiddle nella segnalazione di bug.
Se riscontri problemi di rendering, acquisisci anche uno screenshot di chrome://gpu (Chrome), about:support (Firefox) o edge://gpu (Microsoft Edge) e allega le informazioni relative alla GPU nella segnalazione di bug.
Aspettiamo commenti e suggerimenti!
Il tuo feedback è importante per noi e ci aiuta a migliorare l'esperienza con le mappe vettoriali per te e i tuoi utenti finali. Facci sapere se:
Sono presenti nuovi errori JavaScript o bug/arresti anomali rilevati nelle tue
app web.
La latenza di avvio per le mappe vettoriali è significativamente peggiore rispetto a quella per le mappe raster. In questo caso, le metriche per la regressione della latenza di avvio sono molto utili. In generale, vogliamo sapere se la latenza di avvio regredisce oltre
le soglie accettabili.
L'esperienza con le mappe vettoriali non è fluida come potrebbe essere. Se registri le metriche FPS o
jank, come vengono confrontate tra mappe vettoriali e raster?
Il rendimento varia notevolmente a seconda del browser.
Se hai configurato il test A/B per confrontare le mappe vettoriali con le mappe raster,
condividi qualsiasi feedback sul rendimento che acquisisci, in quanto sarà molto utile
per aiutarci a perfezionare la funzionalità.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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."]]
