Come aggiungere Яндекс Карты al sito Turbosite

Яндекс Карты è il principale servizio di cartografia per il pubblico russo. Esistono due modi semplici per aggiungere una mappa al sito: tramite il Costruttore di mappe (disegnando un percorso o inserendo i segnaposto personalmente) o direttamente da Яндекс Карты (scheda dell’organizzazione con recensioni e contatti). Entrambe le opzioni forniscono un codice HTML pronto per l’inserimento. È gratuito e non è necessaria alcuna chiave API. L’installazione richiede 5–10 minuti.

Cosa ti servirà

Un account Yandex — registrazione gratuita
Un sito pubblicato su Turbosite
5–10 minuti

Metodo 1: scheda dell’organizzazione da Яндекс Карты (se hai già un’azienda su Mappe)

Questo è il metodo più veloce: fornisce una mappa con un segnaposto, recensioni e il pulsante “Costruisci percorso”.

Apri yandex.ru/maps e cerca la tua azienda nella barra di ricerca.
Nella pagina dell’azienda, clicca sul pulsante «Condividi» (icona con la freccia) → seleziona la scheda «Widget».
Configura l’anteprima (dimensioni, segnaposto, informazioni sull’azienda).
Copia il codice da inserire nel sito.

📷 Screenshot: scheda dell’organizzazione su Яндекс Карты con la finestra “Condividi → Widget” aperta.

Metodo 2: la tua mappa tramite il Costruttore di mappe (se ti servono più segnaposto o un percorso)

Apri yandex.ru/map-constructor.
Trova il punto desiderato sulla mappa.
Aggiungi segnaposto, linee o aree secondo necessità.
Clicca su «Salva e continua» → imposta le dimensioni della mappa.
Clicca su «Ottieni il codice della mappa» → seleziona il formato «iframe».
Copia il codice.

📷 Screenshot: Costruttore di mappe di Yandex con segnaposto configurati e codice iframe generato.

Passaggio 3. Inserire il codice in Turbosite

La mappa appare in un punto specifico della pagina (ad esempio, nel blocco “Contatti”), pertanto il codice viene inserito nel corpo della pagina, non nel tag <head>.

Apri il tuo sito in Turbosite.
Aggiungi il blocco “Codice HTML” nel punto desiderato della pagina, solitamente nella sezione contatti.
Incolla il codice della mappa copiato.
Salva le modifiche.
Pubblica il sito.

📷 [screenshot Turbosite — verrà aggiunto: blocco Codice HTML nel corpo della pagina con la mappa].

Passaggio 4. Verificare che la mappa funzioni

Apri il sito pubblicato.
Scorri fino al blocco con la mappa: dovrebbe caricarsi in 1–2 secondi.
Controlla su un dispositivo mobile: la mappa dovrebbe ridimensionarsi correttamente.

Se la mappa viene tagliata sui dispositivi mobili, configura nuovamente le dimensioni nel Costruttore selezionando l’opzione “Adatta alla larghezza”.

Domande frequenti

È possibile aggiungere più segnaposto o un percorso? Sì, tramite il Costruttore di mappe (Metodo 2). In esso è possibile disegnare un percorso, aggiungere un poligono e inserire molti segnaposto di colori diversi.

La mappa rallenta il caricamento del sito. La mappa iframe viene caricata in modo asincrono e non blocca la pagina. Se c’è solo una mappa sulla pagina, non ci saranno problemi. Se ci sono molte mappe o il sito è sovraccarico, è possibile utilizzare il lazy-load (caricamento al clic).

È possibile inserire una mappa con i miei dati (stile aziendale, colori)? Nell’iframe di base no, il design è standard. La personalizzazione completa avviene tramite la JavaScript API di Яндекс Карты, ma richiede uno sviluppatore e una chiave API.

È necessaria una chiave API per la mappa di base? No. Le mappe dal Costruttore o dalla scheda dell’azienda vengono inserite senza chiave. La chiave è necessaria solo per la JavaScript API.

Come aggiungere le recensioni di Яндекс Карты? Si tratta di un widget separato: nella scheda dell’azienda su Яндекс Карты → «Condividi» → «Widget con recensioni». Si inserisce allo stesso modo, tramite il blocco HTML.

Dove guardare dopo

Costruttore di mappe di Yandex — strumento principale
Guida del Costruttore di mappe — documentazione ufficiale
API di Яндекс Карты — per una configurazione avanzata