MultiLineString (kits-geojson API)

java.lang.Object
- ai.nextbillion.kits.geojson.MultiLineString

All Implemented Interfaces:

CoordinateContainer<java.util.List<java.util.List<Point>>>, GeoJson, Geometry, java.io.Serializable
```
public final class MultiLineString
extends java.lang.Object
implements CoordinateContainer<java.util.List<java.util.List<Point>>>
```
A multilinestring is an array of LineString coordinate arrays.
This adheres to the RFC 7946 internet standard when serialized into JSON. When deserialized, this class becomes an immutable object which should be initiated using its static factory methods.
When representing a LineString that crosses the antimeridian, interoperability is improved by modifying their geometry. Any geometry that crosses the antimeridian SHOULD be represented by cutting it in two such that neither part's representation crosses the antimeridian.
For example, a line extending from 45 degrees N, 170 degrees E across the antimeridian to 45 degrees N, 170 degrees W should be cut in two and represented as a MultiLineString.
A sample GeoJson MultiLineString's provided below (in it's serialized state).
```
 {
   "type": "MultiLineString",
   "coordinates": [
     [
       [100.0, 0.0],
       [101.0, 1.0]
     ],
     [
       [102.0, 2.0],
       [103.0, 3.0]
     ]
   ]
 }
 
```
Look over the LineString documentation to get more information about formatting your list of linestring objects correctly.
See Also:

Serialized Form

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`BoundingBox`	`bbox()` A Feature Collection might have a member named `bbox` to include information on the coordinate range for it's `Feature`s.
`java.util.List<java.util.List<Point>>`	`coordinates()` Provides the list of list of `Point`s that make up the MultiLineString geometry.
`boolean`	`equals(java.lang.Object obj)`
`static MultiLineString`	`fromJson(java.lang.String json)` Create a new instance of this class by passing in a formatted valid JSON String.
`static MultiLineString`	`fromLineString(LineString lineString)` Create a new instance of this class by passing in a single `LineString` object.
`static MultiLineString`	`fromLineString(LineString lineString, BoundingBox bbox)` Create a new instance of this class by passing in a single `LineString` object.
`static MultiLineString`	`fromLineStrings(java.util.List<LineString> lineStrings)` Create a new instance of this class by defining a list of `LineString` objects and passing that list in as a parameter in this method.
`static MultiLineString`	`fromLineStrings(java.util.List<LineString> lineStrings, BoundingBox bbox)` Create a new instance of this class by defining a list of `LineString` objects and passing that list in as a parameter in this method.
`static MultiLineString`	`fromLngLats(java.util.List<java.util.List<Point>> points)` Create a new instance of this class by defining a list of a list of `Point`s which follow the correct specifications described in the Point documentation.
`static MultiLineString`	`fromLngLats(java.util.List<java.util.List<Point>> points, BoundingBox bbox)` Create a new instance of this class by defining a list of a list of `Point`s which follow the correct specifications described in the Point documentation.
`int`	`hashCode()`
`java.util.List<LineString>`	`lineStrings()` Returns a list of LineStrings which are currently making up this MultiLineString.
`java.lang.String`	`toJson()` This takes the currently defined values found inside this instance and converts it to a GeoJson string.
`java.lang.String`	`toString()`
`java.lang.String`	`type()` This describes the TYPE of GeoJson geometry this object is, thus this will always return `MultiLineString`.
`static com.google.gson.TypeAdapter<MultiLineString>`	`typeAdapter(com.google.gson.Gson gson)` Gson type adapter for parsing Gson to this class.

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Method Detail
  - fromJson
```
public static MultiLineString fromJson(@NonNull
                                       java.lang.String json)
```
    Create a new instance of this class by passing in a formatted valid JSON String. If you are creating a MultiLineString object from scratch it is better to use one of the other provided static factory methods such as fromLineStrings(List).
    
    Parameters:
    
    json - a formatted valid JSON string defining a GeoJson MultiLineString
    
    Returns:
    
    a new instance of this class defined by the values passed inside this static factory method
  - fromLineStrings
```
public static MultiLineString fromLineStrings(@NonNull
                                              java.util.List<LineString> lineStrings)
```
    Create a new instance of this class by defining a list of LineString objects and passing that list in as a parameter in this method. The LineStrings should comply with the GeoJson specifications described in the documentation.
    
    Parameters:
    
    lineStrings - a list of LineStrings which make up this MultiLineString
    
    Returns:
    
    a new instance of this class defined by the values passed inside this static factory method
  - fromLineStrings
