Pachube PHP Library functions

Pachube is a web service that enables you to connect, tag and share real time sensor data from objects, devices, buildings and environments around the world. The key aim is to facilitate interaction between remote environments, both physical and virtual.

Create a Pachube object with your API key: "; echo '$pachube = new Pachube($api_key); '; $pachube = new Pachube($api_key); # ***************************************************************** # # working with Environments (returns an associative array) # # ***************************************************************** echo "

Work with an environment (returned as an associative array):
"; $feed_id = 504; $environment = $pachube->environment( $feed_id ); echo '$environment = $pachube->environment( $feed_id ); '; echo "\$environment['description']: ".$environment['description']."
"; echo "\$environment['status']: ".$environment['status']."
"; echo "\$environment['location'][0]['name']: ".$environment['location'][0]['name']."
"; echo "\$environment['location'][0]['lat']: ".$environment['location'][0]['lat']."
"; echo "\$environment['location'][0]['lon']: ".$environment['location'][0]['lon']."
"; echo "\$environment['location'][0]['exposure']: ".$environment['location'][0]['exposure']."
"; echo "count(\$environment['datastreams']): ".count($environment['datastreams'])."
"; echo "\$environment['datastreams']['2']['values'][0]['value']: ".$environment['datastreams']['2']['values'][0]['value']."
"; echo "

Create graphs and maps using the \$environment array:
"; echo '$pachube->showEnvironmentGraph($environment,1); '; $pachube->showEnvironmentGraph($environment,1); echo "
"; echo '$pachube->showEnvironmentGraph($environment,2, 700, 250, "0000FF", false, false, "My configured graph title", "My datastream units", 6); '; $pachube->showEnvironmentGraph($environment,2, 700, 250, "0000FF", false, false, "My configured graph title", "My datastream units", 6); echo "
"; // the following requires you to have a Google Map API key for your domain available here: http://code.google.com/apis/maps/ echo '$pachube->showEnvironmentMap($environment, 500, 200, "GOOGLE_MAP_API_KEY"); '; $pachube->showEnvironmentMap($environment, 500, 200, "ABQIAAAAYGdShHJUqUUqCZujCgqoyxRhf0yX7jCDZEW8LvcORLdH4560mRQtTT3Vx6wORcHDcMrtNf9XNlmO0w"); #/* # ***************************************************************** # # retrieve Pachube feed data # # ***************************************************************** echo "

Retrieve raw feed data via URL (e.g. http://www.pachube.com/api/504.csv [.json | .xml]): "; $url = "http://www.pachube.com/api/504.csv"; $data = $pachube->retrieveData ( $url ); echo '$data = $pachube->retrieveData ($url); '; echo $data; echo "

Retrieve raw feed data as CSV, using feed ID only: "; $feed = 480; $data = $pachube->retrieveData ( $feed, "csv" ); echo '$data = $pachube->retrieveData ( $feed, "csv" ); '; echo $data; echo "

Retrieve raw feed data as JSON, using feed ID only: "; $feed = 480; $data = $pachube->retrieveData ( $feed, "json" ); echo '$data = $pachube->retrieveData ( $feed, "json" ); '; echo "
$data"; echo "

Retrieve raw feed data as EEML, using feed ID only: "; $feed = 480; $data = $pachube->retrieveData ( $feed, "xml" ); echo '$data = $pachube->retrieveData ( $feed, "xml" ); '; echo "
$data"; # ***************************************************************** # # display a graph without loading $environment # # ***************************************************************** echo "

Display a Pachube datastream graph without creating \$environment:
"; $feed_id=504; $datastream_id=1; echo '$pachube->showGraph ( $feed_id, $datastream_id ); '; $pachube->showGraph ( $feed_id, $datastream_id ); # ***************************************************************** # # display a configured graph # # ***************************************************************** echo "

Display a configured Pachube datastream graph without creating \$environment:
"; $feed_id=504; $datastream_id=1; // parameters are showGraph ( $feed_id, $datastream_id, $width, $height, $colour, $label[true/false], $grid[true/false], $title, $legend, $stroke); echo '$pachube->showGraph ( $feed_id, $datastream_id, 500, 300, "00FF00", true, true, "My configured graph title", "My datastream units", 6 ); '; $pachube->showGraph ( $feed_id, $datastream_id, 500, 300, "00FF00", true, true, "My configured graph title", "My datastream units", 6 ); # ***************************************************************** # # create a new Pachube feed # # ***************************************************************** echo "

Create a new manual Pachube feed: "; $title = "new feed from php library final"; echo '$new_feed_id = $pachube->createFeed ( $title ); '; //$new_feed_id = $pachube->createFeed ( $title ); // bad hack, but for the moment unsuccessful attempts to create simply // return their HTTP status code, as a negative number echo $new_feed_id; # ***************************************************************** # # delete a Pachube feed # # ***************************************************************** echo "

Delete a Pachube feed (note this is set to delete the feed we just created): "; echo '$delete_status = $pachube->deletePachube ( $new_feed_id ); '; //$delete_status = $pachube->deletePachube ( $new_feed_id ); //$pachube->debugStatusCode($delete_status); #/* # ***************************************************************** # # update manual feed: CSV # # ***************************************************************** echo "

Update a manual feed with CSV: "; // note that you must own the feed listed below in order to update it! $url = "http://www.pachube.com/api/1666.csv"; $data = "1,3,5"; echo '$update_status = $pachube->updatePachube ( $url, $data ); '; // this next line makes the actual update attempt and returns a status code $update_status = $pachube->updatePachube ( $url, $data ); $pachube->debugStatusCode($update_status); # ***************************************************************** # # update manual feed: EEML # # ***************************************************************** echo "

Update a manual feed with EEML: "; // note that you must own the feed listed below in order to update it! $url = "http://www.pachube.com/api/1666.xml"; echo '$update_status = $pachube->updatePachube ( $url, $data ); '; $data = << new post 48.7 END; $update_status = $pachube->updatePachube ( $url, $data ); $pachube->debugStatusCode($update_status); # ***************************************************************** # # retrieve history data as an array # # ***************************************************************** echo "

Retrieve history data as an array: "; $url = "http://www.pachube.com/feeds/504/datastreams/1/history.csv"; echo '$history = $pachube->retrieveHistory ( $url ); '; $history = $pachube->retrieveHistory ( $url ); print_r ($history); # ***************************************************************** # # Retrieving lat/lon of feeds that contain a term as an array # currently only displays first 10 ordered by 'retrieved_at' # # ***************************************************************** echo "

Retrieve lat/lon of feeds that contain a term as an array:
"; echo '$latitude_and_longitudes = $pachube->getLatLon("current cost"); '; $latitude_and_longitudes = $pachube->getLatLon("current cost"); print_r ( $latitude_and_longitudes ); echo "