GeoJSON格式规范说明

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

1.简介

GeoJSON 是一种对各种地理数据结构进行编码的格式。GeoJSON 对象可以表示几何、特征或者特征集合。GeoJSON 支持下面几何类型:点、线、面、多点、多线、多面和几何集合。GeoJSON 里的特征包含一个几何对象和其他属性,特征集合表示一系列特征。

一个完整的 GeoJSON 数据结构总是一个(JSON 术语里的)对象。在 GeoJSON 里,对象由 名/值对(name/value pair)——也称作成员的集合组成。对每个成员来说,名称总是字符串。成员的值要么是字符串、数字、对象、数组,要么是下面文本常量中的一个:true, falsenull。数组由元素(element)组成,其中每个元素都是如上所述的值。

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 对象表示和术语对象、名字、值、数组和数字在 IETF RFC 4627 即 IETF RFC 4627 里定义。

  • 这篇文档里的关键字“必须“,”不允许“,”需要“,”应当“,”应当不“,”应该“,”不应该“,”推荐的“,”也许“和”可选的“在 IETF RFC 2119, 即 IETF RFC 2119 里解释。

2.GeoJSON 对象

2.1 几何对象

几何是一种 GeoJSON 对象,这时 type 成员的值是下面字符串之一:"Point", "MultiPoint", "LineString", "MultiLineString", "Polygon", "MultiPolygon", 或者"GeometryCollection"
除了“GeometryCollection”外的其他任何类型的 GeoJSON 几何对象必须由一个名字为 "coordinates" 的成员。coordinates 成员的值总是数组。这个数组里的元素的结构由几何类型来确定。

2.1.1 位置

位置是基本的几何结构。几何对象的 "coordinates" 成员由一个位置(这儿是几何点)、位置数组(线或者几何多点),位置数组的数组(面、多线)或者位置的多维数组(多面)组成。

位置由数字数组表示。必须至少两个元素,可以有更多元素。元素的顺序必须遵从x,y,z顺序(投影坐标参考系统中坐标的东向、北向、高度或者地理坐标参考系统中的坐标长度、纬度、高度)。任何数目的其他元素是允许的---其他元素的说明和意义超出了这篇规格说明的范围。

位置和几何的例子在附录A.几何例子里呈现。

2.1.2 点

对类型Point来说,coordinates 成员必须是一个单独的 position

2.1.3 多点

对类型 MultiPoint 来说,coordinates 成员必须是 position 数组

2.1.4 线

对类型 LineString 来说,coordinates 成员必须是 MultPoint 数组
LinearRing (线性环) 是具有4个或者更多 position 的封闭的线。第一个最后一个位置是相等的(它们表示相同的的点)。虽然 LinearRing (线性环) 没有鲜明地作为 GeoJSON 几何类型,不过在面几何类型(Polygon)定义里有提到它。

2.1.5 多线

对类型 MultiLineString 来说,coordinates 成员必须是一个 LineString 数组

2.1.6 面

对类型 Polygon 来说,coordinates 成员必须是一个 LinearRing 数组。对拥有多个 LinearRing (线性环) 的面来说,第一个环必须是外部环,其他的必须是内部环或者孔。

2.1.7 多面

对类型 MultiPlygon 来说,coordinates 成员必须是 Polygon 数组

2.1.8 几何集合

类型为 GeometryCollection 的 GeoJSON 对象是一个集合对象,它表示几何对象 (geometry objects) 的集合。

几何集合必须有一个名字为 geometries 的成员。与 geometries 相对应的值是一个数组。这个数组中的每个元素都是一个 GeoJSON 几何对象。

2.2 特征对象

类型为 "Feature" 的 GeoJSON 对象是特征对象。

  • 特征对象必须由一个名字为 "geometry" 的成员,这个几何成员的值是上面定义的几何对象或者 JSON 的 null 值。

  • 特征对戏那个必须有一个名字为 "properties" 的成员,这个属性成员的值是一个对象(任何 JSON 对象或者 JSON 的 null 值)。

  • 如果特征是常用的标识符,那么这个标识符应当包含名字为 “id” 的特征对象成员。

2.3 特征集合对象

类型为 "FeatureCollection" 的 GeoJSON 对象是特征集合对象。

类型为 "FeatureCollection" 的对象必须由一个名字为 "features" 的成员。与 “features" 相对应的值是一个数组。这个数组中的每个元素都是上面定义的特征对象。

3.坐标参考系统对象

GeoJSON 对象的坐标参考系统(CRS)是由它的 "crs" 成员(指的是下面的 CRS 对象)来确定的。如果对象没有 crs 成员,那么它的父对象或者祖父对象的 crs 成员可能被获取作为它的 crs。如果这样还没有获得 crs 成员,那么默认的 CRS 将应用到 GeoJSON 对象。

  • 默认的 CRS 是地理坐标参考系统,使用的是 WGS84 数据,长度和高度的单位是十进制标示。
  • 名字为 "crs" 成员的值必须是 JSON 对象(指的是下面的 CRS 对象)或者 JSON 的 null。如果 CRS 的值为 null,那么就假设没有 CRS 了。
  • crs 成员应当位于(特征集合、特征、几何的顺序的)层级结构里 GeoJSON 对象的最顶级,而且在自对象或者孙子对象里不应该重复或者覆盖。
  • 非空的 CRS 对象有两个强制拥有的对象:"type" 和 "properties"。
  • type 成员的值必须是字符串,这个字符串说明了 CRS 对象的类型。
  • 属性成员的值必须是对象。
  • CRS 应不能更改坐标顺序。

