NAME

SYNOPSIS

    use Geo::JSON;
    
    my $obj = Geo::JSON->from_json( $json );
    
    $obj->to_json();

DESCRIPTION

Currently supports 2 or 3 dimensions (longitude, latitude, altitude). Further dimensions in positions are ignored for calculations and comparisons, but will be read-from and written-to.

GEOJSON SPECIFICATION

GEOJSON MEMBERS (ATTRIBUTES)

• "type"

  Determines the object the json will be turned into

• "position"

  Not explicitly named in the json, but an array of at least two numbers representing a location in x, y, z order (either Easting, Northing, Altitude or Longitude, Latitude, Altitude as appropriate).

  Additional numbers may be present but ignored by this package for calculations.

• "coordinates"

  Defined in geometry objects (Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon). Will consist of a single position (Point), an array of positions (MultiPoint, LineString), an array of arrays of positions (MultiLineString, Polygon) or an array of arrays of arrays of positions (MultiPolygon). The positions within a single object should all have the same number of axes and be in the same axis order.

• "bbox"

  Optional, defining a bounding box that the position(s) are contained by.

  The box is defined by a array of 2*n items, where n is the number of dimensions in a position. The items are the lowest value for an axis followed by the highest value for an axis, in the axis order used in the positions.

  The Co-ordinates Reference System for the bounding box is assumed to match that of the object.

• "crs"

  Optional, defining the Co-ordinates Reference System the object is using. See Geo::JSON::CRS for more details.

GEOMETRY OBJECTS

• Geo::JSON::Point

  A single position

• Geo::JSON::MultiPoint

  An array of positions, representing multiple points

• Geo::JSON::LineString

  An array of 2 or more positions, represening a connected line

• Geo::JSON::MultiLineString

  An array of lines

• Geo::JSON::Polygon

  An array of lines, defining a polygon. The first line represents the outside of the polygon, subsequent lines define any 'holes'. The lines must be 'linear rings' - 4 or more points, with the first and last points being equivalent.

• Geo::JSON::MultiPolygon

  An array of polygons

• Geo::JSON::GeometryCollection

  An array of any of the above Geometry objects (as attribute "geometries")

FEATURE OBJECTS

•

Geo::JSON::Feature

Any of the above objects (as attribute "feature"), together with a data structure (as attruibute "properties")

FEATURE COLLECTION OBJECTS

•

Geo::JSON::FeatureCollection

An array of Feature objects (as attribute "features")

METHODS

    my $obj = Geo::JSON->from_json( $json );

    $obj->to_json();
    $obj->to_json( $codec );

    my $obj = Geo::JSON->load( { type => 'Point', coordinates => ... } );

CLASS METHODS

    Geo::JSON->codec->canonical(1)->pretty;
    
    my $prev_codec = Geo::JSON->codec($new_codec);

THANKS

SEE ALSO

•

Geo::JSON::Simple - simple interface to create Geo::JSON objects.

SUPPORT

  git clone https://github.com/mjemmeson/Geo-JSON.git

AUTHOR

COPYRIGHT AND LICENSE

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.