Remarks

Note that the method does not transform between geodetic datums: For example, if the geodeticDatum parameter represents ED50 (European Datum 1950), then the method formats ED50 LongLat into ED50 MGRS.

The method will return an empty string if the input latitude is not in the range -90° to 90°, or if the input longitude is not in the range -999.5° to 999.5°.

The evenNumberOfDigits parameter must be -2, 0, 2, 4, 6, 8, 10, 12, 14 or 16 and determines the resolution used. If some other value is specified, 10 will be used.

The values 12, 14 and 16 are not allowed in military MGRS, but they are allowed in the civilian version USNG (US National Grid).

Remarks

In the more basic variant of this method, FormatMgrs(geodeticDatum, letteringScheme, insertSpaces, evenNumberOfDigits, longLat), the zone for the output is selected automatically, based on the longLat parameter.

But in this variant, the user can select the zone for the output. Use 1 to 60 to select a UTM zone, or 90 to select UPS North, or -90 to select UPS South. An exception will be thrown for other values.

This can be useful for a small area that crosses the boundary between two UTM zones. To avoid problems at the zone boundary, one can agree to use only one zone for the entire area of interest. In other words, the UTM grid of the selected zone is extended a bit.

According to the UTM specifications, a UTM grid may be extended at least 40 km into the neighboring zone. This method tries to be as generous as possible, but there are inherent limitations in the MGRS lettering scheme (see bullet list below). So, if the user-selected zone cannot be extended to cover the given longLat position, the method will throw an exception.

This method will also throw an exception if the input latitude is not in the range -90° to 90°, or if the input longitude is not in the range -999.5° to 999.5°. (This differs from the basic variant FormatMgrs(geodeticDatum, letteringScheme, insertSpaces, evenNumberOfDigits, longLat), which just returns an empty string in this case.)

In other respects, this method behaves like the basic variant.

• Limits for an extended UTM zone: the position must be at most 400 km from the central meridian, and at most 9500 km north of the equator (about 85.5°N), and at most 9000 km south of the equator (about 81°S).

• Limits for extended UPS North: when the position is expressed in UPS North, both easting and northing must be between 1300 km and 2700 km.

• Limits for extended UPS South: when the position is expressed in UPS South, both easting and northing must be between 800 km and 3200 km.

Remarks

Note that the method does not transform between geodetic datums: For example, if the geodeticDatum parameter represents ED50 (European Datum 1950), then the method formats ED50 LongLat into ED50 MGRS.

The method will return an empty string if the input latitude is not in the range -90° to 90°, or if the input longitude is not in the range -999.5° to 999.5°.

The evenNumberOfDigits parameter must be -2, 0, 2, 4, 6, 8, 10, 12, 14 or 16 and determines the resolution used. If some other value is specified, 10 will be used.

The values 12, 14 and 16 are not allowed in military MGRS, but they are allowed in the civilian version USNG (US National Grid).

Remarks

In the more basic variant of this method, formatMgrs(geodeticDatum, letteringScheme, insertSpaces, evenNumberOfDigits, longLat), the zone for the output is selected automatically, based on the longLat parameter.

But in this variant, the user can select the zone for the output. Use 1 to 60 to select a UTM zone, or 90 to select UPS North, or -90 to select UPS South. An exception will be thrown for other values.

This can be useful for a small area that crosses the boundary between two UTM zones. To avoid problems at the zone boundary, one can agree to use only one zone for the entire area of interest. In other words, the UTM grid of the selected zone is extended a bit.

According to the UTM specifications, a UTM grid may be extended at least 40 km into the neighboring zone. This method tries to be as generous as possible, but there are inherent limitations in the MGRS lettering scheme (see bullet list below). So, if the user-selected zone cannot be extended to cover the given longLat position, the method will throw an exception.

This method will also throw an exception if the input latitude is not in the range -90° to 90°, or if the input longitude is not in the range -999.5° to 999.5°. (This differs from the basic variant formatMgrs(geodeticDatum, letteringScheme, insertSpaces, evenNumberOfDigits, longLat), which just returns an empty string in this case.)

In other respects, this method behaves like the basic variant.

• Limits for an extended UTM zone: the position must be at most 400 km from the central meridian, and at most 9500 km north of the equator (about 85.5°N), and at most 9000 km south of the equator (about 81°S).

• Limits for extended UPS North: when the position is expressed in UPS North, both easting and northing must be between 1300 km and 2700 km.

• Limits for extended UPS South: when the position is expressed in UPS South, both easting and northing must be between 800 km and 3200 km.