3.1 名字 CRS

CRS 对象可以通过名字来表明坐标参考系统。在这种情况下,它的 "type" 成员的值必须是字符串 "name"。它的 "properties" 成员的值必须是包含 "name" 成员的对象。这个 "name" 成员的值必须是标识坐标参考系统的字符串。比如 "urn:ogc:def:crs:OGC:1.3:CRS84" 的 OGC CRS 的 URN 应当优先于旧的标识符如 "EPSG:4326" 得到选用:

"crs": {
    "type": "name",
    "properties": {
        "name": "urn:ogc:def:crs:OGC:1.3:CRS84"
    }

3.2 连接 CRS

CRS 对象也可以连接到互联网上的 CRS 参数。在这种情况下,它的 "type" 成员的值必须是字符串 "link",它的 "properties" 成员的值必须是一个连接对象 。

3.2.1 连接对象

连接对象由一个必需的成员:"href",和一个可选的成员:"type"。

必需的 "href" 成员的值必须是解引用的 URI(统一资源标识)。

可选的 "type" 成员的值必须是字符串,而且这个字符串暗示了所提供的 URI 里用来表示 CRS 参数的格式。建议值是:"proj4","ogcwkt",esriwkt",不过可以使用其他值:

"crs": {
    "type": "link",
    "properties": {
        "href": "http://example.com/crs/42",
        "type": "proj4"
    }
}

相对连接常常可以作为辅助文件里的 CRS 的直接处理器:

"crs": {
    "type": "link",
    "properties": {
        "href": "data.crs",
        "type": "ogcwkt"
    }
}

4.边界框

为了包含几何、特征或者特征集合的坐标范围信息,GeoJSON 对象可能有一个名字为 bbox 的成员。bbox 成员的值必须是 2*n 数组,这儿 n 是所包含几何对象的维数,并且所有坐标轴的最低值后面跟着最高者值。bbox 的坐标轴的顺序遵循几何坐标轴的顺序。除此之外,bbox 的坐标参考系统假设匹配它所在 GeoJSON 对象的坐标参考系统。

特征对象上的 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]
            ]
        ]
    }
  ...
}

特征集合对象 bbox 成员的例子:

{
    "type": "FeatureCollection",
    "bbox": [100.0, 0.0, 105.0, 1.0],
    "features": [
    ...
    ]
}

附录A.集合例子

下面例子中的每一个都表示一个完整的 GeoJSON 对象。注意 JSON 对象里的结尾的空白字符没有意义。例子里所用的空白符有助于说明这个数据结构,不过不是必需的。

点坐标是按照 x,y 顺序的(投影坐标的东向、北向,地理坐标的长度、高度):

{
    "type": "Point",
    "coordinates": [100.0, 0.0]
}

线

线的坐标是位置数组:

{
    "type": "LineString",
    "coordinates": 
    [
        [100.0, 0.0],
        [101.0, 1.0]
    ]
}

面的坐标是线性环坐标数组的数组。这个数组的第一个元素表示的是外部环。其他后续的元素表示的内部环(或者孔)。

没有孔的:

{
    "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] 
        ]
    ]
}

多点

多点的坐标是位置数组:

{
    "type": "MultiPoint",
    "coordinates": 
    [
        [100.0, 0.0],
        [101.0, 1.0]
    ]
}

多线

多线的坐标是线坐标数组的数组:

{
    "type": "MultiLineString",
    "coordinates": 
    [
        [ 
            [100.0, 0.0], 
            [101.0, 1.0] 
        ],
        [ 
            [102.0, 2.0], 
            [103.0, 3.0] 
        ]
    ]
}

多面

多面的坐标是面坐标数组的数组:

{
    "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]
            ]
        ]
    ]
}

几何集合

几何集合的几何数组里的每个元素都是上面所描述的几何对象之一:

{
    "type": "GeometryCollection",
    "geometries": 
    [
        {
            "type": "Point",
            "coordinates": [100.0, 0.0]
        },
        {
            "type": "LineString",
            "coordinates": 
            [
                [101.0, 0.0],
                [102.0, 1.0]
            ]
        }
    ]
}
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,839评论 6 482
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,543评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 153,116评论 0 344
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,371评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,384评论 5 374
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,111评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,416评论 3 400
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,053评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,558评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,007评论 2 325
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,117评论 1 334
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,756评论 4 324
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,324评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,315评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,539评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,578评论 2 355
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,877评论 2 345

推荐阅读更多精彩内容