Kachel
Beschreibung
Gibt basierend auf den angegebenen Eingabeparametern über den Map Tiling-Dienst generierte Kartenkacheln zurück.
URL-Format von HTTP-GET-Anforderungen
Das folgende Format wird für HTTP-GET-Anforderungen verwendet:
HTTP GET /{mapname}/{level}/{x}:{y}/tile.{image type}
Parameter
Weitere Informationen zu den unten aufgeführten Parametertypen finden Sie unter URL-Anforderungsdatentypen.
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| mapname | Zeichenfolge | ja | Der Name der benannten Kachel, von der die Kachel generiert werden soll. Sie müssen den Speicherort der benannten Kachel im Repository angeben. |
| level | Ganze Zahl | ja |
Bestimmt die Zoomstufe der zurückzugebenden Kachel. Die Zoomstufe zeigt an, wie nah das Kartenbild der Erde ist. Zoomstufe 1 ist am weitesten entfernt und besteht aus einer Kachel, auf die die gesamte Karte gezeichnet wird. Zoomstufe 2 besteht aus 4 Kacheln, von denen 2 quer und 2 nach unten verlaufen. Jede Kachel macht ein Viertel der gesamten Karte aus. Zoomstufe 3 besteht aus 16 Kacheln, von denen 4 quer und 4 nach unten verlaufen, usw. Je höher die angegebene Zoomstufe ist, desto näher an der Erde erscheint das Kartenbild. Beispiel: In den Zoomstufen 1 bis 3 werden in der Regel globale oder hemisphärische Details angezeigt. In den Zoomstufen 4 bis 15 werden die Detailebene Bezirk/Bundesland/Kanton und einige größere Orte angezeigt. In darüber hinausgehenden Zoomstufen werden Ansichten auf Straßenebene angezeigt. Es hängt von der im Map Tiling-Dienst veröffentlichten benannten Karte ab, was in den Zoomstufen tatsächlich angezeigt wird. Wenn Sie beispielsweise eine Karte von New York, Toronto oder London veröffentlicht haben, würde Zoomstufe 1 einer Karte von Toronto auf Straßenebene entsprechen, während hohe Zoomstufen entsprechend detaillierter wären. Dieser Parameter muss auf einen Wert festgelegt werden, der größer oder gleich dem Wert minLevel und kleiner oder gleich dem Wert maxLevel für die benannte Karte ist. |
| x | Ganze Zahl | ja | Gibt die Spalte der Kachel an, basierend auf dem angegebenen Parameter level. |
| y | Ganze Zahl | ja | Gibt die Zeile der Kachel an, basierend auf dem angegebenen Parameter level. |
| .{image type} | Bild-MIME | ja | Gibt das Bildformat der Antwort an (gif, jpeg, jpg, mvt oder png). |
Gibt zurück:
Ein Kartenbild.
Ein JSON-Fehler wird zurückgegeben, wenn eine der folgenden Bedingungen erfüllt ist:
- Der mapname-Parameter ist nicht angegeben.
- Der angegebene Name ist keine verfügbare benannte Karte im Tiling-Dienst.
- Der Parameter level ist kleiner als der in den Metadaten für die angegebene Karte definierte Wert „minlevel“.
- Der Parameter level ist größer als der in den Metadaten für die angegebene Karte definierte Wert „maxlevel“.
- Der x-Parameter ist kleiner als 1.
- Der x-Parameter ist größer als die Ebene, die von der Karte bereitgestellt werden kann.
- Der y-Parameter ist kleiner als 1
- Der y-Parameter ist größer als die Ebene, die von der Karte bereitgestellt werden kann.
Beispiel
http://<server>:<port>/rest/Spatial/MapTilingService/Samples/NamedTiles/WorldTile/2/1:1/tile.png
Im folgenden Beispiel wird die in der Antwort zurückgegebene Bilderausgabe angezeigt:
