convertMapToVirtualPixelCoord

説明

指定された一連のマップ座標を、マップイメージ全体の仮想ピクセルスペース内の座標に変換して返します。

注: マップイメージ全体の仮想ピクセルスペース内の座標と、通常の画面ピクセル座標を混同しないでください。通常の画面ピクセル座標は、マップイメージ全体のどのセクションが現在画面に表示されているかにかかわらず、常に画面左上隅の (0, 0) で始まります。対照的に、マップイメージの仮想ピクセルスペースは、マップのどの部分が現在画面に表示されているかにかかわらず、特定のズームレベルでは一定です。したがって、例えばマップイメージがズームレベル 3 に設定されている場合、マップイメージは横 4 枚、縦 4 枚のタイルで構成されます。各タイルの寸法が 512 ピクセル x 256 ピクセルの場合、マップイメージ全体の寸法は 2048 ピクセル x 1024 ピクセルになります。これがマップイメージの仮想ピクセルスペースと呼ばれます。画面に一度に表示できるのはイメージ全体のサブセクションのみだからです。

パラメータ

以下のパラメータのタイプについては、リクエスト URL のデータタイプを参照してください。

パラメータ	タイプ	必須	説明
worldX	Float	はい	マップのポイントの位置の x 座標を指定します。マップの位置は、マップ座標系の単位 (度やメートルなど) で指定します。convertScreenToMapCoord メソッドを呼び出し、返される MapCoordinate オブジェクトを調べることによって、マップの座標系を判断できます。詳細については、convertScreenToMapCoordおよびMapCoordinateを参照してください。
worldY	Float	はい	マップのポイントの位置の y 座標を指定します。マップの位置は、マップ座標系の単位 (度やメートルなど) で指定します。convertScreenToMapCoord メソッドを呼び出し、返される MapCoordinate オブジェクトを調べることによって、マップの座標系を判断できます。詳細については、convertScreenToMapCoordおよびMapCoordinateを参照してください。
level	Integer	はい	マップのズームレベルを指定します。このパラメータは、名前付きマップの minLevel 値以上、maxLevel 値以下の値に設定する必要があります。getDescription メソッドを呼び出し、返される MapDescription オブジェクトを調べることによって、これらの値を決定できます。詳細については、getDescriptionおよびMapDescriptionを参照してください。
name	String	はい	生成されるマップタイルの元となる名前付きマップの名前を指定します。
output	String	はい	レスポンス形式を指定します。json を指定する必要があります。

例


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

上の例では､次の JSON レスポンスオブジェクトが返されます。


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

戻り値

上の例に示すように、VirtualPixelCoordinate オブジェクトが返されます。VirtualPixelCoordinate を参照してください。