skywise-insight

SkyWise Insight API Python Client Library


License
Other
Install
pip install skywise-insight==1.0.10

Documentation

Build Status

Overview

A Python client library for the SkyWise Insight API. Check out the API docs to reference exposed endpoints. Also check out some examples.

Prerequisites

Windows Users You will most likely need to install gevent beforehand. You can typically find the latest wheel here.

Installation

pip install skywise-insight

Configure App ID/Key

The easiest (and recommended) way to configure authentication to the API is by setting the following environment variables:

SKYWISE_INSIGHT_APP_ID='{YOUR_APP_ID}'
SKYWISE_INSIGHT_APP_KEY='{YOUR_APP_KEY}'

Otherwise, you'll need to set your App ID/Key explicitly in your app/script before making API calls:

from skywiseinsight import InsightResource

InsightResource.set_user('{YOUR_APP_ID}')
InsightResource.set_password('{YOUR_APP_KEY}')

Try It Out

Let's test out our install by requesting the latest Daily Precipitation data for OKC:

import json
from skywiseinsight import DailyPrecipitation as dp

precip = dp.location(35.4, -97.5)
print json.dumps(precip.json())

Your output should look something similar to this:

{
   "startDate":"2016-08-03",
   "endDate":"2016-08-08",
   "series":[
      {
         "validDate":"2016-08-08",
         "value":0.3
      },
      {
         "validDate":"2016-08-07",
         "value":0.1
      },
      {
         "validDate":"2016-08-06",
         "value":0.8
      },
      {
         "validDate":"2016-08-05",
         "value":0.3
      },
      {
         "validDate":"2016-08-04",
         "value":0.1
      },
      {
         "validDate":"2016-08-03",
         "value":0.2
      }
   ],
   "longitude":-97.5,
   "latitude":35.4,
   "precipitation":1.8,
   "unit":{
      "description":"millimeters",
      "label":"mm"
   }
}