1.簡介
GeoJSON 是一種對(duì)各種地理數(shù)據(jù)結(jié)構(gòu)進(jìn)行編碼的格式枫浙。GeoJSON 對(duì)象可以表示幾何、特征或者特征集合窗慎。GeoJSON 支持下面幾何類型:點(diǎn)骨宠、線赶袄、面经柴、多點(diǎn)、多線钟些、多面和幾何集合烟号。GeoJSON 里的特征包含一個(gè)幾何對(duì)象和其他屬性,特征集合表示一系列特征政恍。
一個(gè)完整的 GeoJSON 數(shù)據(jù)結(jié)構(gòu)總是一個(gè)(JSON 術(shù)語里的)對(duì)象汪拥。在 GeoJSON 里,對(duì)象由 名/值對(duì)(name/value pair)——也稱作成員的集合組成篙耗。對(duì)每個(gè)成員來說迫筑,名稱總是字符串。成員的值要么是字符串宗弯、數(shù)字脯燃、對(duì)象、數(shù)組蒙保,要么是下面文本常量中的一個(gè):true
, false
和 null
辕棚。數(shù)組由元素(element)組成,其中每個(gè)元素都是如上所述的值邓厕。
1.1 舉例
GeoJSON 特征集合:
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [102.0, 0.5]
},
"properties": {
"prop0": "value0"
}
},
{
"type": "Feature",
"geometry": {
"type": "LineString",
"coordinates": [
[102.0, 0.0],
[103.0, 1.0],
[104.0, 0.0],
[105.0, 1.0]
]
},
"properties": {
"prop0": "value0",
"prop1": 0.0
}
},
{
"type": "Feature",
"geometry": {
"type": "Polygon",
"coordinates": [
[
[100.0, 0.0],
[101.0, 0.0],
[101.0, 1.0],
[100.0, 1.0],
[100.0, 0.0]
]
]
},
"properties": {
"prop0": "value0",
"prop1": {
"this": "that"
}
}
}
]
}
1.2 定義
JavaScript 對(duì)象表示和術(shù)語對(duì)象逝嚎、名字、值详恼、數(shù)組和數(shù)字在 IETF RFC 4627 即 IETF RFC 4627 里定義补君。
這篇文檔里的關(guān)鍵字“必須“,”不允許“单雾,”需要“赚哗,”應(yīng)當(dāng)“,”應(yīng)當(dāng)不“硅堆,”應(yīng)該“屿储,”不應(yīng)該“,”推薦的“渐逃,”也許“和”可選的“在 IETF RFC 2119够掠, 即 IETF RFC 2119 里解釋。
2.GeoJSON 對(duì)象
2.1 幾何對(duì)象
幾何是一種 GeoJSON 對(duì)象茄菊,這時(shí) type 成員的值是下面字符串之一:"Point", "MultiPoint", "LineString", "MultiLineString", "Polygon", "MultiPolygon", 或者"GeometryCollection"疯潭。
除了“GeometryCollection”外的其他任何類型的 GeoJSON 幾何對(duì)象必須由一個(gè)名字為 "coordinates" 的成員。coordinates 成員的值總是數(shù)組面殖。這個(gè)數(shù)組里的元素的結(jié)構(gòu)由幾何類型來確定竖哩。
2.1.1 位置
位置是基本的幾何結(jié)構(gòu)。幾何對(duì)象的 "coordinates" 成員由一個(gè)位置(這兒是幾何點(diǎn))脊僚、位置數(shù)組(線或者幾何多點(diǎn))相叁,位置數(shù)組的數(shù)組(面、多線)或者位置的多維數(shù)組(多面)組成。
位置由數(shù)字?jǐn)?shù)組表示增淹。必須至少兩個(gè)元素椿访,可以有更多元素。元素的順序必須遵從x,y,z順序(投影坐標(biāo)參考系統(tǒng)中坐標(biāo)的東向虑润、北向成玫、高度或者地理坐標(biāo)參考系統(tǒng)中的坐標(biāo)長度、緯度拳喻、高度)哭当。任何數(shù)目的其他元素是允許的---其他元素的說明和意義超出了這篇規(guī)格說明的范圍。
位置和幾何的例子在附錄A.幾何例子里呈現(xiàn)舞蔽。
2.1.2 點(diǎn)
對(duì)類型Point
來說荣病,coordinates
成員必須是一個(gè)單獨(dú)的 position
。
2.1.3 多點(diǎn)
對(duì)類型 MultiPoint
來說渗柿,coordinates
成員必須是 position 數(shù)組
个盆。
2.1.4 線
對(duì)類型 LineString
來說,coordinates
成員必須是 MultPoint 數(shù)組
朵栖。
LinearRing
(線性環(huán)) 是具有4個(gè)或者更多 position
的封閉的線颊亮。第一個(gè)和最后一個(gè)位置是相等的(它們表示相同的的點(diǎn))。雖然 LinearRing
(線性環(huán)) 沒有鮮明地作為 GeoJSON 幾何類型陨溅,不過在面幾何類型(Polygon)定義里有提到它终惑。
2.1.5 多線
對(duì)類型 MultiLineString
來說,coordinates
成員必須是一個(gè) LineString 數(shù)組
门扇。
2.1.6 面
對(duì)類型 Polygon
來說雹有,coordinates
成員必須是一個(gè) LinearRing 數(shù)組
。對(duì)擁有多個(gè) LinearRing
(線性環(huán)) 的面來說臼寄,第一個(gè)環(huán)必須是外部環(huán)霸奕,其他的必須是內(nèi)部環(huán)或者孔。
2.1.7 多面
對(duì)類型 MultiPlygon
來說吉拳,coordinates
成員必須是 Polygon 數(shù)組
质帅。
2.1.8 幾何集合
類型為 GeometryCollection
的 GeoJSON 對(duì)象是一個(gè)集合對(duì)象,它表示幾何對(duì)象 (geometry objects) 的集合留攒。
幾何集合必須有一個(gè)名字為 geometries
的成員煤惩。與 geometries
相對(duì)應(yīng)的值是一個(gè)數(shù)組。這個(gè)數(shù)組中的每個(gè)元素都是一個(gè) GeoJSON 幾何對(duì)象炼邀。
2.2 特征對(duì)象
類型為 "Feature" 的 GeoJSON 對(duì)象是特征對(duì)象魄揉。
特征對(duì)象必須由一個(gè)名字為 "geometry" 的成員,這個(gè)幾何成員的值是上面定義的幾何對(duì)象或者 JSON 的
null
值拭宁。特征對(duì)戲那個(gè)必須有一個(gè)名字為 "properties" 的成員什猖,這個(gè)屬性成員的值是一個(gè)對(duì)象(任何 JSON 對(duì)象或者 JSON 的
null
值)票彪。如果特征是常用的標(biāo)識(shí)符,那么這個(gè)標(biāo)識(shí)符應(yīng)當(dāng)包含名字為 “id” 的特征對(duì)象成員不狮。
2.3 特征集合對(duì)象
類型為 "FeatureCollection" 的 GeoJSON 對(duì)象是特征集合對(duì)象。
類型為 "FeatureCollection" 的對(duì)象必須由一個(gè)名字為 "features" 的成員在旱。與 “features" 相對(duì)應(yīng)的值是一個(gè)數(shù)組摇零。這個(gè)數(shù)組中的每個(gè)元素都是上面定義的特征對(duì)象。
3.坐標(biāo)參考系統(tǒng)對(duì)象
GeoJSON 對(duì)象的坐標(biāo)參考系統(tǒng)(CRS)是由它的 "crs" 成員(指的是下面的 CRS 對(duì)象)來確定的桶蝎。如果對(duì)象沒有 crs 成員驻仅,那么它的父對(duì)象或者祖父對(duì)象的 crs 成員可能被獲取作為它的 crs。如果這樣還沒有獲得 crs 成員登渣,那么默認(rèn)的 CRS 將應(yīng)用到 GeoJSON 對(duì)象噪服。
- 默認(rèn)的 CRS 是地理坐標(biāo)參考系統(tǒng),使用的是 WGS84 數(shù)據(jù)胜茧,長度和高度的單位是十進(jìn)制標(biāo)示粘优。
- 名字為 "crs" 成員的值必須是 JSON 對(duì)象(指的是下面的 CRS 對(duì)象)或者 JSON 的
null
。如果 CRS 的值為 null呻顽,那么就假設(shè)沒有 CRS 了雹顺。 - crs 成員應(yīng)當(dāng)位于(特征集合、特征廊遍、幾何的順序的)層級(jí)結(jié)構(gòu)里 GeoJSON 對(duì)象的最頂級(jí)嬉愧,而且在自對(duì)象或者孫子對(duì)象里不應(yīng)該重復(fù)或者覆蓋。
- 非空的 CRS 對(duì)象有兩個(gè)強(qiáng)制擁有的對(duì)象:"type" 和 "properties"喉前。
- type 成員的值必須是字符串没酣,這個(gè)字符串說明了 CRS 對(duì)象的類型。
- 屬性成員的值必須是對(duì)象卵迂。
- CRS 應(yīng)不能更改坐標(biāo)順序裕便。
3.1 名字 CRS
CRS 對(duì)象可以通過名字來表明坐標(biāo)參考系統(tǒng)。在這種情況下狭握,它的 "type" 成員的值必須是字符串 "name"闪金。它的 "properties" 成員的值必須是包含 "name" 成員的對(duì)象。這個(gè) "name" 成員的值必須是標(biāo)識(shí)坐標(biāo)參考系統(tǒng)的字符串论颅。比如 "urn:ogc:def:crs:OGC:1.3:CRS84"
的 OGC CRS 的 URN 應(yīng)當(dāng)優(yōu)先于舊的標(biāo)識(shí)符如 "EPSG:4326"
得到選用:
"crs": {
"type": "name",
"properties": {
"name": "urn:ogc:def:crs:OGC:1.3:CRS84"
}
3.2 連接 CRS
CRS 對(duì)象也可以連接到互聯(lián)網(wǎng)上的 CRS 參數(shù)哎垦。在這種情況下,它的 "type" 成員的值必須是字符串 "link",它的 "properties" 成員的值必須是一個(gè)連接對(duì)象 恃疯。
3.2.1 連接對(duì)象
連接對(duì)象由一個(gè)必需的成員:"href"漏设,和一個(gè)可選的成員:"type"。
必需的 "href" 成員的值必須是解引用的 URI(統(tǒng)一資源標(biāo)識(shí))今妄。
可選的 "type" 成員的值必須是字符串郑口,而且這個(gè)字符串暗示了所提供的 URI 里用來表示 CRS 參數(shù)的格式鸳碧。建議值是:"proj4","ogcwkt",esriwkt"
,不過可以使用其他值:
"crs": {
"type": "link",
"properties": {
"href": "http://example.com/crs/42",
"type": "proj4"
}
}
相對(duì)連接常橙裕可以作為輔助文件里的 CRS 的直接處理器:
"crs": {
"type": "link",
"properties": {
"href": "data.crs",
"type": "ogcwkt"
}
}
4.邊界框
為了包含幾何瞻离、特征或者特征集合的坐標(biāo)范圍信息,GeoJSON 對(duì)象可能有一個(gè)名字為 bbox 的成員乒裆。bbox 成員的值必須是 2*n 數(shù)組套利,這兒 n 是所包含幾何對(duì)象的維數(shù),并且所有坐標(biāo)軸的最低值后面跟著最高者值鹤耍。bbox 的坐標(biāo)軸的順序遵循幾何坐標(biāo)軸的順序肉迫。除此之外,bbox 的坐標(biāo)參考系統(tǒng)假設(shè)匹配它所在 GeoJSON 對(duì)象的坐標(biāo)參考系統(tǒng)稿黄。
特征對(duì)象上的 bbox 成員的例子:
{
"type": "Feature",
"bbox": [-180.0, -90.0, 180.0, 90.0],
"geometry": {
"type": "Polygon",
"coordinates": [
[
[-180.0, 10.0],
[20.0, 90.0],
[180.0, -5.0],
[-30.0, -90.0]
]
]
}
...
}
特征集合對(duì)象 bbox 成員的例子:
{
"type": "FeatureCollection",
"bbox": [100.0, 0.0, 105.0, 1.0],
"features": [
...
]
}
附錄A.集合例子
下面例子中的每一個(gè)都表示一個(gè)完整的 GeoJSON 對(duì)象喊衫。注意 JSON 對(duì)象里的結(jié)尾的空白字符沒有意義。例子里所用的空白符有助于說明這個(gè)數(shù)據(jù)結(jié)構(gòu)杆怕,不過不是必需的族购。
點(diǎn)
點(diǎn)坐標(biāo)是按照 x,y 順序的(投影坐標(biāo)的東向、北向财著,地理坐標(biāo)的長度联四、高度):
{
"type": "Point",
"coordinates": [100.0, 0.0]
}
線
線的坐標(biāo)是位置數(shù)組:
{
"type": "LineString",
"coordinates":
[
[100.0, 0.0],
[101.0, 1.0]
]
}
面
面的坐標(biāo)是線性環(huán)坐標(biāo)數(shù)組的數(shù)組。這個(gè)數(shù)組的第一個(gè)元素表示的是外部環(huán)撑教。其他后續(xù)的元素表示的內(nèi)部環(huán)(或者孔)朝墩。
沒有孔的:
{
"type": "Polygon",
"coordinates":
[
[
[100.0, 0.0],
[101.0, 0.0],
[101.0, 1.0],
[100.0, 1.0],
[100.0, 0.0]
]
]
}
有孔的:
{
"type": "Polygon",
"coordinates":
[
[
[100.0, 0.0],
[101.0, 0.0],
[101.0, 1.0],
[100.0, 1.0],
[100.0, 0.0]
],
[
[100.2, 0.2],
[100.8, 0.2],
[100.8, 0.8],
[100.2, 0.8],
[100.2, 0.2]
]
]
}
多點(diǎn)
多點(diǎn)的坐標(biāo)是位置數(shù)組:
{
"type": "MultiPoint",
"coordinates":
[
[100.0, 0.0],
[101.0, 1.0]
]
}
多線
多線的坐標(biāo)是線坐標(biāo)數(shù)組的數(shù)組:
{
"type": "MultiLineString",
"coordinates":
[
[
[100.0, 0.0],
[101.0, 1.0]
],
[
[102.0, 2.0],
[103.0, 3.0]
]
]
}
多面
多面的坐標(biāo)是面坐標(biāo)數(shù)組的數(shù)組:
{
"type": "MultiPolygon",
"coordinates":
[
[
[
[102.0, 2.0],
[103.0, 2.0],
[103.0, 3.0],
[102.0, 3.0],
[102.0, 2.0]
]
],
[
[
[100.0, 0.0],
[101.0, 0.0],
[101.0, 1.0],
[100.0, 1.0],
[100.0, 0.0]
],
[
[100.2, 0.2],
[100.8, 0.2],
[100.8, 0.8],
[100.2, 0.8],
[100.2, 0.2]
]
]
]
}
幾何集合
幾何集合的幾何數(shù)組里的每個(gè)元素都是上面所描述的幾何對(duì)象之一:
{
"type": "GeometryCollection",
"geometries":
[
{
"type": "Point",
"coordinates": [100.0, 0.0]
},
{
"type": "LineString",
"coordinates":
[
[101.0, 0.0],
[102.0, 1.0]
]
}
]
}