rfc-8142

GeoJSON Text Sequences

S. Gillies
date2017-04 streamIETF areaart wggeojson statusPROPOSED STANDARD pages5 canonicalhttps://www.rfc-editor.org/rfc/rfc8142 doi10.17487/RFC8142
This document describes the GeoJSON text sequence format and "application/geo+json-seq" media type. This format is based on JavaScript Object Notation (JSON) text sequences and GeoJSON, and it makes arbitrarily large geographic datasets incrementally parseable without restricting the form of GeoJSON texts within a sequence.

Extracted elements (9)

design-rationale §1

GeoJSON text sequences exist to solve the problem of arbitrarily large geographic datasets (tens of thousands or millions of features) that are impractical to represent as a single GeoJSON FeatureCollection because they cannot be parsed incrementally.

json

design-rationale §4

Using the ASCII RS character (0x1e) as a record delimiter means producers and parsers need not enforce a canonical form of GeoJSON; any valid GeoJSON, pretty-printed or compact, can appear in a sequence.

json

interoperability-note §4

GeoJSON text sequences containing compact GeoJSON texts with no internal newlines are more interoperable with existing non-standardized newline-delimited JSON parsers deployed on the internet.

json

interoperability-note §4

In distributed systems where message ordering and exactly-once delivery are hard to guarantee, GeoJSON text sequences that do not rely on text ordering for extra semantics are more interoperable than those that do.

json

normative-requirement §2 MUST

Each JSON text in a GeoJSON text sequence MUST contain a single GeoJSON object as defined in RFC 7946.

json

protocol-element §2

A GeoJSON text sequence is any number of GeoJSON texts, each encoded in UTF-8, preceded by one ASCII record separator (RS, 0x1e) character, and followed by a line feed (LF). It conforms to all rules of RFC 7464 (JSON text sequences).

json

protocol-element §2

Heterogeneous sequences containing a mix of GeoJSON Geometry, Feature, and FeatureCollection objects are permitted within a single GeoJSON text sequence.

json

registry §5

IANA registered the MIME media type 'application/geo+json-seq' in the Media Types registry for use with GeoJSON text sequences, using the structured syntax suffix established in RFC 8091.

registry, json

security-consideration §3

GeoJSON text sequences have no security considerations beyond those of JSON text sequences (RFC 7464) and the GeoJSON format (RFC 7946).

security, json