coordinateFormatter

// 要转换的纬度/经度字符串
let latlon = "55 56 39.123N 003 09 43.034W"

// 加载“coordinateFormatter”模块的依赖关系
coordinateFormatter.load().then(function() {
  // 一旦 load() 返回的承诺得到解决，
  // 使用 fromLatitudeLongitude() 方法
  // 纬度/经度字符串转换为点几何。
  let point = coordinateFormatter.fromLatitudeLongitude(latlon);
});

方法列表

方法详细说明

fromLatitudeLongitude(coordinates, spatialReference){Point}static

以纬度/经度表示法分析坐标，并返回表示该位置的 Point。坐标可以使用十进制度、度和十进制分钟，或者度、分和秒格式。所提供的空间参考必须具有与纬度/经度字符串源所使用的椭圆体和基准相匹配的椭圆体和基准。如果未提供空间参考，则假定纬度/经度坐标为 WGS84。

支持的字符

符号	字符	属性	Unicode 数字	HTML 代码
Degree	*	Asterisk	U+002A	*
	^	Circumflex Accent	U+005E	^
	~	Tilde	U+007E	~
	°	Degree Sign	U+00B0	°
	º	Masculine Ordinal Indicator	U+00BA	º
Minute	'	Apostrophe	U+0027	'
	′	Prime	U+2032	′
Second	"	Quotation Mark	U+0022	"
	″	Double prime	U+2033	″

纬度/经度字符串可能包含前导和尾随空格，还可能包含空格、逗号或竖线符号，以将纬度与经度分开。它还可能包含字符"N"、"S"、"E"和"W"，或者使用减号 （-） 符号来表示每个值的半球。

纬度/经度表示法示例：

• 55 56 39.123N 003 09 43.034W
• 55°56′39″N 3°09′43″W
• 55*56′39″N 3°09′43″W
• 55~56.65205', -003~09.71723'
• 55.9442008* | -3.1619539*

参数：

coordinates String 坐标的纬度/经度表示法字符串。

spatialReference SpatialReference optional 表示地理坐标系的空间参考对象。如果为 null，将使用 WGS84。

返回值：

类型	描述
Point	返回一个点，该点的位置来自所提供的空间参考中的坐标字符串。

fromMgrs(coordinates, spatialReference, conversionMode){Point}static

以军事格网参考系统 （MGRS） 表示法解析坐标，并返回表示该位置的 Point。提供的空间参考必须具有与 MGRS 字符串源所使用的椭圆体和基准相匹配的椭圆体和基准。如果未提供空间参考，则假定 MGRS 字符串引用了 WGS84。

请注意，从 MGRS 表示法字符串读取时，区域 01 和 60 之间的选择没有影响。MGRS 字符串可以包含前导和尾随空格，并且可以在格网区域指示符、100km 正方形标识符以及数字东向和北向之间具有空格。

MGRS 表示法示例：

• 30UVG898998
• 30UVG 89885 99877

参数：

coordinates String 坐标的 MGRS 表示法字符串。

spatialReference SpatialReference 表示 MGRS 坐标所引用的地理坐标系的空间参考对象。如果为 null，将使用 WGS84。

conversionMode String 给定 MGRS 坐标使用的模式。 可选值："automatic"|"new-180-in-zone-01"|"new-180-in-zone-60"|"old-180-in-zone-01"|"old-180-in-zone-60"

返回值：

类型	描述
Point	返回一个点，该点的位置来自所提供的空间参考中的 MGRS 字符串。

fromUsng(coordinates, spatialReference){Point}static

以美国国家格网 （USNG） 表示法分析坐标，并返回表示该位置的 Point。

提供的空间参考必须具有与 USNG 字符串源使用的椭圆体和基准相匹配的椭圆体和基准。如果未提供空间参考，并且 USNG 字符串后缀为"（NAD 27）"，则假定 USNG 字符串引用了 NAD 27。如果未提供空间参考且不存在此类后缀，则假定 USNG 字符串引用了 WGS84。

