Risposta

Requisiti per una connessione TMS

Per effettuare la connessione al server delle mappe usando un file .tms, il tuo server delle mappe deve avere le caratteristiche seguenti:

• Le mappe vengono restituite come una raccolta di riquadri
• I riquadri sono in proiezione Web Mercator
• I riquadri possono essere indirizzati tramite l'URL usando lo stesso schema di numerazione come servizio di mapping Web comune. Per maggiori informazioni, vedi la sezione <url-format> sotto Variabili nel file TMS.

Crea un file TMS semplice

Un file .tms è un file di testo semplice che puoi creare in un editor di testo.

1. Apri un editor di testo.

2. Copia e incolla il seguente linguaggio XML nell'editor di testo.

   <?xml version="1.0" encoding="utf-8"?>
<mapsource inline="<boolean>" version="8.1">
<connection class="OpenStreetMap" port="80" server="<server-url>" url-format="<url-format>" />
<layers>
<layer display-name='Base' name='base' show-ui='false' type='features' request-string='/' />
</layers>
</mapsource>

3. Sostituisci le variabili <boolean>, <server-url> e <url-format> come descritto nella sezione Variabili richieste nel file TMS di questo articolo.

4. Salva il file TMS con estensione .tms nella cartella Mapsources di Tableau Desktop o Tableau Server.

   Posizione predefinita della cartella Mapsources:

   • Per Tableau Desktop su Mac - /Users/<utente>/Documents/My Tableau Repository/Mapsources

   • Per Tableau Desktop su Windows - C:\Users\<utente>\Documents\My Tableau Repository\Mapsources

   • Per Tableau Server - C:\Program Files\Tableau\Tableau Server\<versione>\vizqlserver\mapsources

5. Apri Tableau Desktop.

6. Effettua la connessione a una cartella di lavoro che contiene informazioni sulla posizione.

7. Seleziona Mappa > Mappe di sfondo e seleziona la mappa in background dal server delle mappe che hai configurato nel file TMS.

8. (Facoltativo) Se hai aggiunto il file TMS alla cartella Mapsources in Tableau Server, pubblica la cartella di lavoro su Tableau Server e vedi la mappa di background che hai configurato nel file TMS.

Variabili richieste nel file TMS

Nel linguaggio XML è possibile cambiare solo le variabili seguenti:

• <boolean>: sostituisci la variabile <boolean> con un valore true o false.
  • Un valore true consente a Tableau Desktop di salvare la configurazione specificata nel file TMS con la cartella di lavoro. Usa questo valore se la tua cartella di lavoro è pubblicata su Tableau Cloud o Tableau Public.
  • Un valore false richiede l'accesso da parte di Tableau Desktop o Tableau Server al file TMS salvato nella cartella Mapsources per visualizzare le mappe dal tuo server delle mappe.
• <server-url>: sostituisci <server-url> con l'URL del tuo server delle mappe.
• <url-format>: sostituisci <url-format> con frammenti di URL aggiuntivi richiesti dal tuo server delle mappe. Questo potrebbe includere i tag seguenti:
  • {Z}: Il tag {Z} indica il livello dello zoom. Un livello di zoom pari a zero visualizza il mondo intero nel riquadro mappa. Il TMS recupera i riquadri della mappa fino al livello 16.
  • {X} and {Y}: I tag {X} e {Y} indicano le coordinate dei riquadri della mappa. Per maggiori informazioni sui riquadri della mappa, fai riferimento alle pagine Web seguenti:
    • Pagina wiki OpenStreetMaps
    • Pagina Web di Bing Maps

Esempio XML

Immagina di voler effettuare la connessione a un server delle mappe semplice fornito da OpenStreetMaps. Il file TMS dovrebbe essere simile a questo:

<?xml version="1.0" encoding="utf-8"?>
<mapsource inline="true" version="8.1">
<connection class="OpenStreetMap" port="80" server="http://a.tile.openstreetmap.org" url-format="/{Z}/{X}/{Y}.png" />
<layers>
<layer display-name='Base' name='base' show-ui='false' type='features' request-string='/' />
</layers>
</mapsource>

Impostazioni TMS avanzate

Puoi usare il formato di file TMS avanzato per la gestione speciale di chiavi API e per il controllo di estensione, riduzione e dissolvenza dei riquadri della mappa.

Nota: Nella cartella Mapsources trovi i file TMS forniti con Tableau Desktop e Tableau Server. Le impostazioni configurate in quei file non sono supportate per le connessioni ad altri server delle mappe.

Chiave API

Se il server delle mappe prevede una chiave API nell'URL del server, puoi usare il tag {K} nella sezione <url-format> dell'elemento di connessione.

Puoi anche separare la chiave API dalla stringa <url-format> usando il tag {K} nella stringa e posizionando la chiave API nell'attributo nome utente.

L'esempio seguente dimostra come usare il tag {K} con la chiave API nell'attributo nome utente.

<?xml version="1.0" encoding="utf-8"?> 
<mapsource inline="true" version="8.1"> 
<connection class="OpenStreetMap" port="80" server="http://a.tile.mapbox.com" url-format="/v4/base.mapbox-streets+bg-e8e0d8_landuse_water_buildings_streets/{Z}/{X}/{Y}.png?access_token={K}" username="<your-api-key>"/> 
<layers> 
<layer display-name='Base' name='base' show-ui='false' type='features' request-string='/' /> 
</layers> 
</mapsource>

Estensione massima e riduzione minima

Per impostazione predefinita, Tableau prende i riquadri della mappa che riceve dal server delle mappe e li espande in modo che corrispondano ai tuoi dati. Se hai bisogno di un controllo maggiore sulla visualizzazione dei riquadri della mappa, puoi impostare gli attributi di estensione massima,  max-stretch, e di riduzione minima, min-shrink, nell'elemento di connessione.

Se imposti l'estensione massima e la riduzione minima a 1, Tableau non estende o riduce i riquadri della mappa. Invece, Tableau allinea lo zoom della mappa ai riquadri. Puoi anche impostare gli attributi di estensione massima e di riduzione minima su valori prossimi a 1 per consentire un po' di estensione o di riduzione, o anche di allineamento, sulla base dello zoom.

L'esempio seguente dimostra come usare gli attributi max-stretch and min-shrink.

<?xml version="1.0" encoding="utf-8"?> 
<mapsource inline="true" version="8.1"> 
<connection class="OpenStreetMap" port="80" server="http://a.tile.openstreetmap.org" url-format="/{Z}/{X}/{Y}.png" max-stretch="1.2" min-shrink="0.667"/> 
<layers> 
<layer display-name='Base' name='base' show-ui='false' type='features' request-string='/' /> 
</layers> 
</mapsource>

Dissolvenza

Per impostazione predefinita, Tableau schiarisce leggermente i riquadri della mappa che riceve dal server delle mappe per fare in modo che i dati siano ben visibili. Per controllare il livello di dissolvenza dei riquadri della mappa, aggiungi la sezione di linguaggio XML seguente prima del tag di chiusura dell'elemento radice </mapsource>. Puoi cambiare il valore della dissolvenza in qualsiasi numero da 0,0 to 1,0.

Il linguaggio XML seguente è un esempio di cosa è possibile posizionare prima del tag di chiusura dell'elemento radice </mapsource>.

<mapsource-defaults version="8.1"> 
<style> 
<style-rule element="map"> 
<format attr="washout" value="0.0"/> 
</style-rule> 
</style> 
</mapsource-defaults>