convertMapToVirtualPixelCoord

Beschreibung

Wandelt eine angegebene Reihe von Kartenkoordinaten in Koordinaten im virtuellen Pixel-Space des gesamten Kartenbildes um und gibt diese zurück.

Anmerkung: Verwechseln Sie nicht Koordinaten im virtuellen Pixel-Space des gesamten Kartenbildes mit normalen Bildschirmpixel-Koordinaten. Normale Bildschirmpixel-Koordinaten beginnen immer in der linken oberen Ecke des Bildschirms mit (0, 0). Dies ist unabhängig davon, welcher Abschnitt des gesamten Kartenbildes derzeit auf dem Bildschirm angezeigt wird. Dagegen ist der virtuelle Pixel-Space des Kartenbildes in allen bestimmten Zoomstufen konstant. Dies ist unabhängig davon, welcher Teil der Karte derzeit auf dem Bildschirm angezeigt wird. Wenn beispielsweise ein Kartenbild auf Zoomstufe 3 festgelegt wird, besteht das Kartenbild aus 4 quer verlaufenden Kacheln und 4 nach unten verlaufenden Kacheln. Wenn jede Kachel Dimensionen von 512 x 256 Pixeln aufweist, lauten die Dimensionen für das gesamte Kartenbild 2048 x 1024 Pixel. Dies wird als virtueller Pixel-Space des Kartenbildes bezeichnet, da nur jeweils ein Unterabschnitt des gesamtes Bildes auf dem Bildschirm angezeigt werden kann.

Parameter

Weitere Informationen zu den unten aufgeführten Parametertypen finden Sie unter URL-Anforderungsdatentypen.

Parameter	Typ	Erforderlich	Beschreibung
worldX	Float	ja	Gibt die X-Koordinate der Punktposition der Karte an. Die Kartenposition wird im Hinblick auf die Einheiten des Koordinatensystems für die Karte angegeben (z. B. Grad oder Meter). Sie können das Koordinatensystem für die Karte bestimmen, indem Sie die Methode „convertScreenToMapCoord“ aufrufen und das zurückgegebene Objekt „MapCoordinate“ überprüfen. Weitere Informationen finden Sie unter convertScreenToMapCoord und MapCoordinate.
worldY	Float	ja	Gibt die Y-Koordinate der Punktposition der Karte an. Die Kartenposition wird im Hinblick auf die Einheiten des Koordinatensystems für die Karte angegeben (z. B. Grad oder Meter). Sie können das Koordinatensystem für die Karte bestimmen, indem Sie die Methode „convertScreenToMapCoord“ aufrufen und das zurückgegebene Objekt „MapCoordinate“ überprüfen. Weitere Informationen finden Sie unter convertScreenToMapCoord und MapCoordinate.
level	Ganze Zahl	ja	Gibt die Zoomstufe der Karte an. 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. Sie können diese Werte bestimmen, indem Sie die Methode „getDescription“ aufrufen und das zurückgegebene Objekt „MapDescription“ überprüfen. Weitere Informationen finden Sie unter getDescription und MapDescription.
name	Zeichenfolge	ja	Gibt den Namen der benannten Karte an, über die die Kartenkacheln generiert werden.
output	Zeichenfolge	ja	Gibt das Antwortformat an. Dies muss json sein.

Beispiel


http://<server>:<port>/rest/Spatial/LegacyMapTilingService/convertMapToVirtualPixelCoord?
  name=/NamedTiles/WorldTile
  &level=4
  &worldX=-79.377366
  &worldY=43.64713
  &output=json

Im obigen Beispiel wird folgendes JSON-Antwortobjekt zurückgegeben:


{"EnvinsaResponse":{"type":"MapTilingResponse","virtualPixelCoord":{"virtualX":1023,"virtualY":1023}}}

Gibt zurück:

Das Objekt „VirtualPixelCoordinate“ wie im obigen Beispiel dargestellt. Siehe VirtualPixelCoordinate.