L'API Maps JavaScript offre due diverse implementazioni della mappa: raster e vettoriale. La mappa raster carica la mappa come una griglia di tile di immagini raster basate su pixel, che vengono generate dal lato server di Google Maps Platform e poi pubblicate nella tua app web. La mappa vettoriale è composta da tile basate su vettori, che vengono disegnate al momento del caricamento sul lato client utilizzando WebGL, una tecnologia web che consente al browser di accedere alla GPU sul dispositivo dell'utente per eseguire il rendering di grafica 2D e 3D.
Il tipo di mappa vettoriale è consigliato per un'esperienza utente ottimale, in quanto offre una migliore fedeltà visiva, una migliore memorizzazione nella cache tra le mappe e la possibilità di controllare l'inclinazione e la direzione sulla mappa. Scopri di più sulle funzionalità della mappa vettoriale.
Tipo di rendering predefinito
Il tipo di rendering predefinito della mappa varia a seconda dell'implementazione.
Le mappe che utilizzano l'elemento
<gmp-map>utilizzano per impostazione predefinita il tipo di rendering vettoriale.Le mappe che utilizzano un elemento
<div>congoogle.maps.Maputilizzano per impostazione predefinita il tipo di rendering raster.
Imposta il tipo di rendering per una mappa specificando l'opzione di mappa renderingType o impostando l'opzione su un ID mappa associato. L'opzione renderingType
esegue l'override di qualsiasi impostazione del tipo di rendering effettuata configurando un ID mappa.
Specifica l'opzione renderingType
Utilizza l'opzione renderingType per specificare il tipo di rendering raster o vettoriale per la mappa (non è richiesto l'ID mappa). Per le mappe caricate utilizzando un elemento div e JavaScript, il tipo di rendering predefinito è google.maps.RenderingType.RASTER. Per impostare l'opzione renderingType:
Carica la libreria
RenderingType. Questa operazione può essere eseguita durante il caricamento della libreria Maps:const { Map, RenderingType } = await google.maps.importLibrary("maps");Durante l'inizializzazione della mappa, utilizza l'opzione
renderingTypeper specificareRenderingType.VECTORoRenderingType.RASTER:map = new Map( document.getElementById('map'), { zoom: 4, center: position, renderingType: RenderingType.VECTOR, } );
Quando è impostato il tipo di rendering della mappa vettoriale, devi impostare le opzioni per le funzionalità necessarie.
- Per attivare l'inclinazione, imposta l'opzione della mappa
tiltInteractionEnabledsutrueo chiamamap.setTiltInteractionEnabled(true). - Per attivare la panoramica, imposta l'opzione della mappa
headingInteractionEnabledsutrueo chiamamap.setHeadingInteractionEnabled(true).
Per le mappe caricate utilizzando l'elemento <gmp-map>, il tipo di rendering predefinito è
google.maps.RenderingType.VECTOR, con il controllo di inclinazione e direzione attivato. Per impostare il tipo di rendering utilizzando l'elemento <gmp-map>, utilizza l'attributo rendering-type.
Utilizza un ID mappa per impostare il tipo di rendering
Puoi anche specificare il tipo di rendering utilizzando un ID mappa. Crea un ID mappa seguendo i passaggi descritti in Utilizzo della personalizzazione delle mappe basata su cloud - Ottieni un ID mappa. Assicurati di impostare il tipo di mappa su JavaScript e seleziona un'opzione (Vettoriale o Raster). Seleziona Inclinazione e Rotazione per attivare l'inclinazione e la rotazione sulla mappa. In questo modo, potrai regolare questi valori in modo programmatico e consentirai agli utenti di regolare l'inclinazione e la direzione direttamente sulla mappa. Se l'utilizzo dell'inclinazione o della direzione influisce negativamente sulla tua app, lascia deselezionate le opzioni Inclinazione e Rotazione in modo che gli utenti non possano regolarle.

Poi, aggiorna il codice di inizializzazione della mappa con l'ID mappa che hai creato. Puoi trovare gli ID mappa nella pagina Gestione mappa. Fornisci un ID mappa quando crei un'istanza della mappa utilizzando la proprietà mapId come mostrato qui:
map = new google.maps.Map(document.getElementById('map'), { center: {lat: -34.397, lng: 150.644}, zoom: 8, mapId: 'MAP_ID' });
Rileva il tipo di rendering in uso
Per rilevare il tipo di rendering utilizzato, chiama getRenderingType() sull'oggetto mappa, come mostrato nell'esempio seguente:
// Wait for the map to finish loading.
google.maps.event.addListenerOnce(map, "tilesloaded", () => {
// Print the rendering type to the console.
console.log(`${map.getRenderingType()}`);
});```