Offcial Ziptastic Java Library (ALPHA)

Index

1. Ziptastic Object

• Introduction
• Documentation
• Usage Examples

###Ziptastic Object

####Introduction

• The Ziptastic Object class is designed to offer a Java developer instant access to the Ziptastic API Service. This is done by encapsulating both Reverse and Forward Geocoding processes within the Ziptastic object and storing results from the request in an easy to access format.

####Documentation

#####Constructor Summary Constructor | Description -------|------------ Ziptastic(String apiKey) | Creates an empty Ziptastic object with the Ziptastic API Key value.

#####Method Summary

####Usage Examples####

• Forward Geocoding

  Ziptastic zipObj = new Ziptastic(apiKey);
  String result = zipObj.GetFromZipcode(zipcode);
  System.out.println(result);
  

• Reverse Geocoding

  Ziptastic zipObj = new Ziptastic(apiKey);
  String result = zipObj.GetFromLongLat(longitude, latitude, radius);
  System.out.println(result);
  

####Sample Output####

• Invalid Key Request

  {
  	"message": "API Key Invalid."
  }
  

• Valid Key Request

  [
      {
          "city": "Owosso",
          "geohash": "dpshsfsytw8k",
          "country": "US",
          "county": "Shiawassee",
          "state": "Michigan",
          "state_short": "MI",
          "postal_code": "48867",
          "latitude": 42.9934,
          "longitude": -84.1595,
          "timezone": "America/Detroit"
      }
  ]  	
  

####Maven Plugins####

• Checkstyle : http://checkstyle.sourceforge.net/
• PMD : https://pmd.github.io/

####Future Work####

• Add more tests.
• Expand on java implementation of Ziptastic object.