blob: bf0cda4befae64ee78607713e002a2950d3890ed [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
Joe Gregorioad258e22011-02-22 22:53:30 -050017<dl><dt><a name="Resource-delete"><strong>delete</strong></a> = method(self, **kwargs)</dt><dd><tt>Deletes&nbsp;the&nbsp;authenticated&nbsp;user's&nbsp;current&nbsp;location.<br>
18&nbsp;<br>
19Args:</tt></dd></dl>
Joe Gregorioafc45f22011-02-20 16:11:28 -050020
21<dl><dt><a name="Resource-get"><strong>get</strong></a> = method(self, **kwargs)</dt><dd><tt>Returns&nbsp;the&nbsp;authenticated&nbsp;user's&nbsp;current&nbsp;location.<br>
22&nbsp;<br>
23Args:<br>
Joe Gregoriob417caf2011-12-08 12:04:24 -050024&nbsp;&nbsp;granularity:&nbsp;string,&nbsp;Granularity&nbsp;of&nbsp;the&nbsp;requested&nbsp;location.<br>
25&nbsp;<br>
26Returns:<br>
27&nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
28&nbsp;<br>
29&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>
30&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"latitude#location",&nbsp;#&nbsp;Kind&nbsp;of&nbsp;this&nbsp;item.<br>
31&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"altitude":&nbsp;"",&nbsp;#&nbsp;Altitude&nbsp;of&nbsp;the&nbsp;location,&nbsp;in&nbsp;meters.&nbsp;Optional.<br>
32&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"longitude":&nbsp;"",&nbsp;#&nbsp;Longitude&nbsp;of&nbsp;the&nbsp;location,&nbsp;in&nbsp;decimal&nbsp;degrees.<br>
33&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>
34&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"latitude":&nbsp;"",&nbsp;#&nbsp;Latitude&nbsp;of&nbsp;the&nbsp;location,&nbsp;in&nbsp;decimal&nbsp;degrees.<br>
35&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>
36&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>
37&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>
38&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>
39&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>
40&nbsp;&nbsp;&nbsp;&nbsp;}</tt></dd></dl>
Joe Gregorioafc45f22011-02-20 16:11:28 -050041
42<dl><dt><a name="Resource-insert"><strong>insert</strong></a> = method(self, **kwargs)</dt><dd><tt>Updates&nbsp;or&nbsp;creates&nbsp;the&nbsp;user's&nbsp;current&nbsp;location.<br>
43&nbsp;<br>
44Args:<br>
Joe Gregoriob417caf2011-12-08 12:04:24 -050045&nbsp;&nbsp;body:&nbsp;object,&nbsp;The&nbsp;request&nbsp;body.&nbsp;(required)<br>
46&nbsp;&nbsp;&nbsp;&nbsp;The&nbsp;object&nbsp;takes&nbsp;the&nbsp;form&nbsp;of:<br>
47&nbsp;<br>
48{&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>
49&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"latitude#location",&nbsp;#&nbsp;Kind&nbsp;of&nbsp;this&nbsp;item.<br>
50&nbsp;&nbsp;&nbsp;&nbsp;"altitude":&nbsp;"",&nbsp;#&nbsp;Altitude&nbsp;of&nbsp;the&nbsp;location,&nbsp;in&nbsp;meters.&nbsp;Optional.<br>
51&nbsp;&nbsp;&nbsp;&nbsp;"longitude":&nbsp;"",&nbsp;#&nbsp;Longitude&nbsp;of&nbsp;the&nbsp;location,&nbsp;in&nbsp;decimal&nbsp;degrees.<br>
52&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>
53&nbsp;&nbsp;&nbsp;&nbsp;"latitude":&nbsp;"",&nbsp;#&nbsp;Latitude&nbsp;of&nbsp;the&nbsp;location,&nbsp;in&nbsp;decimal&nbsp;degrees.<br>
54&nbsp;&nbsp;&nbsp;&nbsp;"altitudeAccuracy":&nbsp;"",&nbsp;#&nbsp;Accuracy&nbsp;of&nbsp;the&nbsp;altitude&nbsp;value,&nbsp;in&nbsp;meters.&nbsp;Optional.<br>
55&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>
56&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>
57&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>
58&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>
59&nbsp;&nbsp;}<br>
60&nbsp;<br>
61&nbsp;<br>
62Returns:<br>
63&nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
64&nbsp;<br>
65&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>
66&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"latitude#location",&nbsp;#&nbsp;Kind&nbsp;of&nbsp;this&nbsp;item.<br>
67&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"altitude":&nbsp;"",&nbsp;#&nbsp;Altitude&nbsp;of&nbsp;the&nbsp;location,&nbsp;in&nbsp;meters.&nbsp;Optional.<br>
68&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"longitude":&nbsp;"",&nbsp;#&nbsp;Longitude&nbsp;of&nbsp;the&nbsp;location,&nbsp;in&nbsp;decimal&nbsp;degrees.<br>
69&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>
70&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"latitude":&nbsp;"",&nbsp;#&nbsp;Latitude&nbsp;of&nbsp;the&nbsp;location,&nbsp;in&nbsp;decimal&nbsp;degrees.<br>
71&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>
72&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>
73&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>
74&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>
75&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>
76&nbsp;&nbsp;&nbsp;&nbsp;}</tt></dd></dl>
Joe Gregorioafc45f22011-02-20 16:11:28 -050077
78<hr>
79Data descriptors defined here:<br>
80<dl><dt><strong>__dict__</strong></dt>
81<dd><tt>dictionary&nbsp;for&nbsp;instance&nbsp;variables&nbsp;(if&nbsp;defined)</tt></dd>
82</dl>
83<dl><dt><strong>__weakref__</strong></dt>
84<dd><tt>list&nbsp;of&nbsp;weak&nbsp;references&nbsp;to&nbsp;the&nbsp;object&nbsp;(if&nbsp;defined)</tt></dd>
85</dl>
86</td></tr></table>
87</body></html>