update example for new send_data

Author: brentru

Adafruit_IO/client.py

@@ -58,14 +58,20 @@ def __init__(self, username, key, proxies=None, base_url='https://io.adafruit.co
         # constructing the path.
         self.base_url = base_url.rstrip('/')
 
+    @staticmethod
+    def _create_payload(value, metadata):
+        if metadata is not None:
+            payload = Data(value=value,lat=metadata['lat'], lon=metadata['lon'],
+                            ele=metadata['ele'], created_at=metadata['created_at'])
+            return payload
+        return Data(value=value)
 
     def _compose_url(self, path, is_time=None):
         if is_time: # return a call to https://io.adafruit.com/api/v2/time/{unit}
           return '{0}/api/{1}/{2}'.format(self.base_url, 'v2', path)
         else:
             return '{0}/api/{1}/{2}/{3}'.format(self.base_url, 'v2', self.username, path)
 
-
     def _handle_error(self, response):
         # Throttling Error
         if response.status_code == 429:
@@ -109,16 +115,6 @@ def _delete(self, path):
                                    proxies=self.proxies)
         self._handle_error(response)
 
-    @staticmethod
-    def _create_payload(value, metadata):
-        """
-        """
-        if metadata is not None:
-            payload = Data(value=value,lat=metadata['lat'], lon=metadata['lon'],
-                            ele=metadata['ele'], created_at=metadata['created_at'])
-            return payload
-        return Data(value=value)
-
     # Data functionality.
     def send_data(self, feed, value, metadata=None, precision=None):
         """Helper function to simplify adding a value to a feed.  Will append the
@@ -162,16 +158,6 @@ def append(self, feed, value):
         """
         return self.create_data(feed, Data(value=value))
 
-    def send_location_data(self, feed, lat, lon, ele, value=None):
-        """Sends locational data to a feed.
-        :param string feed: Name/Key/ID of Adafruit IO feed.
-        :param int lat: Latitude.
-        :param int lon: Longitude.
-        :param int ele: Elevation.
-        :param int value: Optional value to send, defaults to None.
-        """
-        return self.create_data(feed, Data(value=value,lat=lat, lon=lon, ele=ele))
-
     def receive_time(self, time):
         """Returns the time from the Adafruit IO server.
         :param string time: Time to be returned: `millis`, `seconds`, `ISO-8601`.

examples/api/location.py

@@ -1,9 +1,8 @@
 """
 'location.py'
 ==================================
-Example of sending location over an
-Adafruit IO feed to a Map Dashboard
-block
+Example of sending metadata
+associated with a data point.
 
 Author(s): Brent Rubell
 """
@@ -12,9 +11,14 @@
 from Adafruit_IO import Client, Feed, RequestError
 
 # Set to your Adafruit IO key.
-ADAFRUIT_IO_USERNAME = 'YOUR_AIO_USERNAME'
+# Remember, your key is a secret,
+# so make sure not to publish it when you publish this code!
 ADAFRUIT_IO_KEY = 'YOUR_AIO_KEY'
 
+# Set to your Adafruit IO username.
+# (go to https://accounts.adafruit.com to find your username)
+ADAFRUIT_IO_USERNAME = 'YOUR_AIO_USERNAME'
+
 # Create an instance of the REST client.
 aio = Client(ADAFRUIT_IO_USERNAME, ADAFRUIT_IO_KEY)
 
@@ -25,12 +29,12 @@
     feed = Feed(name="location")
     location = aio.create_feed(feed)
 
-
-# Top Secret Adafruit HQ Location
-value = 1
-lat = 40.726190
-lon = -74.005334
-ele = 6 # elevation above sea level (meters)
+value = 42
+# Set metadata associated with value
+metadata = {'lat': 40.726190,
+            'lon': -74.005334,
+            'ele': -6,
+            'created_at': None}
 
 # Send location data to Adafruit IO
-aio.send_location_data(location.key, lat, lon, ele, value)
+aio.send_data(location.key, value, metadata)