Skip to content

Latest commit

 

History

History
55 lines (38 loc) · 1.42 KB

README.md

File metadata and controls

55 lines (38 loc) · 1.42 KB
Raw

#GeoGson

GeoGson is a Gson implementation of the GeoJson specification (with some unofficial object support)

##Types supported

  1. Circle (unofficial support)
  2. Feature
  3. LineString
  4. MultiLineString
  5. Polygon
  6. MultiPolygon
  7. Point
  8. MultiPoint

##Usage with custom gson parsers

In order for the gson to correctly inflate into geojson objects, you must make sure to include the type adapter so that gson can detect and inflate the geojson objects correctly.

GsonBuilder builder = new GsonBuilder();
builder.registerTypeAdapter(GeoJsonObject.class, new GeoJsonObjectAdapter());
builder.registerTypeAdapter(LngLatAlt.class, new LngLatAltAdapter());

You can use the methods found in GeoGson to automatically add these adapters to your builder object, or create a new gson instance with the adapters already added

GeoJson.getGson()
GeoJson.registerAdapters(GsonBuilder builder)

##Example

GsonBuilder builder = new GsonBuilder();
GeoJson.registerAdapters(builder);

GeoJsonObject point = builder.create().fromJson("{ \"type\": \"Point\", \"coordinates\": [100.0, 0.0] }", GeoJsonObject.class);
System.out.println(point instanceof Point);

This will automatically parse the provided JSON string into its correct class (in this case, a point)

##Maven

To include the project, add the following to your build.gradle

compile 'com.3sidedcube.util:GeoGson:1.6'

##License

See LICENSE