Erstellen einer benutzerdefinierten Kartenverbindung

Anforderungen für eine TMS-Verbindung

Um sich mithilfe einer .tms-Datei mit Ihrem Kartenserver zu verbinden, muss Ihr Kartenserver über die folgenden Funktionen verfügen:

• Karten werden als eine Auflistung von Kacheln zurückgegeben
• Kacheln sind in der Web-Mercator-Projektion
• Kacheln können durch eine URL adressiert werden, wobei dasselbe Nummerierungsschema wie bei allgemeinen Webzuordnungsdiensten verwendet wird. Weitere Informationen finden Sie im Abschnitt zu den <url-format> unter Variablen in der TMS-Datei.

Erstellen einer einfachen TMS-Datei

Eine .tms-Datei ist eine einfache Textdatei, die Sie in einem Text-Editor erstellen können.

1. Öffnen Sie einen Text-Editor.

2. Kopieren Sie das folgende XML-Element, und fügen Sie es in den Text-Editor ein.

   <?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. Ersetzen Sie die Variablen <boolean>, <server-url> und <url-format> gemäß der Beschreibung im Abschnitt Erforderliche Variablen in der TMS-Datei in diesem Artikel.

4. Speichern Sie die TMS-Datei mit einer .tms-Erweiterung im Ordner Mapsources von Tableau Desktop oder Tableau Server.

   Der Standardspeicherort für den Mapsources-Ordner lautet:

   • Für Tableau Desktop auf Mac – /Benutzer/<Benutzer>/Dokumente/Eigenes Tableau-Repository/Mapsources

   • Für Tableau Desktop auf Windows – C:\Benutzer\<Benutzer>\Dokumente\Eigenes Tableau-Repository\Mapsources

   • Für Tableau Server – C:\Programme\Tableau\Tableau Server\<Version>\vizqlserver\mapsources

5. Öffnen Sie Tableau Desktop.

6. Stellen Sie eine Verbindung zu einer Arbeitsmappe her, die Standortinformationen enthält.

7. Wählen Sie Karte > Hintergrundkarten und dann über den von Ihnen in der TMS-Datei konfigurierten Kartenserver die Hintergrundkarte aus.

8. (Optional) Wenn Sie dem Ordner "Mapsources" in Tableau Server die TMS-Datei hinzugefügt haben, veröffentlichen Sie die Arbeitsmappe auf Tableau Server, und zeigen Sie die von Ihnen in der TMS-Datei konfigurierte Hintergrundkarte an.

Erforderliche Variablen in der TMS-Datei

Nur die folgenden Variablen können in der XML geändert werden:

• <boolean>: Ersetzen Sie den Wert <boolean> durch true oder false.
  • Der Wert true ermöglicht es Tableau Desktop, die in der TMS-Datei mit der Arbeitsmappe angegebene Konfiguration zu speichern. Verwenden Sie diesen Wert, wenn Ihre Arbeitsmappe auf Tableau Cloud oder Tableau Public veröffentlicht wird.
  • Der Wert false erfordert Tableau Desktop oder Tableau Server für den Zugriff auf die TMS-Datei, die im Ordner "Mapsources" gespeichert ist, damit die Karten von Ihrem Kartenserver angezeigt werden können.
• <server-url>: Ersetzen Sie <server-url> durch die URL Ihres Kartenservers.
• <url-format>: Ersetzen Sie <url-format> durch zusätzliche URL-Fragmente, die für Ihren Kartenserver erforderlich sind. Dazu zählen möglicherweise die folgenden Tags:
  • {Z}: Das {Z}-Tag zeigt die Zoom-Stufe an. Bei der Zoom-Stufe 0 wird die gesamte Welt in einer Kartenkachel angezeigt.Der TMS ruft Kartenkacheln bis zur Stufe 16 ab.
  • {X} und {Y}: Die {X}- und {Y}-Tags zeigen die Kartenkachelkoordinaten an. Weitere Informationen über Kartenkacheln finden Sie auf den folgenden Webseiten:
    • OpenStreetMaps-Wiki-Seite
    • Bing Maps-Webseite

Beispiel-XML

Angenommen, Sie möchten einen einfachen durch OpenStreetMaps bereitgestellten Kartenserver verbinden.Die TMS-Datei sieht möglicherweise wie folgt aus:

<?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>

Erweiterte TMS-Einstellungen

Sie können das erweiterte TMS-Dateiformat für die spezielle Verarbeitung von API-Schlüsseln sowie für die Steuerung der Vergrößerung, Verkleinerung und des Verwaschens von Kartenkacheln verwenden.

Hinweis: Im Ordner "Mapsources" befinden sich die bereits in Tableau Desktop und Tableau Server enthaltenen TMS-Dateien.In diesen Dateien konfigurierte Einstellungen werden für Verbindungen zu anderen Kartenservern nicht unterstützt.

API-Schlüssel

Wenn Ihr Kartenserver den API-Schlüssel in der Server-URL erwartet, können Sie das {K}-Tag im Abschnitt <url-format> des Verbindungselements verwenden.

Sie können den API-Schlüssel auch aus Ihrer <url-format>-Zeichenfolge separieren, indem Sie das {K}-Tag in Ihrer Zeichenfolge verwenden und den API-Schlüssel im Attribut für den Benutzernamen platzieren.

Im folgenden Beispiel wird die Verwendung des {K}-Tags mit dem API-Schlüssel im Attribut für den Benutzernamen veranschaulicht.

<?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>

Maximale Vergrößerung und minimale Verkleinerung

Standardmäßig übernimmt Tableau die Kartenkacheln, dies es vom Kartenserver empfängt, und passt die Kartenkacheln in puncto Größe entsprechend an, damit sie mit Ihren Daten übereinstimmen.Wenn Sie mehr Kontrolle darüber benötigen, wie Ihre Kartenkacheln angezeigt werden, können Sie die Attribute für die maximale Vergrößerung max-stretch und für die minimale Verkleinerung min-shrink im Verbindungselement festlegen.

Wenn Sie die maximale Vergrößerung und die minimale Verkleinerung auf 1 festlegen, werden die Kartenkacheln durch Tableau weder vergrößert noch verkleinert.Stattdessen dockt Tableau den Karten-Zoom für die Kacheln an.Sie können die Attribute für die maximale Vergrößerung und für die minimale Verkleinerung auch auf Werte festlegen, die in etwa 1 entsprechen, um Vergrößerungen oder Verkleinerungen und in Abhängigkeit vom Zoom auch Andockungen zuzulassen.

Im folgenden Beispiel wird die Verwendung der Attribute max-stretch und min-shrink veranschaulicht.

<?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>

Verwaschen

Tableau verwäscht standardmäßig die Kartenkacheln, dies es vom Kartenserver empfängt, ein wenig, um die Daten hervorzuheben.Um die Verwaschstufe der Kartenkacheln zu steuern, fügen Sie den folgenden XML-Abschnitt direkt vor dem schließenden Tag des Stammelements </mapsource> hinzu. Sie können den Verwaschwert zu einer beliebigen Zahl im Bereich von 0,0 bis 1,0 ändern.

Im Folgenden finden Sie ein XML-Beispiel dazu, was vor dem schließenden Tag des Stammelements </mapsource> platziert werden kann.

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