Michael Jemmeson > Geo-JSON-0.006 > Geo::JSON

Download:
Geo-JSON-0.006.tar.gz

Dependencies

Annotate this POD

Website

View/Report Bugs
Module Version: 0.006   Source  

NAME ^

Geo::JSON - Perl OO interface for geojson

VERSION ^

version 0.006

SYNOPSIS ^

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

DESCRIPTION ^

Convert to and from geojson using Perl objects. GeoJSON objects represent various geographical positions - points, lines, polygons, etc.

Currently in development - feedback welcome.

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 ^

See: http://www.geojson.org/geojson-spec.html

GEOJSON MEMBERS (ATTRIBUTES) ^

See the specification for the full details, but the basics are as follows:

GEOMETRY OBJECTS ^

FEATURE OBJECTS ^

FEATURE COLLECTION OBJECTS ^

METHODS ^

from_json

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

Takes a geojson string, returns the object it represents.

to_json

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

Call on a Geo::JSON object. Returns the JSON that represents the object.

Pass in an optional JSON codec to modify the default behaviour of the JSON returned.

load

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

Creates a Geo::JSON object from a hashref.

This is used for coercion of attributes during object creation, and probably should not be called directly otherwise.

CLASS METHODS ^

codec

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

Set options on or replace JSON codec.

THANKS ^

Tim Bunce - for codec suggestions and bug spotting.

SEE ALSO ^

SUPPORT ^

Bugs / Feature Requests

Please report any bugs or feature requests through the issue tracker at https://github.com/mjemmeson/Geo-JSON/issues. You will be notified automatically of any progress on your issue.

Source Code

This is open source software. The code repository is available for public review and contribution under the terms of the license.

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

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

AUTHOR ^

Michael Jemmeson <mjemmeson@cpan.org>

COPYRIGHT AND LICENSE ^

This software is copyright (c) 2013 by Michael Jemmeson <mjemmeson@cpan.org>.

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

syntax highlighting: