stephenrjones / mediaq-clipy

MediaQ API Client (Python)

Requirements.

Python 2.7 and later.

Installation

You can install the bindings via Setuptools.

python setup.py install

Or you can install from Github via pip:

pip install git+https://github.com/ubriela/mediaq-clipy.git

Tutorial

To use the bindings, import the pacakge:

import SwaggerMediaq as sm

Create geoq client api

geoq = sm.GeoqApi(sm.ApiClient("http://mediaq.usc.edu/MediaQ_MVC_V3/api"))

Returns a set of video locations in GEOJSON format (small sample data)

print geoq.sample_videos()
# http://mediaq.usc.edu/MediaQ_MVC_V3/api/geoq/sample_videos

Returns a set of video frames (of a particular video) in GEOJSON format (small sample data)

print geoq.sample_fovs()
# http://mediaq.usc.edu/MediaQ_MVC_V3/api/geoq/sample_fovs

Create geoq client with API key, replace KEY_VALUE by actual one

geoq = sm.GeoqApi(sm.ApiClient("http://mediaq.usc.edu/MediaQ_MVC_V3/api", "X-API-KEY", "KEY_VALUE"))

Returns a set of video locations

print geoq.rectangle_query(swlat=34.019972,swlng=-118.291588,nelat=34.021111,nelng=-118.287125)
# http://mediaq.usc.edu/MediaQ_MVC_V3/api/geoq/rectangle_query?swlat=34.019972&swlng=-118.291588&nelat=34.021111&nelng=-118.287125&X-API-KEY=REAL_KEY

Returns a set of video frames

print geoq.video_metadata("sydzjysc7s36_2014_4_15_Videotake_1397518537455.mp4")
# http://mediaq.usc.edu/MediaQ_MVC_V3/api/geoq/video_metadata?videoid=sydzjysc7s36_2014_4_15_Videotake_1397518537455.mp4&X-API-KEY=REAL_KEY

Test

You can download test file here ./test/geoq_test.py