MapCoordToXY()
Summary
Translates a longitude-latitude coordinate to a local map X-Y coordinate.
Syntax
xy = MapCoordToXY(string map_name, coordinate c)
| Argument | Contents |
|---|---|
| map_name | The map whose coordinate system is used |
| c | The coordinate to be translated |
Returns
An array of two real numbers: the x-value and the y-value.
Notes
-
If the map_name is null, the current map is used.
-
x and y will be in the units specified by the coordinate system (e.g., miles or meters). If the units are omitted in the coordinate system, meters are used.
-
The map should be displayed using a coordinate system. If only a projection is used, the result is unspecified.
-
For more details on coordinate systems, see Using Projections and Coordinate Systems.
Error Codes
| Error Type | Meaning |
|---|---|
| Error | The translation has failed |
| NotFound | The specified map was not found |
See Also
| Function | Summary |
|---|---|
| GetMapProjection() | Returns the projection and coordinate system used in a map |
| MapCoordToPixelXY() | Translates a longitude-latitude coordinate to a map pixel X-Y coordinate |
| MapPixelXYToCoord() | Translates a map pixel X-Y coordinate to longitude and latitude |
| MapXYToCoord() | Translates a local map X-Y coordinate to longitude and latitude |