```
public static MultiLineString fromLineStrings(@NonNull
                                              java.util.List<LineString> lineStrings,
                                              @Nullable
                                              BoundingBox bbox)
```
    Create a new instance of this class by defining a list of LineString objects and passing that list in as a parameter in this method. The LineStrings should comply with the GeoJson specifications described in the documentation. Optionally, pass in an instance of a BoundingBox which better describes this MultiLineString.
    
    Parameters:
    
    lineStrings - a list of LineStrings which make up this MultiLineString
    
    bbox - optionally include a bbox definition
    
    Returns:
    
    a new instance of this class defined by the values passed inside this static factory method
  - fromLineString
```
public static MultiLineString fromLineString(@NonNull
                                             LineString lineString)
```
    Create a new instance of this class by passing in a single LineString object. The LineStrings should comply with the GeoJson specifications described in the documentation.
    
    Parameters:
    
    lineString - a single LineString which make up this MultiLineString
    
    Returns:
    
    a new instance of this class defined by the values passed inside this static factory method
  - fromLineString
```
public static MultiLineString fromLineString(@NonNull
                                             LineString lineString,
                                             @Nullable
                                             BoundingBox bbox)
```
    Create a new instance of this class by passing in a single LineString object. The LineStrings should comply with the GeoJson specifications described in the documentation.
    
    Parameters:
    
    lineString - a single LineString which make up this MultiLineString
    
    bbox - optionally include a bbox definition
    
    Returns:
    
    a new instance of this class defined by the values passed inside this static factory method
  - fromLngLats
```
public static MultiLineString fromLngLats(@NonNull
                                          java.util.List<java.util.List<Point>> points)
```
    Create a new instance of this class by defining a list of a list of Points which follow the correct specifications described in the Point documentation. Note that there should not be any duplicate points inside the list and the points combined should create a LineString with a distance greater than 0.
    
    Parameters:
    
    points - a list of Points which make up the MultiLineString geometry
    
    Returns:
    
    a new instance of this class defined by the values passed inside this static factory method
  - fromLngLats
```
public static MultiLineString fromLngLats(@NonNull
                                          java.util.List<java.util.List<Point>> points,
                                          @Nullable
                                          BoundingBox bbox)
```
    Create a new instance of this class by defining a list of a list of Points which follow the correct specifications described in the Point documentation. Note that there should not be any duplicate points inside the list and the points combined should create a LineString with a distance greater than 0.
    
    Parameters:
    
    points - a list of Points which make up the MultiLineString geometry
    
    bbox - optionally include a bbox definition
    
    Returns:
    
    a new instance of this class defined by the values passed inside this static factory method
  - type
```
@NonNull
public java.lang.String type()
```
    This describes the TYPE of GeoJson geometry this object is, thus this will always return MultiLineString.
    
    Specified by:
    
    type in interface GeoJson
    
    Returns:
    
    a String which describes the TYPE of geometry, for this object it will always return MultiLineString
  - bbox
```
@Nullable
public BoundingBox bbox()
```
    A Feature Collection might have a member named bbox to include information on the coordinate range for it's Features. The value of the bbox member MUST be a list of size 2*n where n is the number of dimensions represented in the contained feature geometries, with all axes of the most southwesterly point followed by all axes of the more northeasterly point. The axes order of a bbox follows the axes order of geometries.
    
    Specified by:
    
    bbox in interface GeoJson
    
    Returns:
    
    a list of double coordinate values describing a bounding box
  - coordinates
```
@NonNull
public java.util.List<java.util.List<Point>> coordinates()
```
    Provides the list of list of Points that make up the MultiLineString geometry.
    
    Specified by:
    
    coordinates in interface CoordinateContainer<java.util.List<java.util.List<Point>>>
    
    Returns:
    
    a list of points
  - lineStrings
```
public java.util.List<LineString> lineStrings()
```
    Returns a list of LineStrings which are currently making up this MultiLineString.
    
    Returns:
    
    a list of LineStrings
  - toJson
```
public java.lang.String toJson()
```
    This takes the currently defined values found inside this instance and converts it to a GeoJson string.
    
    Specified by:
    
    toJson in interface GeoJson
    
    Returns:
    
    a JSON string which represents this MultiLineString geometry
  - typeAdapter
```
public static com.google.gson.TypeAdapter<MultiLineString> typeAdapter(com.google.gson.Gson gson)
```
    Gson type adapter for parsing Gson to this class.
    
    Parameters:
    
    gson - the built Gson object
    
    Returns:
    
    the TYPE adapter for this class
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object
  - equals
```
public boolean equals(java.lang.Object obj)
```
    Overrides:
    
    equals in class java.lang.Object
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class java.lang.Object

Class MultiLineString

Method Summary

Methods inherited from class java.lang.Object

Method Detail

fromJson

fromLineStrings

fromLineStrings

fromLineString

fromLineString

fromLngLats

fromLngLats

type

bbox

coordinates

lineStrings

toJson

typeAdapter

toString

equals

hashCode