Crs.ParseGarsAsArea Method
Parses an GARS string (Global Area Reference System) and returns a square polygon geometry in WGS84 LongLat.
ParseGarsAsArea(System.String gars)
Parses an GARS string (Global Area Reference System) and returns a square polygon geometry in WGS84 LongLat.Syntax
public static PolygonGeometry ParseGarsAsArea (
System.String gars
)Parameters
The GARS string.
Return Value
The square polygon geometry that the GARS string denotes, expressed in WGS84 LongLat.
Remarks
An alphanumeric GARS string denotes a WGS84 LongLat square with one of three possible sizes. The largest kind of square is a 30-minute cell, and its GARS string consist of a three-digit cell column code and a two-letter cell row code, for example 045KG. If you add a quadrant digit (1 to 4) to such a GARS string, then the result - for example 045KG1 - denotes a medium-sized square, a 15-minute quadrant within the cell. If you also add a key digit (1 to 9), the result - for example 045KG18 - denotes the smallest kind of square, a 5-minute key area within the quadrant.
 |
The GARS string parameter may contain leading and trailing spaces and tabs, which will be ignored, but no whitespace is allowed between the letters and digits. In the three-digit column code, leading zeros must be included, so 045 must not be abbreviated to 45. The two letters for the cell row code must be upper-case; the first letter must be from A to Q and the second letter can be from A to Z, except that the letters I and O are illegal since they look like the digits 1 and 0.
If the GARS string cannot be parsed, the method will throw an exception with an informative message.
Platforms
Windows, Linux, Android