类：JSONFeature

子类

• EsriJSON
• GeoJSON
• TopoJSON

继承

• FeatureFormat

方法

readFeature(source, options){FeatureType | Array.<FeatureType>}

format/JSONFeature.js, line 40

读取一个要素。仅适用于单个要素。使用 readFeatures 读取要素集合。

Name	Type	描述
source	ArrayBuffer | Document | Element | Object | string	数据源.
options	Read options. Name Type 描述 dataProjection ProjectionLike | undefined 所读取数据的投影。如果未指定，投影将从数据中推导（如可能）或从视图中推导。dataProjection格式的指定（如果已设置）。如果投影无法从数据中推导，并且如果没有dataProjection若格式已设置，要素将不会重新投影。 extent Extent | undefined 瓦片范围以地图单位表示，针对当前读取的瓦片。仅当读取以瓦片像素作为几何单位的数据时才需配置。配置后，将显示一个dataProjection使用TILE_PIXELS作为units以及瓦片的像素范围作为extent需提供。 featureProjection ProjectionLike | undefined 格式解析器创建的要素几何图形的投影。如果未提供，要素将以该投影返回。dataProjection.

返回：

要素.

readFeatures(source, options){Array.<FeatureType>}

format/JSONFeature.js, line 57

读取所有要素。同时支持单个要素和要素集合。

Name	Type	描述
source	ArrayBuffer | Document | Element | Object | string	数据源.
options	Read options. Name Type 描述 dataProjection ProjectionLike | undefined 所读取数据的投影。若未指定，将尝试从数据中推导投影（若可行），或dataProjection格式的指定（若已设置）。如果投影无法从数据中推导，并且如果没有dataProjection格式设置后，要素将不会被重新投影。 extent Extent | undefined 正在读取的图块的地图单位范围。仅当读取以图块像素作为几何单位的数据时才需要。配置后，将出现一个dataProjection与TILE_PIXELS作为units和瓦片的像素范围为extent需提供。 featureProjection ProjectionLike | undefined 格式阅读器所创建要素几何图形的投影。如未提供，要素将返回在dataProjection.

返回：

要素。

readGeometry(source, options){Geometry}

format/JSONFeature.js, line 95

读取几何对象。

Name	Type	描述
source	ArrayBuffer | Document | Element | Object | string	数据源.
options	Read options. Name Type 描述 dataProjection ProjectionLike | undefined 所读取数据的投影。若未提供，投影将从数据（若可能）或视图的投影。dataProjection格式的指定（若已设置）。如果无法从数据中推导出投影，并且如果没有……dataProjection若格式已设置，则要素将不会被重新投影。 extent Extent | undefined 以地图单位表示的正在读取瓦片的范围。仅当读取使用瓦片像素作为几何单位的数据时才需要。配置后，需设置一个图块范围。dataProjection使用TILE_PIXELS作为units和瓦片的像素范围为extent需提供。 featureProjection ProjectionLike | undefined 由格式阅读器创建的要素几何图形的投影。如果未提供，要素将以该投影返回。dataProjection.

返回：

几何.

readProjection(source){Projection}

format/JSONFeature.js, line 121

读取投影。

Name	Type	描述
source	ArrayBuffer | Document | Element | Object | string	数据源.

返回：

投影.

writeFeature(feature, options){string}

format/JSONFeature.js, line 144

将要素编码为字符串。

Name	Type	描述
feature	Feature	要素.
options	Write options. Name Type 描述 dataProjection ProjectionLike | undefined 写入数据的投影。若未提供，则dataProjection格式的分配（如果已设置）。如果没有dataProjection若格式已设置，要素将按该格式返回。featureProjection. featureProjection ProjectionLike | undefined 将被格式编写器序列化的要素几何图形的投影。如果未提供，则假定几何图形位于dataProjection如果该设置已启用，则它们不会被转换；换句话说，它们保持不变。 rightHanded boolean | undefined 在编写几何图形时，应遵循线性环方向的右手定则。这表示多边形的外环应为逆时针方向，内环应为顺时针方向。默认情况下，坐标按构造时提供的顺序进行序列化。如果true，将应用右手定则。如果false将应用左手法则（外环顺时针，内环逆时针）。请注意，并非所有格式都支持此特性。GeoJSON 格式在写入几何图形时确实使用此属性。 decimals number | undefined 坐标小数位数的最大值。坐标在内部以浮点数形式存储，但浮点数运算可能产生小数位数过多的坐标，这在输出时通常并不需要。在此设置数值以对坐标进行舍入。同时可确保读入的坐标在写回时保持相同的小数位数。默认不进行舍入。

返回：

编码要素。

writeFeatures(features, options){string}

format/JSONFeature.js, line 167

将要素数组编码为字符串。

Name	Type	描述
features	Array<Feature>	要素。
options	Write options. Name Type 描述 dataProjection ProjectionLike | undefined 所写入数据的投影。若未提供，则dataProjection格式被指定（如果已设置）。如果没有dataProjection若格式已设置，则要素将按该格式返回。featureProjection. featureProjection ProjectionLike | undefined 将被格式写入器序列化的要素几何图形的投影。如果未提供，则假定几何图形位于dataProjection如果已设置，则它们未被变换；换句话说。 rightHanded boolean | undefined 在创建几何图形时，请遵循线性环方向的右手定则。这意味着多边形的外环应为逆时针方向，内环应为顺时针方向。默认情况下，坐标按构造时提供的顺序进行序列化。如果true，将应用右手定则。如果false采用左手法则（外环顺时针，内环逆时针）。请注意，并非所有格式都支持此规则；GeoJSON 格式在写入几何数据时使用此规则。 decimals number | undefined 坐标的最大小数位数。坐标在内部以浮点数形式存储，但浮点运算可能生成具有大量小数位的坐标值，这些在输出中通常是不必要的。在此处设置一个数值以对坐标进行舍入。此设置还可确保读入的坐标能以相同的小数位数写回。默认情况下不进行舍入。

返回：

编码要素。

writeGeometry(geometry, options){string}

format/JSONFeature.js, line 190

将几何编码为字符串。

Name	Type	描述
geometry	Geometry	几何.
options	Write options. Name Type 描述 dataProjection ProjectionLike | undefined 待写入数据的投影。若未提供，则dataProjection格式的指定（如果已设置）。如果没有dataProjection若格式已设置，要素将以该格式返回。featureProjection. featureProjection ProjectionLike | undefined 将被格式写入器序列化的要素几何的投影。如果未提供，则假定其位于dataProjection如果已设置；换句话说，它们不会被变换。 rightHanded boolean | undefined 在编写几何图形时，请遵循线性环方向的右手定则。这意味着多边形应具有逆时针的外环和顺时针的内环。默认情况下，坐标将按照构造时提供的顺序进行序列化。如果true，右手定则将被应用。如果false采用左手法则（外环顺时针，内环逆时针）。需注意，并非所有格式均支持此规则；GeoJSON 格式在写入几何图形时确实应用了该属性。 decimals number | undefined 坐标的最大小数位数。坐标在内部以浮点数形式存储，但浮点运算可能产生小数位过多的坐标，这在输出中通常不必要。在此设置一个数值以对坐标进行舍入。此外，还可确保读取的坐标能以相同的小数位数写回。默认情况下不进行舍入。

返回：

编码几何。