Remarks

Note that the method does not transform between geodetic datums: For example, if the geodeticDatum parameter represents ED50 (European Datum 1950), then the method formats ED50 LongLat into ED50 MGRS.

The method will return an empty string if the input latitude is not in the range -90° to 90°, or if the input longitude is not in the range -999.5° to 999.5°.

The evenNumberOfDigits parameter must be -2, 0, 2, 4, 6, 8, 10, 12, 14 or 16 and determines the resolution used. If some other value is specified, 10 will be used.

The values 12, 14 and 16 are not allowed in military MGRS, but they are allowed in the civilian version USNG (US National Grid).

Remarks

In the more basic variant of this method, formatMgrs(geodeticDatum, letteringScheme, insertSpaces, evenNumberOfDigits, longLat), the zone for the output is selected automatically, based on the longLat parameter.

But in this variant, the user can select the zone for the output. Use 1 to 60 to select a UTM zone, or 90 to select UPS North, or -90 to select UPS South. An exception will be thrown for other values.

This can be useful for a small area that crosses the boundary between two UTM zones. To avoid problems at the zone boundary, one can agree to use only one zone for the entire area of interest. In other words, the UTM grid of the selected zone is extended a bit.

According to the UTM specifications, a UTM grid may be extended at least 40 km into the neighboring zone. This method tries to be as generous as possible, but there are inherent limitations in the MGRS lettering scheme (see bullet list below). So, if the user-selected zone cannot be extended to cover the given longLat position, the method will throw an exception.

This method will also throw an exception if the input latitude is not in the range -90° to 90°, or if the input longitude is not in the range -999.5° to 999.5°. (This differs from the basic variant formatMgrs(geodeticDatum, letteringScheme, insertSpaces, evenNumberOfDigits, longLat), which just returns an empty string in this case.)

In other respects, this method behaves like the basic variant.

• Limits for an extended UTM zone: the position must be at most 400 km from the central meridian, and at most 9500 km north of the equator (about 85.5°N), and at most 9000 km south of the equator (about 81°S).

• Limits for extended UPS North: when the position is expressed in UPS North, both easting and northing must be between 1300 km and 2700 km.

• Limits for extended UPS South: when the position is expressed in UPS South, both easting and northing must be between 800 km and 3200 km.

Remarks

Note that the method does not transform between geodetic datums: For example, if the geodeticDatum parameter represents ED50 (European Datum 1950), then the method formats ED50 LongLat into ED50 MGRS.

The method will return an empty string if the input latitude is not in the range -90° to 90°, or if the input longitude is not in the range -999.5° to 999.5°.

The evenNumberOfDigits parameter must be -2, 0, 2, 4, 6, 8, 10, 12, 14 or 16 and determines the resolution used. If some other value is specified, 10 will be used.

The values 12, 14 and 16 are not allowed in military MGRS, but they are allowed in the civilian version USNG (US National Grid).

Remarks

In the more basic variant of this method, formatMgrs(geodeticDatum, letteringScheme, insertSpaces, evenNumberOfDigits, longLat), the zone for the output is selected automatically, based on the longLat parameter.

But in this variant, the user can select the zone for the output. Use 1 to 60 to select a UTM zone, or 90 to select UPS North, or -90 to select UPS South. An exception will be thrown for other values.

This can be useful for a small area that crosses the boundary between two UTM zones. To avoid problems at the zone boundary, one can agree to use only one zone for the entire area of interest. In other words, the UTM grid of the selected zone is extended a bit.

According to the UTM specifications, a UTM grid may be extended at least 40 km into the neighboring zone. This method tries to be as generous as possible, but there are inherent limitations in the MGRS lettering scheme (see bullet list below). So, if the user-selected zone cannot be extended to cover the given longLat position, the method will throw an exception.

This method will also throw an exception if the input latitude is not in the range -90° to 90°, or if the input longitude is not in the range -999.5° to 999.5°. (This differs from the basic variant formatMgrs(geodeticDatum, letteringScheme, insertSpaces, evenNumberOfDigits, longLat), which just returns an empty string in this case.)

In other respects, this method behaves like the basic variant.

• Limits for an extended UTM zone: the position must be at most 400 km from the central meridian, and at most 9500 km north of the equator (about 85.5°N), and at most 9000 km south of the equator (about 81°S).

• Limits for extended UPS North: when the position is expressed in UPS North, both easting and northing must be between 1300 km and 2700 km.

• Limits for extended UPS South: when the position is expressed in UPS South, both easting and northing must be between 800 km and 3200 km.