| RCMET Client API Web Service README |
| =========================================================== |
| |
| Prerequisites: |
| |
| * Python 2.6+ with easy_install |
| * Bottle (http://bottlepy.org) Web Framework |
| |
| Usage: |
| |
| ./python main_ws.py |
| |
| |
| Hints: |
| |
| Changing the port Bottle runs on |
| -------------------------------- |
| The port Bottle starts up on can be changed by editing |
| the last line in the ./main_ws.py file as follows: |
| |
| if __name__ == "__main__": |
| run(host='localhost', port=*NEWPORT*) |
| |
| |
| API Documentation: |
| ================================================================= |
| |
| Extract Model File Variables |
| -------------------------------- |
| http://<webserviceUrl>/list/vars/"<PATH>" |
| |
| INPUTS: |
| PATH: the fully qualified path to the model file to use. Note |
| that the path must be enclosed in double quotes. |
| |
| RETURN: |
| SUCCESS: {"variables": ["tas", "level", "lon", "time", "lat"]} |
| FAILURE: [] <-- should probably be {} |
| |
| |
| Extract Model Latitude and Longitude Variables and Bounds |
| --------------------------------------------------------- |
| http://<webserviceUrl>/list/latlon/"<PATH>" |
| |
| INPUTS: |
| PATH: the fully qualified path to the model file to use. Note |
| that the path must be enclosed in double quotes. |
| |
| RETURN: |
| SUCCESS: {"latMax": "42.24", "success": 1, "latname": "lat", |
| "lonMax": "60.28", "lonMin": "-24.64", |
| "lonname": "lon", "latMin": "-45.76"} |
| FAILURE: ? |
| |
| |
| Extract Model Time Variable and Bounds |
| -------------------------------------- |
| http://<webserviceUrl>/list/time/"<PATH>" |
| |
| INPUTS: |
| PATH: the fully qualified path to the model file to use. Note |
| that the path must be enclosed in double quotes. |
| |
| RETURN: |
| SUCCESS: {"start_time": "1989-01-15 00:00:00", |
| "timename": "time", "success": 1, |
| "end_time": "2008-12-15 00:00:00"} |
| FAILURE: ? |