convertMapToVirtualPixelCoord
Description
Converts a specified set of map coordinates to coordinates in the virtual pixel space of the entire map image, and returns them.
Parameters
For information on the parameter types listed below, see Request URL Data Types.
Parameter | Type | Required | Description |
---|---|---|---|
worldX | Float | yes |
Specifies the x coordinate of the map's point location. The map location is specified in terms of the units of the map coordinate system (for example, degrees or meters). You can determine the coordinate system of the map by calling the convertScreenToMapCoord method and examining the returned MapCoordinate object. For more information, see convertScreenToMapCoord and MapCoordinate. |
worldY | Float | yes |
Specifies the y coordinate of the map's point location. The map location is specified in terms of the units of the map coordinate system (for example, degrees or meters). You can determine the coordinate system of the map by calling the convertScreenToMapCoord method and examining the returned MapCoordinate object. For more information, see convertScreenToMapCoord and MapCoordinate. |
level | Integer | yes |
Specifies the map zoom level. This parameter must be set to a value greater than or equal to the minLevel value and less than or equal to the maxLevel value for the named map. You can determine these values by calling the getDescription method and examining the returned MapDescription object. For more information, see getDescription and MapDescription. |
name | String | yes | Specifies the name of the named map from which the map tiles are generated. |
output | String | yes | Specifies the response format. Must be json. |
Example
http://<server>:<port>/rest/Spatial/LegacyMapTilingService/convertMapToVirtualPixelCoord?
name=/NamedTiles/WorldTile
&level=4
&worldX=-79.377366
&worldY=43.64713
&output=json
The above example will return the following JSON response object:
{"EnvinsaResponse":{"type":"MapTilingResponse","virtualPixelCoord":{"virtualX":1023,"virtualY":1023}}}
Returns
A VirtualPixelCoordinate object as seen in the above example. See VirtualPixelCoordinate.