blob: e0f2b0a7519bb7eba64a532cdeafb6ddf43e108a [file] [log] [blame]
Joe Gregorioafc45f22011-02-20 16:11:28 -05001
2<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
3<html><head><title>Python: class Resource</title>
4</head><body bgcolor="#f0f0f8">
5<p>
6<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
7<tr bgcolor="#ffc8d8">
8<td colspan=3 valign=bottom>&nbsp;<br>
9<font color="#000000" face="helvetica, arial"><a name="Resource">class <strong>Resource</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
10
11<tr bgcolor="#ffc8d8"><td rowspan=2><tt>&nbsp;&nbsp;&nbsp;</tt></td>
12<td colspan=2><tt>A&nbsp;class&nbsp;for&nbsp;interacting&nbsp;with&nbsp;a&nbsp;resource.<br>&nbsp;</tt></td></tr>
13<tr><td>&nbsp;</td>
14<td width="100%">Methods defined here:<br>
15<dl><dt><a name="Resource-__init__"><strong>__init__</strong></a>(self)</dt></dl>
16
17<dl><dt><a name="Resource-delete"><strong>delete</strong></a> = method(self, **kwargs)</dt><dd><tt>Deletes&nbsp;a&nbsp;location&nbsp;from&nbsp;the&nbsp;user's&nbsp;location&nbsp;history.<br>
18&nbsp;<br>
19Args:<br>
Joe Gregorioad258e22011-02-22 22:53:30 -050020&nbsp;&nbsp;locationId:&nbsp;string,&nbsp;Timestamp&nbsp;of&nbsp;the&nbsp;location&nbsp;to&nbsp;delete&nbsp;(ms&nbsp;since&nbsp;epoch).&nbsp;(required)</tt></dd></dl>
Joe Gregorioafc45f22011-02-20 16:11:28 -050021
22<dl><dt><a name="Resource-get"><strong>get</strong></a> = method(self, **kwargs)</dt><dd><tt>Reads&nbsp;a&nbsp;location&nbsp;from&nbsp;the&nbsp;user's&nbsp;location&nbsp;history.<br>
23&nbsp;<br>
24Args:<br>
Joe Gregorioad258e22011-02-22 22:53:30 -050025&nbsp;&nbsp;locationId:&nbsp;string,&nbsp;Timestamp&nbsp;of&nbsp;the&nbsp;location&nbsp;to&nbsp;read&nbsp;(ms&nbsp;since&nbsp;epoch).&nbsp;(required)<br>
Joe Gregoriob417caf2011-12-08 12:04:24 -050026&nbsp;&nbsp;granularity:&nbsp;string,&nbsp;Granularity&nbsp;of&nbsp;the&nbsp;location&nbsp;to&nbsp;return.<br>
27&nbsp;<br>
28Returns:<br>
29&nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
30&nbsp;<br>
31&nbsp;&nbsp;&nbsp;&nbsp;{&nbsp;#&nbsp;A&nbsp;Location&nbsp;resource&nbsp;identifies&nbsp;a&nbsp;user's&nbsp;position&nbsp;at&nbsp;a&nbsp;particular&nbsp;time.&nbsp;It&nbsp;may&nbsp;include&nbsp;metadata&nbsp;about&nbsp;the&nbsp;user's&nbsp;position,&nbsp;such&nbsp;as&nbsp;a&nbsp;venue&nbsp;if&nbsp;the&nbsp;location&nbsp;was&nbsp;recorded&nbsp;at&nbsp;the&nbsp;time&nbsp;of&nbsp;a&nbsp;check-in.<br>
32&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"latitude#location",&nbsp;#&nbsp;Kind&nbsp;of&nbsp;this&nbsp;item.<br>
33&nbsp;&nbsp;&nbsp;&nbsp;"altitude":&nbsp;"",&nbsp;#&nbsp;Altitude&nbsp;of&nbsp;the&nbsp;location,&nbsp;in&nbsp;meters.&nbsp;Optional.<br>
34&nbsp;&nbsp;&nbsp;&nbsp;"longitude":&nbsp;"",&nbsp;#&nbsp;Longitude&nbsp;of&nbsp;the&nbsp;location,&nbsp;in&nbsp;decimal&nbsp;degrees.<br>
35&nbsp;&nbsp;&nbsp;&nbsp;"activityId":&nbsp;"",&nbsp;#&nbsp;Unique&nbsp;ID&nbsp;of&nbsp;the&nbsp;Buzz&nbsp;message&nbsp;that&nbsp;corresponds&nbsp;to&nbsp;the&nbsp;check-in&nbsp;associated&nbsp;with&nbsp;this&nbsp;location.&nbsp;Available&nbsp;only&nbsp;for&nbsp;check-in&nbsp;locations.&nbsp;Optional.<br>
36&nbsp;&nbsp;&nbsp;&nbsp;"latitude":&nbsp;"",&nbsp;#&nbsp;Latitude&nbsp;of&nbsp;the&nbsp;location,&nbsp;in&nbsp;decimal&nbsp;degrees.<br>
37&nbsp;&nbsp;&nbsp;&nbsp;"altitudeAccuracy":&nbsp;"",&nbsp;#&nbsp;Accuracy&nbsp;of&nbsp;the&nbsp;altitude&nbsp;value,&nbsp;in&nbsp;meters.&nbsp;Optional.<br>
38&nbsp;&nbsp;&nbsp;&nbsp;"timestampMs":&nbsp;"",&nbsp;#&nbsp;Timestamp&nbsp;of&nbsp;the&nbsp;Location&nbsp;Resource,&nbsp;in&nbsp;milliseconds&nbsp;since&nbsp;the&nbsp;epoch&nbsp;(UTC).&nbsp;This&nbsp;is&nbsp;also&nbsp;the&nbsp;Location&nbsp;Resource's&nbsp;unique&nbsp;id.<br>
39&nbsp;&nbsp;&nbsp;&nbsp;"speed":&nbsp;"",&nbsp;#&nbsp;Ground&nbsp;speed&nbsp;of&nbsp;the&nbsp;user&nbsp;at&nbsp;the&nbsp;time&nbsp;this&nbsp;location&nbsp;was&nbsp;recorded,&nbsp;in&nbsp;meters&nbsp;per&nbsp;second.&nbsp;Non-negative.&nbsp;Optional.<br>
40&nbsp;&nbsp;&nbsp;&nbsp;"heading":&nbsp;"",&nbsp;#&nbsp;Direction&nbsp;of&nbsp;travel&nbsp;of&nbsp;the&nbsp;user&nbsp;when&nbsp;this&nbsp;location&nbsp;was&nbsp;recorded.&nbsp;In&nbsp;degrees,&nbsp;clockwise&nbsp;relative&nbsp;to&nbsp;true&nbsp;north.&nbsp;Optional.<br>
41&nbsp;&nbsp;&nbsp;&nbsp;"accuracy":&nbsp;"",&nbsp;#&nbsp;Accuracy&nbsp;of&nbsp;the&nbsp;latitude&nbsp;and&nbsp;longitude&nbsp;coordinates,&nbsp;in&nbsp;non-negative&nbsp;meters.&nbsp;Optional.<br>
42&nbsp;&nbsp;}</tt></dd></dl>
Joe Gregorioafc45f22011-02-20 16:11:28 -050043
44<dl><dt><a name="Resource-insert"><strong>insert</strong></a> = method(self, **kwargs)</dt><dd><tt>Inserts&nbsp;or&nbsp;updates&nbsp;a&nbsp;location&nbsp;in&nbsp;the&nbsp;user's&nbsp;location&nbsp;history.<br>
45&nbsp;<br>
46Args:<br>
Joe Gregoriob417caf2011-12-08 12:04:24 -050047&nbsp;&nbsp;body:&nbsp;object,&nbsp;The&nbsp;request&nbsp;body.&nbsp;(required)<br>
48&nbsp;&nbsp;&nbsp;&nbsp;The&nbsp;object&nbsp;takes&nbsp;the&nbsp;form&nbsp;of:<br>
49&nbsp;<br>
50{&nbsp;#&nbsp;A&nbsp;Location&nbsp;resource&nbsp;identifies&nbsp;a&nbsp;user's&nbsp;position&nbsp;at&nbsp;a&nbsp;particular&nbsp;time.&nbsp;It&nbsp;may&nbsp;include&nbsp;metadata&nbsp;about&nbsp;the&nbsp;user's&nbsp;position,&nbsp;such&nbsp;as&nbsp;a&nbsp;venue&nbsp;if&nbsp;the&nbsp;location&nbsp;was&nbsp;recorded&nbsp;at&nbsp;the&nbsp;time&nbsp;of&nbsp;a&nbsp;check-in.<br>
51&nbsp;&nbsp;"kind":&nbsp;"latitude#location",&nbsp;#&nbsp;Kind&nbsp;of&nbsp;this&nbsp;item.<br>
52&nbsp;&nbsp;"altitude":&nbsp;"",&nbsp;#&nbsp;Altitude&nbsp;of&nbsp;the&nbsp;location,&nbsp;in&nbsp;meters.&nbsp;Optional.<br>
53&nbsp;&nbsp;"longitude":&nbsp;"",&nbsp;#&nbsp;Longitude&nbsp;of&nbsp;the&nbsp;location,&nbsp;in&nbsp;decimal&nbsp;degrees.<br>
54&nbsp;&nbsp;"activityId":&nbsp;"",&nbsp;#&nbsp;Unique&nbsp;ID&nbsp;of&nbsp;the&nbsp;Buzz&nbsp;message&nbsp;that&nbsp;corresponds&nbsp;to&nbsp;the&nbsp;check-in&nbsp;associated&nbsp;with&nbsp;this&nbsp;location.&nbsp;Available&nbsp;only&nbsp;for&nbsp;check-in&nbsp;locations.&nbsp;Optional.<br>
55&nbsp;&nbsp;"latitude":&nbsp;"",&nbsp;#&nbsp;Latitude&nbsp;of&nbsp;the&nbsp;location,&nbsp;in&nbsp;decimal&nbsp;degrees.<br>
56&nbsp;&nbsp;"altitudeAccuracy":&nbsp;"",&nbsp;#&nbsp;Accuracy&nbsp;of&nbsp;the&nbsp;altitude&nbsp;value,&nbsp;in&nbsp;meters.&nbsp;Optional.<br>
57&nbsp;&nbsp;"timestampMs":&nbsp;"",&nbsp;#&nbsp;Timestamp&nbsp;of&nbsp;the&nbsp;Location&nbsp;Resource,&nbsp;in&nbsp;milliseconds&nbsp;since&nbsp;the&nbsp;epoch&nbsp;(UTC).&nbsp;This&nbsp;is&nbsp;also&nbsp;the&nbsp;Location&nbsp;Resource's&nbsp;unique&nbsp;id.<br>
58&nbsp;&nbsp;"speed":&nbsp;"",&nbsp;#&nbsp;Ground&nbsp;speed&nbsp;of&nbsp;the&nbsp;user&nbsp;at&nbsp;the&nbsp;time&nbsp;this&nbsp;location&nbsp;was&nbsp;recorded,&nbsp;in&nbsp;meters&nbsp;per&nbsp;second.&nbsp;Non-negative.&nbsp;Optional.<br>
59&nbsp;&nbsp;"heading":&nbsp;"",&nbsp;#&nbsp;Direction&nbsp;of&nbsp;travel&nbsp;of&nbsp;the&nbsp;user&nbsp;when&nbsp;this&nbsp;location&nbsp;was&nbsp;recorded.&nbsp;In&nbsp;degrees,&nbsp;clockwise&nbsp;relative&nbsp;to&nbsp;true&nbsp;north.&nbsp;Optional.<br>
60&nbsp;&nbsp;"accuracy":&nbsp;"",&nbsp;#&nbsp;Accuracy&nbsp;of&nbsp;the&nbsp;latitude&nbsp;and&nbsp;longitude&nbsp;coordinates,&nbsp;in&nbsp;non-negative&nbsp;meters.&nbsp;Optional.<br>
61}<br>
62&nbsp;<br>
63&nbsp;<br>
64Returns:<br>
65&nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
66&nbsp;<br>
67&nbsp;&nbsp;&nbsp;&nbsp;{&nbsp;#&nbsp;A&nbsp;Location&nbsp;resource&nbsp;identifies&nbsp;a&nbsp;user's&nbsp;position&nbsp;at&nbsp;a&nbsp;particular&nbsp;time.&nbsp;It&nbsp;may&nbsp;include&nbsp;metadata&nbsp;about&nbsp;the&nbsp;user's&nbsp;position,&nbsp;such&nbsp;as&nbsp;a&nbsp;venue&nbsp;if&nbsp;the&nbsp;location&nbsp;was&nbsp;recorded&nbsp;at&nbsp;the&nbsp;time&nbsp;of&nbsp;a&nbsp;check-in.<br>
68&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"latitude#location",&nbsp;#&nbsp;Kind&nbsp;of&nbsp;this&nbsp;item.<br>
69&nbsp;&nbsp;&nbsp;&nbsp;"altitude":&nbsp;"",&nbsp;#&nbsp;Altitude&nbsp;of&nbsp;the&nbsp;location,&nbsp;in&nbsp;meters.&nbsp;Optional.<br>
70&nbsp;&nbsp;&nbsp;&nbsp;"longitude":&nbsp;"",&nbsp;#&nbsp;Longitude&nbsp;of&nbsp;the&nbsp;location,&nbsp;in&nbsp;decimal&nbsp;degrees.<br>
71&nbsp;&nbsp;&nbsp;&nbsp;"activityId":&nbsp;"",&nbsp;#&nbsp;Unique&nbsp;ID&nbsp;of&nbsp;the&nbsp;Buzz&nbsp;message&nbsp;that&nbsp;corresponds&nbsp;to&nbsp;the&nbsp;check-in&nbsp;associated&nbsp;with&nbsp;this&nbsp;location.&nbsp;Available&nbsp;only&nbsp;for&nbsp;check-in&nbsp;locations.&nbsp;Optional.<br>
72&nbsp;&nbsp;&nbsp;&nbsp;"latitude":&nbsp;"",&nbsp;#&nbsp;Latitude&nbsp;of&nbsp;the&nbsp;location,&nbsp;in&nbsp;decimal&nbsp;degrees.<br>
73&nbsp;&nbsp;&nbsp;&nbsp;"altitudeAccuracy":&nbsp;"",&nbsp;#&nbsp;Accuracy&nbsp;of&nbsp;the&nbsp;altitude&nbsp;value,&nbsp;in&nbsp;meters.&nbsp;Optional.<br>
74&nbsp;&nbsp;&nbsp;&nbsp;"timestampMs":&nbsp;"",&nbsp;#&nbsp;Timestamp&nbsp;of&nbsp;the&nbsp;Location&nbsp;Resource,&nbsp;in&nbsp;milliseconds&nbsp;since&nbsp;the&nbsp;epoch&nbsp;(UTC).&nbsp;This&nbsp;is&nbsp;also&nbsp;the&nbsp;Location&nbsp;Resource's&nbsp;unique&nbsp;id.<br>
75&nbsp;&nbsp;&nbsp;&nbsp;"speed":&nbsp;"",&nbsp;#&nbsp;Ground&nbsp;speed&nbsp;of&nbsp;the&nbsp;user&nbsp;at&nbsp;the&nbsp;time&nbsp;this&nbsp;location&nbsp;was&nbsp;recorded,&nbsp;in&nbsp;meters&nbsp;per&nbsp;second.&nbsp;Non-negative.&nbsp;Optional.<br>
76&nbsp;&nbsp;&nbsp;&nbsp;"heading":&nbsp;"",&nbsp;#&nbsp;Direction&nbsp;of&nbsp;travel&nbsp;of&nbsp;the&nbsp;user&nbsp;when&nbsp;this&nbsp;location&nbsp;was&nbsp;recorded.&nbsp;In&nbsp;degrees,&nbsp;clockwise&nbsp;relative&nbsp;to&nbsp;true&nbsp;north.&nbsp;Optional.<br>
77&nbsp;&nbsp;&nbsp;&nbsp;"accuracy":&nbsp;"",&nbsp;#&nbsp;Accuracy&nbsp;of&nbsp;the&nbsp;latitude&nbsp;and&nbsp;longitude&nbsp;coordinates,&nbsp;in&nbsp;non-negative&nbsp;meters.&nbsp;Optional.<br>
78&nbsp;&nbsp;}</tt></dd></dl>
Joe Gregorioafc45f22011-02-20 16:11:28 -050079
80<dl><dt><a name="Resource-list"><strong>list</strong></a> = method(self, **kwargs)</dt><dd><tt>Lists&nbsp;the&nbsp;user's&nbsp;location&nbsp;history.<br>
81&nbsp;<br>
82Args:<br>
Joe Gregorioad258e22011-02-22 22:53:30 -050083&nbsp;&nbsp;min_time:&nbsp;string,&nbsp;Minimum&nbsp;timestamp&nbsp;of&nbsp;locations&nbsp;to&nbsp;return&nbsp;(ms&nbsp;since&nbsp;epoch).<br>
84&nbsp;&nbsp;max_results:&nbsp;string,&nbsp;Maximum&nbsp;number&nbsp;of&nbsp;locations&nbsp;to&nbsp;return.<br>
85&nbsp;&nbsp;max_time:&nbsp;string,&nbsp;Maximum&nbsp;timestamp&nbsp;of&nbsp;locations&nbsp;to&nbsp;return&nbsp;(ms&nbsp;since&nbsp;epoch).<br>
Joe Gregoriob417caf2011-12-08 12:04:24 -050086&nbsp;&nbsp;granularity:&nbsp;string,&nbsp;Granularity&nbsp;of&nbsp;the&nbsp;requested&nbsp;locations.<br>
87&nbsp;<br>
88Returns:<br>
89&nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
90&nbsp;<br>
91&nbsp;&nbsp;&nbsp;&nbsp;{<br>
92&nbsp;&nbsp;&nbsp;&nbsp;"items":&nbsp;[<br>
93&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&nbsp;#&nbsp;A&nbsp;Location&nbsp;resource&nbsp;identifies&nbsp;a&nbsp;user's&nbsp;position&nbsp;at&nbsp;a&nbsp;particular&nbsp;time.&nbsp;It&nbsp;may&nbsp;include&nbsp;metadata&nbsp;about&nbsp;the&nbsp;user's&nbsp;position,&nbsp;such&nbsp;as&nbsp;a&nbsp;venue&nbsp;if&nbsp;the&nbsp;location&nbsp;was&nbsp;recorded&nbsp;at&nbsp;the&nbsp;time&nbsp;of&nbsp;a&nbsp;check-in.<br>
94&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"latitude#location",&nbsp;#&nbsp;Kind&nbsp;of&nbsp;this&nbsp;item.<br>
95&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"altitude":&nbsp;"",&nbsp;#&nbsp;Altitude&nbsp;of&nbsp;the&nbsp;location,&nbsp;in&nbsp;meters.&nbsp;Optional.<br>
96&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"longitude":&nbsp;"",&nbsp;#&nbsp;Longitude&nbsp;of&nbsp;the&nbsp;location,&nbsp;in&nbsp;decimal&nbsp;degrees.<br>
97&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"activityId":&nbsp;"",&nbsp;#&nbsp;Unique&nbsp;ID&nbsp;of&nbsp;the&nbsp;Buzz&nbsp;message&nbsp;that&nbsp;corresponds&nbsp;to&nbsp;the&nbsp;check-in&nbsp;associated&nbsp;with&nbsp;this&nbsp;location.&nbsp;Available&nbsp;only&nbsp;for&nbsp;check-in&nbsp;locations.&nbsp;Optional.<br>
98&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"latitude":&nbsp;"",&nbsp;#&nbsp;Latitude&nbsp;of&nbsp;the&nbsp;location,&nbsp;in&nbsp;decimal&nbsp;degrees.<br>
99&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"altitudeAccuracy":&nbsp;"",&nbsp;#&nbsp;Accuracy&nbsp;of&nbsp;the&nbsp;altitude&nbsp;value,&nbsp;in&nbsp;meters.&nbsp;Optional.<br>
100&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"timestampMs":&nbsp;"",&nbsp;#&nbsp;Timestamp&nbsp;of&nbsp;the&nbsp;Location&nbsp;Resource,&nbsp;in&nbsp;milliseconds&nbsp;since&nbsp;the&nbsp;epoch&nbsp;(UTC).&nbsp;This&nbsp;is&nbsp;also&nbsp;the&nbsp;Location&nbsp;Resource's&nbsp;unique&nbsp;id.<br>
101&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"speed":&nbsp;"",&nbsp;#&nbsp;Ground&nbsp;speed&nbsp;of&nbsp;the&nbsp;user&nbsp;at&nbsp;the&nbsp;time&nbsp;this&nbsp;location&nbsp;was&nbsp;recorded,&nbsp;in&nbsp;meters&nbsp;per&nbsp;second.&nbsp;Non-negative.&nbsp;Optional.<br>
102&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"heading":&nbsp;"",&nbsp;#&nbsp;Direction&nbsp;of&nbsp;travel&nbsp;of&nbsp;the&nbsp;user&nbsp;when&nbsp;this&nbsp;location&nbsp;was&nbsp;recorded.&nbsp;In&nbsp;degrees,&nbsp;clockwise&nbsp;relative&nbsp;to&nbsp;true&nbsp;north.&nbsp;Optional.<br>
103&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"accuracy":&nbsp;"",&nbsp;#&nbsp;Accuracy&nbsp;of&nbsp;the&nbsp;latitude&nbsp;and&nbsp;longitude&nbsp;coordinates,&nbsp;in&nbsp;non-negative&nbsp;meters.&nbsp;Optional.<br>
104&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
105&nbsp;&nbsp;&nbsp;&nbsp;],<br>
106&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"latitude#locationFeed",<br>
107&nbsp;&nbsp;}</tt></dd></dl>
Joe Gregorioafc45f22011-02-20 16:11:28 -0500108
109<hr>
110Data descriptors defined here:<br>
111<dl><dt><strong>__dict__</strong></dt>
112<dd><tt>dictionary&nbsp;for&nbsp;instance&nbsp;variables&nbsp;(if&nbsp;defined)</tt></dd>
113</dl>
114<dl><dt><strong>__weakref__</strong></dt>
115<dd><tt>list&nbsp;of&nbsp;weak&nbsp;references&nbsp;to&nbsp;the&nbsp;object&nbsp;(if&nbsp;defined)</tt></dd>
116</dl>
117</td></tr></table>
118</body></html>