USNG 表示法示例：

• 13TFJ 23 59
• 13TFJ2374159574

参数：

coordinates String 坐标的 USNG 表示法字符串。

spatialReference SpatialReference optional 一个空间参考对象，表示 USNG 坐标所在的地理坐标系。如果为 null，将使用 WGS84。

返回值：

类型	描述
Point	返回一个点，该点的位置来自所提供的空间参考中的 USNG 字符串。

fromUtm(coordinates, spatialReference, conversionMode){Point}static

以通用横轴墨卡托 （UTM） 表示法分析坐标，并返回表示该位置的 Point。提供的空间参考必须具有与 UTM 字符串源所使用的椭圆体和基准相匹配的椭圆体和基准。如果未提供空间参考，则假定 UTM 字符串引用了 WGS84。UTM 字符串可以包含前导和尾随空格，并且可以在区域和纬度指示符以及数值东行和北向之间具有空格。

UTM 表示法示例：

• 30U 489885 6199877
• 30U4898856199877
• 30N 489885 6199877（使用N/S指示灯）

参数：

coordinates String 坐标的 UTM 表示法字符串。

spatialReference SpatialReference 一个空间参考对象，表示 UTM 坐标所在的地理坐标系。如果为 null，将使用 WGS84。

conversionMode String 给定 UTM 坐标（纬度波段或半球指示符）使用的纬度表示法方案。 可选值:"latitude-band-indicators"|"north-south-indicators"

返回值：

类型	描述
Point	返回一个点，该点的位置来自所提供的空间参考中的 UTM 字符串。

isLoaded(){Boolean}

指示是否已加载此模块的所有依赖项。

返回值：

类型	描述
Boolean	如果已加载此模块的依赖项，则返回 true。

isSupported(){Boolean}

指示当前浏览器是否支持此模块。浏览器必须支持 WebAssembly。

返回值：

类型	描述
Boolean	如果当前浏览器支持此模块，则返回 true。

load(){Promise}

加载此模块的依赖项。

返回值：

类型	描述
Promise	在加载依赖项时解析。

另参阅：

• isLoaded()

toLatitudeLongitude(point, format, decimalPlaces){String}static

以纬度/经度表示法返回格式化坐标，表示给定点的位置。

纬度/经度字符串将包含一个空格，用于将纬度与经度值分隔开来，以及字符 "N" 或 "S" 以及 "E" 和 "W"，以指示每个值的半球。该字符串还将包含分隔每个值的分量（度、分、秒）的空格。输出精度由 format 和 decimalPlaces 参数控制。

例如：

小数位	格式	示例输出	角度精度	近似精度
0	dd	056N 0003W	1deg	100km
1	dd	55.9N 003.2W	0.1deg	10km
2	dd	55.94N 003.16W	0.01deg	1km
3	dd	55.944N 003.162W	0.001deg	100m
0	ddm	55 057N 003 010W	1min	2km
1	ddm	55 56.7N 003 09.7W	0.1min	200m
2	ddm	55 56.65N 003 09.72W	0.01min	20m
3	ddm	55 56.650N 003 09.717W	0.001min	2m
0	dms	55 56 039N 003 09 043W	1sec	30m
1	dms	55 56 39.1N 003 09 43.0W	0.1sec	3m
2	dms	55 56 39.12N 003 09 43.03W	0.01sec	300mm
3	dms	55 56 39.123N 003 09 43.034W	0.001sec	30mm

参数：

point Point 要表示为格式化纬度/经度字符串的位置。点的空间参考应为 WGS84 或其他地理坐标系。

format String 设置纬度/经度字符串格式时要使用的模式。 可选值："dd"|"ddm"|"dms"

decimalPlaces Number optional 要使用的小数位数，它应该是从 0 到 16 的整数。

返回值：

类型	描述
String	返回一个字符串，该字符串表示给定点的纬度/经度。

toMgrs(point, conversionMode, precision, addSpaces){String}static

