GeoJSON格式規(guī)范說明

https://geojson.org/geojson-spec.html

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, falsenull辕棚。數(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]
            ]
        }
    ]
}
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市伟姐,隨后出現(xiàn)的幾起案子收苏,更是在濱河造成了極大的恐慌,老刑警劉巖愤兵,帶你破解...
    沈念sama閱讀 206,968評(píng)論 6 482
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件鹿霸,死亡現(xiàn)場離奇詭異,居然都是意外死亡秆乳,警方通過查閱死者的電腦和手機(jī)懦鼠,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,601評(píng)論 2 382
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來屹堰,“玉大人肛冶,你說我怎么就攤上這事〕都” “怎么了睦袖?”我有些...
    開封第一講書人閱讀 153,220評(píng)論 0 344
  • 文/不壞的土叔 我叫張陵,是天一觀的道長荣刑。 經(jīng)常有香客問我馅笙,道長伦乔,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 55,416評(píng)論 1 279
  • 正文 為了忘掉前任董习,我火速辦了婚禮烈和,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘皿淋。我一直安慰自己斥杜,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 64,425評(píng)論 5 374
  • 文/花漫 我一把揭開白布沥匈。 她就那樣靜靜地躺著,像睡著了一般忘渔。 火紅的嫁衣襯著肌膚如雪高帖。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 49,144評(píng)論 1 285
  • 那天畦粮,我揣著相機(jī)與錄音散址,去河邊找鬼。 笑死宣赔,一個(gè)胖子當(dāng)著我的面吹牛预麸,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播儒将,決...
    沈念sama閱讀 38,432評(píng)論 3 401
  • 文/蒼蘭香墨 我猛地睜開眼吏祸,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了钩蚊?” 一聲冷哼從身側(cè)響起贡翘,我...
    開封第一講書人閱讀 37,088評(píng)論 0 261
  • 序言:老撾萬榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎砰逻,沒想到半個(gè)月后鸣驱,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 43,586評(píng)論 1 300
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡蝠咆,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 36,028評(píng)論 2 325
  • 正文 我和宋清朗相戀三年踊东,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片刚操。...
    茶點(diǎn)故事閱讀 38,137評(píng)論 1 334
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡闸翅,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出赡茸,到底是詐尸還是另有隱情缎脾,我是刑警寧澤,帶...
    沈念sama閱讀 33,783評(píng)論 4 324
  • 正文 年R本政府宣布占卧,位于F島的核電站遗菠,受9級(jí)特大地震影響联喘,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜辙纬,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,343評(píng)論 3 307
  • 文/蒙蒙 一豁遭、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧贺拣,春花似錦蓖谢、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,333評(píng)論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至涡匀,卻和暖如春盯腌,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背陨瘩。 一陣腳步聲響...
    開封第一講書人閱讀 31,559評(píng)論 1 262
  • 我被黑心中介騙來泰國打工腕够, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人舌劳。 一個(gè)月前我還...
    沈念sama閱讀 45,595評(píng)論 2 355
  • 正文 我出身青樓帚湘,卻偏偏與公主長得像,于是被迫代替她去往敵國和親甚淡。 傳聞我的和親對(duì)象是個(gè)殘疾皇子大诸,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 42,901評(píng)論 2 345

推薦閱讀更多精彩內(nèi)容