API iFrame · Guida di Measure Map Online

Mostra uno dei tuoi progetti come mappa interattiva sul tuo sito web, con le unità, lo stile di mappa e il tema più adatti al tuo sito.

L'API iFrame porta la mappa di un progetto sulla tua pagina web. I visitatori vedono la mappa satellitare con le tue misurazioni e possono spostarsi al suo interno, senza un account e senza lasciare il tuo sito. Scegli tu il progetto, le unità, lo stile della mappa e il tema dei colori.

Prima di iniziare#

Una chiave API live con accesso Mappe incorporate. Vedi chiavi API.
Un progetto che i visitatori possano vedere: tuo o di un altro account, condiviso come Solo visualizzazione o Pubblico. Un progetto Privato si mostra solo se è di un altro account e il suo proprietario ti ha autorizzato (vedi i progetti privati dei clienti); i tuoi progetti privati non si mostrano mai. Vedi quali progetti si possono incorporare.
Facoltativamente, restrizioni per i siti web sulla chiave, così l'incorporamento funziona solo sui tuoi siti. Vedi chiavi API.

Creare il codice di incorporamento#

Sviluppatori > Incorpora una mappa crea il codice per te con la tua chiave live: scegli il progetto, il tema, le unità, il tipo di mappa e le dimensioni, controlla l'Anteprima dal vivo e copia il Codice di incorporamento. Se il progetto è privato, la sezione lo segnala e propone Imposta su solo visualizzazione. Vedi ottenere il codice di incorporamento per ogni passaggio.

Incorporare una mappa con un progetto scelto e l'anteprima in tempo reale

Il codice contiene la tua chiave, quindi continua a funzionare finché non la sostituisci. La sezione ti avvisa quando la chiave può fare più di Mappe incorporate, dato che chiunque può leggerla nel sorgente della tua pagina, e quando la chiave non ha restrizioni per i siti web. Solo l'Anteprima dal vivo usa un token di breve durata. Vedi chiave o token.

L'indirizzo di incorporamento#

Un incorporamento è un <iframe> il cui indirizzo inizia con https://app.measuremaponline.com/iframe_api, seguito da questi parametri:

Parametro	Necessario	Valori
`pid`	obbligatorio	L'ID del progetto: la parte dopo `/p/` nell'indirizzo del progetto nell'app. Il proprietario può copiarlo in fondo alla panoramica del progetto, e anche cliccando il nome del progetto in una mappa incorporata.
`key`	`key` o `token`	La tua chiave API.
`token`	`key` o `token`	Un token dal tuo server (vedi sotto).
`ms`	facoltativo	Unità: `metric` o `imperial`. Senza di esso, i visitatori negli Stati Uniti vedono le unità imperiali e tutti gli altri quelle metriche.
`maptype`	facoltativo	`satellite` (predefinito), `map`, `hybrid` o `terrain`.
`theme`	facoltativo	`auto` (predefinito: segue l'impostazione di sistema del visitatore), `light` o `dark`.

Un esempio minimo#

<iframe src="https://app.measuremaponline.com/iframe_api?pid=YOUR_PROJECT_ID&key=YOUR_API_KEY&maptype=satellite&theme=auto"
  title="YOUR_PROJECT_NAME" width="500" height="500" style="border:0" allow="fullscreen"></iframe>

Sostituisci YOUR_PROJECT_ID, YOUR_API_KEY e YOUR_PROJECT_NAME (gli screen reader leggono ad alta voce il title) e imposta larghezza e altezza in base alla tua pagina.

Il codice di incorporamento con il suo pulsante di copia

Chiave o token#

Con key, come nel codice che ti dà la sezione Incorpora una mappa, l'incorporamento continua a funzionare finché funziona la chiave, sui siti web che le sue restrizioni consentono. La tua chiave è quindi visibile nel sorgente della tua pagina, perciò:

usa una chiave con il solo accesso Mappe incorporate;
limitala ai tuoi siti web;
quando sostituisci la chiave, aggiorna le tue pagine entro le 24 ore in cui la vecchia chiave continua a funzionare (una chiave creata prima delle impostazioni di accesso mantiene la data che ti è stata indicata).

Con token, la chiave resta sul tuo server. È adatto agli incorporamenti che il tuo server scrive nella pagina a ogni visita: prima di mostrare la pagina, chiede un token all'API REST e lo inserisce nell'indirizzo dell'iframe:

POST https://api.measuremaponline.com/api/v2/auth/iframe/token, con la tua chiave nell'intestazione Authorization, restituisce un token valido 60 minuti;
POST https://api.measuremaponline.com/api/v2/auth/token fa lo stesso e accetta una duration in secondi, fino a 24 ore. La sua risposta indica quando scade il token.

Il tuo account può ottenere fino a 600 token all'ora. Usa una chiave live: gli incorporamenti mostrano solo progetti live, quindi un token creato con una chiave sandbox non apre una mappa. Vedi il riferimento API.

Cosa possono fare i visitatori#

I visitatori possono spostare e ingrandire la mappa, leggere le misurazioni delle tue forme e leggere i commenti del progetto. Possono aggiungere commenti quando il progetto permette a tutti di commentare, e cliccando il nome del progetto ne copiano l'ID. Non possono cambiare nient'altro: la modifica è disattivata all'interno di un incorporamento, qualunque sia il livello di accesso del progetto. L'unica eccezione è un progetto Open Guest con il piano Open Guest, dove i visitatori misurano per conto proprio.

Quando la mappa non compare#

Nella maggior parte dei casi la mappa mostra un messaggio che ne spiega il motivo: vedi quando la mappa mostra un messaggio. Controlla, in ordine:

L'indirizzo ha un token scaduto. I token durano 60 minuti, a meno che il tuo server ne abbia chiesti di più lunghi. Copia di nuovo il codice da Incorpora una mappa, che usa la tua chiave, oppure fai ottenere al tuo server un token nuovo a ogni visita (vedi sopra).
Il progetto è privato. Se è tuo, impostalo su Solo visualizzazione oppure Pubblico, oppure premi Imposta su solo visualizzazione in Incorpora una mappa. Se è di un cliente, può autorizzarti dalla mappa, oppure puoi chiederglielo in Progetti privati.
Il piano del progetto è terminato: quello del suo proprietario o, per il progetto di un'organizzazione, quello dell'organizzazione. Si mostra di nuovo appena il piano viene rinnovato.
Il sito web non è consentito. Se la chiave ha restrizioni per i siti web, la pagina che mostra l'incorporamento deve trovarsi su uno di essi. Alcuni browser e siti nascondono su quale pagina si trova un incorporamento; con le restrizioni attive, un incorporamento di questo tipo viene rifiutato.
La chiave è stata sostituita. Una vecchia chiave si ferma 24 ore dopo la creazione di una nuova, o subito se è stata revocata.
La chiave è una chiave sandbox. Gli incorporamenti funzionano solo con chiavi live e progetti live.
L'abbonamento non è attivo, oppure l'accesso API è stato sospeso: lo dice la sezione Chiavi API.