-
Name Type 描述 readExtensionsfunction | undefined 用于处理的回调函数
extensions节点。为了防止内存泄漏,该回调函数不应存储对该节点的任何引用。请注意,extensions在GPX 1.0规范中,节点是不被允许的。此外,仅extensions节点来源于wpt,rte和trk这些可以被处理,因为它们直接映射到要素。
继承
方法
-
读取单个要素。
Name Type 描述 sourceDocument | Element | Object | string 数据源.
optionsRead options.
Name Type 描述 dataProjectionProjectionLike | undefined 所读取数据的投影。若未提供,投影将从数据中推导(如可能)或
dataProjection格式被指定(如果已设置)。如果无法从数据中推导出投影,并且如果没有dataProjection格式设置后,要素将不会被重新投影。extentExtent | undefined 当前读取图块的地图单位范围。仅当读取以平铺像素作为几何单位的数据时才需要此配置。配置后,将出现一个
dataProjection使用TILE_PIXELS作为units以及瓦片的像素范围作为extent需提供。featureProjectionProjectionLike | undefined 格式阅读器创建的要素几何图形的投影。如果不提供,要素将以该投影返回。
dataProjection.返回:
要素.
-
从要素集合中读取所有要素。
Name Type 描述 sourceDocument | Element | Object | string 数据源.
optionsOptions.
Name Type 描述 dataProjectionProjectionLike | undefined 所读取数据的投影。若未指定,投影将根据数据(如可能)或
dataProjection格式的指定(若已设置)。如果投影无法从数据中推导,并且如果没有dataProjection格式设置后,要素将不会被重新投影。extentExtent | undefined 正在读取图块的地图单位范围。仅当读取以瓦片像素作为几何单位的数据时才需要。配置后,一个。
dataProjection和TILE_PIXELS作为units以及瓦片的像素范围作为extent需提供。featureProjectionProjectionLike | undefined 由格式读取器创建的要素几何图形的投影。如果未提供,要素将返回于该投影。
dataProjection.返回:
要素。
-
读取 GPX 文件的元数据标签,包括但不限于:
- 该GPX文件的名称及描述
- 其作者
- 此GPX文件的版权
如果不存在元数据标签(或未给出有效源),则返回 null。
Name Type 描述 sourceDocument | Element | Object | string 数据源.
返回:
元数据
-
从源读取投影。
Name Type 描述 sourceDocument | Element | Object | string 数据源.
返回:
投影.
-
将要素数组编码为字符串。
Name Type 描述 featuresArray<Feature> 要素。
optionsWrite options.
Name Type 描述 dataProjectionProjectionLike | undefined 所写入数据的投影。若未提供,则
dataProjection格式的指定(如果已设置)。如果没有dataProjection如果设置了格式,要素将以该格式返回。featureProjection.featureProjectionProjectionLike | undefined 待由格式编写器序列化的要素几何的投影。如果未提供,则假定几何位于
dataProjection如果已设置;换言之,它们未转换。rightHandedboolean | undefined 在编写几何图形时,应遵循线性环方向的右手定则。这意味着多边形的外环应为逆时针方向,内环应为顺时针方向。默认情况下,坐标按构造时提供的顺序进行序列化。如果
true,将应用右手定则。如果false将采用左手法则(外环顺时针,内环逆时针)。请注意,并非所有格式都支持此属性;GeoJSON 格式在序列化几何图形时确实使用此属性。decimalsnumber | undefined 坐标的最大小数位数。坐标在内部以浮点数形式存储,但浮点运算可能产生大量小数位的坐标,这在输出中通常不必要。在此处设置数值以对坐标进行舍入。此设置还可确保读入的坐标在写回时保持相同的小数位数。默认情况下不进行舍入。
返回:
结果。
-
将 GPX 格式的要素数组编码为 XML 节点。LineString 几何输出为路线 (
<rte>),MultiLineString 输出为轨迹 (<trk>)。Name Type 描述 featuresArray<Feature> 要素。
optionsOptions.
Name Type 描述 dataProjectionProjectionLike | undefined 写入数据的投影。若未提供,则
dataProjection格式的指定(如果已设置)。如果没有dataProjection当格式被设定后,要素将按该格式返回。featureProjection.featureProjectionProjectionLike | undefined 由格式写入器序列化的要素几何的投影。如果未提供,则假定几何位于
dataProjection如果已设置;换言之,它们不会被转换。rightHandedboolean | undefined 创建几何图形时,需遵循环方向的右手法则。这意味着多边形的外环应逆时针定向,内环应顺时针定向。默认情况下,坐标将按照构造时提供的原始顺序进行序列化。如果
true,将应用右手定则。如果false将遵循左手法则(外环顺时针,内环逆时针)。请注意,并非所有格式都支持此规则。GeoJSON 格式在写入几何数据时会使用此属性。decimalsnumber | undefined 坐标小数位数的最大值。坐标在内部以浮点数形式存储,但浮点运算可能生成具有大量小数位的坐标,这在输出中通常不希望出现。在此处设置一个数值以对坐标进行舍入。还可用于确保读入的坐标在写回时保持相同的小数位数。默认情况下不进行舍入。
返回:
节点。