coordinateFormatter

// The latitude/longitude string to be converted
let latlon = "55 56 39.123N 003 09 43.034W"

// Load dependencies of "coordinateFormatter" module
coordinateFormatter.load().then(function() {
  // Once the promise returned by load() is resolved,
  // use the fromLatitudeLongitude() method to convert
  // latitude/longitude string to a point geometry.
  let point = coordinateFormatter.fromLatitudeLongitude(latlon);
});

方法概述

方法详细说明

fromLatitudeLongitude(coordinates, spatialReference){Point}static

以纬度/经度表示法解析坐标，并返回表示该位置的点。坐标可以使用十进制度、度和十进制分，或者度、分和秒格式。所提供的空间参考必须具有与纬度/经度字符串源所使用的椭球体和基准面相匹配的椭球体和基准面。如果未提供空间参考，则假定纬度/经度坐标为 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) 表示法解析坐标，并返回表示该位置的点。所提供的空间参考必须具有与 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) 表示法解析坐标，并返回表示该位置的点。

所提供的空间参考必须具有与 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) 表示法解析坐标，并返回表示该位置的点。所提供的空间参考必须具有与 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 参数控制。

示例：

小数位	format	示例输出	角度精度	近似精度
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) 表示法返回格式化坐标，表示给定点的位置。

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

示例：

precision	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，则使用空格将格网区域指示符、100 平方公里标识符以及东和北向数值分隔开来。

返回

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

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

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

示例：

precision	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，则使用空格将格网区域指示符、100 平方公里标识符以及东和北向数值分隔开来。

返回

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

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

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

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

conversionMode	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 表示法字符串，用于表示给定点的位置。