以军事格网参考系 （MGRS） 表示法返回表示给定点位置的格式化坐标。

请注意，区域 01 和 60 之间的选择仅在为经度正好为 180 度格的点生成 MGRS 表示法字符串时才有影响。精度值控制用于表示 MGRS 字符串中每个数字东向和向北值的位数。

例如：

精度	add_spaces	示例输出	近似精度
0	false	30UVG	100km
1	false	30UVG89	10km
2	false	30UVG8999	1km
3	false	30UVG898998	100m
4	false	30UVG89889988	10m
5	false	30UVG8988499881	1m
0	true	30U VG	100km
1	true	30U VG 8 9	10m
2	true	30U VG 89 99	1km
3	true	30U VG 898 998	100m
4	true	30U VG 8988 9988	10m
5	true	30U VG 89884 99881	1m

参数：

point Point 要用 MGRS 表示法表示的位置。点的空间参考应为 WGS84 或其他地理坐标系。

conversionMode String 用于返回的 MGRS 表示法字符串的模式。 可选值："automatic"|"new-180-in-zone-01"|"new-180-in-zone-60"|"old-180-in-zone-01"|"old-180-in-zone-60"

precision Number optional 表示坐标的精度，它应该是从 0 到 8 的整数。

addSpaces Boolean optional 如果为 false，则生成的字符串将不包含空格。如果为 true，空格将分隔格网区域指示符、100km 正方形标识符以及东和北向数值。

返回值：

类型	描述
String	返回一个 MGRS 表示法字符串，该字符串表示给定点的位置。

toUsng(point, precision, addSpaces){String}static

以美国国家格网 （USNG） 表示法返回表示给定点位置的格式化坐标。精度值控制用于表示 USNG 字符串中每个数字东向和向北值的位数。

例如：

精度	add_spaces	示例输出	近似精度
0	false	13TFJ	100km
1	false	13TFJ25	10km
2	false	13TFJ2359	1km
3	false	13TFJ237595	100m
4	false	13TFJ23745951	10m
5	false	13TFJ2374359512	1m
0	true	13T FJ	100km
1	true	13T FJ 2 5	10m
2	true	13T FJ 23 59	1km
3	true	13T FJ 237 595	100m
4	true	13T FJ 2374 5951	10m
5	true	13T FJ 23743 59512	1m
4*	false	13TFJ23795929 (NAD 27)	10m
2*	true	13T FJ 23 59 (NAD 27)	1km

* 当点的空间参考基于 NAD 27 时。

参数：

point Point 要用 USNG 表示法表示的位置。点的空间参考应为 WGS84 或其他地理坐标系。

precision Number optional 表示坐标的精度，它应该是从 0 到 8 的整数。

addSpaces Boolean optional 如果为 false，则生成的字符串将不包含空格。如果为 true，空格将分隔格网区域指示符、100km 正方形标识符以及东和北向数值。

返回值：

类型	描述
String	返回一个 USNG 表示法字符串，该字符串表示给定点的位置。

toUtm(point, conversionMode, addSpaces){String}static

以通用横轴墨卡托 （UTM） 表示法返回表示给定点位置的格式化坐标。

南半球某个点的示例输出：

转换模式	add_spaces	示例输出
latitude-band-indicators	false	30U4898846199881
latitude-band-indicators	true	30U 489884 6199881
north-south-indicators	false	30N4898846199881
north-south-indicators	true	30N 489884 6199881

参数：

point Point 要用 UTM 表示法表示的位置。点的空间参考应为 WGS84 或其他地理坐标系

conversionMode String 要在返回的 UTM 表示法字符串中使用的纬度表示法方案，可以是纬度波段，也可以是半球指示符。 可选值："latitude-band-indicators"|"north-south-indicators"

addSpaces Boolean optional 如果为 false，则生成的字符串将不包含空格。如果为 true，空间将 UTM 区和纬度指示符以及每个数值东和北值分开。

返回值：

类型	描述
String	返回一个 UTM 表示法字符串，该字符串表示给定点的位置。