parse<T extends Geometry> static method

GeometryCollection<T> parse<T extends Geometry>(
  1. String text, {
  2. TextReaderFormat<GeometryContent> format = GeoJSON.geometry,
  3. CoordRefSys? crs,
  4. Map<String, dynamic>? options,
})

Parses a geometry collection with elements of T from text conforming to format.

When format is not given, then the geometry format of GeoJSON is used as a default.

Use crs to give hints (like axis order, and whether x and y must be swapped when read in) about coordinate reference system in text input. When data itself have CRS information it overrides this value.

Format or decoder implementation specific options can be set by options.

Examples:

GeometryCollection.parse(
  format: GeoJSON.geometry,
  '''
  {
    "type": "GeometryCollection",
    "geometries": [
      {"type": "Point", "coordinates": [10.0, 20.0]},
      {"type": "Point", "coordinates": [10.0, 20.0, 30.0]},
      {"type": "LineString",
        "coordinates": [
          [10.0, 20.0, 30.0],
          [12.5, 22.5, 32.5],
          [15.0, 25.0, 35.0]
        ]
      }
    ]
  }
  ''',
);

GeometryCollection.parse(
  format: WKT.geometry,
  '''
  GEOMETRYCOLLECTION (
    POINT (10.0 20.0),
    POINT Z (10.0 20.0 30.0),
    LINESTRING Z (
      (10.0 20.0 30.0),
      (12.5 22.5 32.5),
      (15.0 25.0 35.0)
    )
  )
  ''',
);

Implementation

static GeometryCollection<T> parse<T extends Geometry>(
  String text, {
  TextReaderFormat<GeometryContent> format = GeoJSON.geometry,
  CoordRefSys? crs,
  Map<String, dynamic>? options,
}) =>
    GeometryBuilder.parseCollection<T>(
      text,
      format: format,
      crs: crs,
      options: options,
    );