1.. _vector.geojsonseq:
2
3GeoJSONSeq: sequence of GeoJSON features
4========================================
5
6.. versionadded:: 2.4
7
8.. shortname:: GeoJSONSeq
9
10.. built_in_by_default::
11
12This driver implements read/creation support for features encoded
13individually as `GeoJSON <http://geojson.org/>`__ Feature objects,
14separated by newline (LF) (`Newline Delimited
15JSON <http://ndjson.org/>`__) or record-separator (RS) characters (`RFC
168142 <https://tools.ietf.org/html/rfc8142>`__ standard: GeoJSON Text
17Sequences)
18
19Such files are equivalent to a GeoJSON FeatureCollection, but are more
20friendly for incremental parsing.
21
22Driver capabilities
23-------------------
24
25.. supports_create::
26
27.. supports_georeferencing::
28
29.. supports_virtualio::
30
31Datasource
32----------
33
34The driver accepts three types of sources of data:
35
36-  Uniform Resource Locator (`URL <http://en.wikipedia.org/wiki/URL>`__)
37   - a Web address to perform
38   `HTTP <http://en.wikipedia.org/wiki/HTTP>`__ request
39-  Plain text file with GeoJSON data - identified from the file
40   extension .geojsonl or .geojsons
41-  Text passed directly as filename, and encoded as GeoJSON sequences
42
43The URL/filename/text might be prefixed with GeoJSONSeq: to avoid any
44ambiguity with other drivers.
45
46Layer creation options
47----------------------
48
49-  **RS**\ =YES/NO: whether to start records with the RS=0x1E character,
50   so as to be compatible with the `RFC
51   8142 <https://tools.ietf.org/html/rfc8142>`__ standard. Defaults to
52   NO, unless the filename extension is "geojsons"
53-  **COORDINATE_PRECISION** = int_number: Maximum number of figures
54   after decimal separator to write in coordinates. Default to 7.
55   "Smart" truncation will occur to remove trailing zeros.
56-  **SIGNIFICANT_FIGURES** = int_number: Maximum number of significant
57   figures when writing floating-point numbers. Default to 17. If
58   explicitly specified, and COORDINATE_PRECISION is not, this will also
59   apply to coordinates.
60-  **ID_FIELD**\ =string. Name of the source field that must be written
61   as the 'id' member of Feature objects.
62-  **ID_TYPE**\ =AUTO/String/Integer. Type of the 'id' member of Feature
63   objects.
64
65See Also
66--------
67
68-  :ref:`GeoJSON driver <vector.geojson>`
69-  `RFC 7946 <https://tools.ietf.org/html/rfc7946>`__ standard: the
70   GeoJSON Format.
71-  `RFC 8142 <https://tools.ietf.org/html/rfc8142>`__ standard: GeoJSON
72   Text Sequences (RS separator)
73-  `Newline Delimited JSON <http://ndjson.org/>`__
74-  `GeoJSONL <https://www.interline.io/blog/geojsonl-extracts/>`__: An
75   optimized format for large geographic datasets
76