A Python client library for the Insight API.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
skywiseinsight
tests
.travis.yml
CHANGES
README.md
requirements.txt
setup.py
test-requirements.txt

README.md

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"
   }
}