Incorporare una mappa nel tuo sito web

Una mappa incorporata inserisce un progetto in una pagina del tuo sito web: le sue forme, le loro misure e, se è prezzato, il suo preventivo. I visitatori lo guardano direttamente lì, senza un account, e possono aprirlo in Measure Map Online se vogliono più spazio.

Quali progetti possono essere incorporati#

I tuoi incorporamenti possono mostrare i tuoi progetti e quelli di altri account, ad esempio dei tuoi clienti, come consente il loro livello di accesso:

• I progetti visibilitySolo visualizzazione e publicPubblico compaiono nella tua pagina, a chiunque appartengano. I visitatori possono guardare ma non modificare nulla: la modifica è disattivata all'interno di una mappa incorporata, anche per i membri di un progetto.
• I progetti lockPrivato di un altro account compaiono solo dopo che il loro proprietario ti ha autorizzato. Compaiono quindi in sola visualizzazione, nei tuoi incorporamenti e da nessun'altra parte. Vedi progetti privati dei clienti.
• I tuoi progetti lockPrivato non compaiono mai, nemmeno con la tua chiave. Impostali prima su visibilitySolo visualizzazione.
• I progetti person_pin_circleOpen Guest permettono ai visitatori di misurare da soli e di richiedere un preventivo. Vedi Open Guest.

Un progetto compare solo finché è attivo il piano del suo proprietario o, per i progetti di un'organizzazione, il piano dell'organizzazione. I progetti nel cestino e i modelli non vengono mostrati. Quando un progetto non può essere mostrato, la mappa ne spiega il motivo: vedi quando la mappa mostra un messaggio.

Ottenere il codice di incorporamento#

1. Nella dashboard, premi codeSviluppatori, poi web_assetIncorpora una mappa. L'incorporamento usa sempre la tua chiave live: i progetti creati con una chiave sandbox non possono essere aperti dai visitatori del tuo sito web (vedi live e sandbox).
2. In Ottieni la tua chiave API, se la pagina non mostra ancora una chiave, premi addGenera nuova chiave e creane una nella finestra che si apre. Vedi creare una chiave.
3. In Imposta l'ID del progetto, scrivi parte del nome del progetto in Scegli un progetto e sceglilo dall'elenco. L'elenco indica come è condiviso ogni progetto e omette i modelli e i progetti nel cestino. Se scegli un progetto Privato, la pagina avvisa che i tuoi visitatori vedranno un messaggio che indica che è privato e propone visibilityImposta su solo visualizzazione.
4. In Codice da incorporare, scegli l'aspetto della mappa:
   • Tema: Auto segue l'impostazione chiara o scura di ogni visitatore; oppure sempre Chiaro o Scuro.
   • Unità: Auto (Paese del visitatore) mostra le unità imperiali ai visitatori negli Stati Uniti e quelle metriche a tutti gli altri; oppure sempre Imperiale o Metrico.
   • Tipo di mappa: Satellite, Mappa, Ibrida o Rilievo.
   • Larghezza e Altezza della mappa nella tua pagina, in pixel (da 200 a 2000).
5. Controlla l'Anteprima dal vivo.
6. Premi content_copy accanto a Codice di incorporamento e incolla il codice nell'HTML della tua pagina, dove deve comparire la mappa.

Per incorporare il progetto di qualcun altro, ad esempio di un cliente, ti serve il suo ID progetto. Il proprietario lo trova in fondo alla panoramica del progetto, con un pulsante content_copy Copia; in una mappa incorporata, fare clic sul nome del progetto lo copia. Inseriscilo nel pid dell'indirizzo di incorporamento.

Il codice contiene la tua chiave API, quindi la mappa continua a funzionare finché non sostituisci la chiave, sui siti web che la chiave consente. Dopo che l'hai sostituita, la vecchia chiave viene ancora accettata per 24 ore, quindi incolla il nuovo codice nelle tue pagine entro quel tempo. Una chiave creata prima che le chiavi avessero impostazioni di accesso mantiene invece la data che ti è stata data. Solo l'Anteprima dal vivo in questa pagina usa un token di breve durata.

Per tenere del tutto la chiave fuori dalle tue pagine, fai in modo che il server del tuo sito web richieda un token ogni volta che la pagina viene mostrata. Vedi chiave o token, che elenca anche tutte le impostazioni accettate dall'indirizzo di incorporamento.

Limitare la mappa ai tuoi siti web#

Per impostazione predefinita un incorporamento funziona su qualsiasi sito web. Per impedire ad altri siti di mostrare le tue mappe, premi codeSviluppatori > vpn_keyChiavi API e aggiungi i tuoi siti web, come example.com, in Restrizioni sui siti web. Un sito web nell'elenco copre anche i suoi sottodomini. Quando l'elenco contiene almeno un sito web, una mappa incorporata altrove non si apre. Vedi limitare la chiave ai tuoi siti web.

Cosa possono fare i visitatori#

In una mappa incorporata, i visitatori possono:

• spostarsi e fare zoom, e fare clic su una forma per leggerne le misure;
• vedere il preventivo del progetto, quando ne ha uno;
• leggere i commenti del progetto e aggiungere i propri quando il progetto permette a tutti di commentare;
• premere settings per cambiare il tipo di mappa e le unità di misura (vedi impostazioni);
• fare clic sul nome del progetto per copiare il suo ID progetto;
• premere il pulsante Measure Map Online nell'angolo in basso a destra per aprire il progetto in una nuova scheda.

In un progetto Open Guest possono anche disegnare e misurare, e premere Richiedi un preventivo per inviarti i propri dati.

La modifica è disattivata in ogni altra mappa incorporata, anche per i membri del progetto. Per creare l'incorporamento con il tuo codice, o per inserirvi un token di breve durata invece della tua chiave, vedi l'API iFrame.

Quando la mappa mostra un messaggio#

Quando un progetto non può essere mostrato, la mappa ne spiega il motivo al suo posto e cosa si può fare.

Per il lato tecnico di ogni caso, vedi quando la mappa non compare.