blob: 7717f904109843796c9ed334e50477202409dd62 [file] [log] [blame]
Joe Gregorioba9ea7f2010-08-19 15:49:04 -04001{
Joe Gregorio6a63a762011-05-02 22:36:05 -04002 "kind": "discovery#restDescription",
3 "id": "latitude:v1",
Joe Gregorio2379ecc2010-10-26 10:51:28 -04004 "name": "latitude",
5 "version": "v1",
6 "description": "Google Latitude API",
Joe Gregorio6a63a762011-05-02 22:36:05 -04007 "icons": {
8 "x16": "http://www.google.com/images/icons/product/search-16.gif",
9 "x32": "http://www.google.com/images/icons/product/search-32.gif"
10 },
11 "labels": [
12 "labs"
13 ],
14 "protocol": "rest",
15 "basePath": "/latitude/v1/",
Joe Gregorioa2838152012-07-16 11:52:17 -040016 "rootUrl": "https://www.googleapis.com/",
17 "servicePath": "latitude/v1/",
Joe Gregorio6a63a762011-05-02 22:36:05 -040018 "auth": {
19 "oauth2": {
20 "scopes": {
21 "https://www.googleapis.com/auth/latitude": {
22 "description": "Manage your current location and location history"
23 }
24 }
25 }
26 },
27 "features": [
28 "dataWrapper"
29 ],
30 "schemas": {
31 "LatitudeCurrentlocationResourceJson": {
32 "$ref": "Location"
33 },
34 "Location": {
35 "id": "Location",
36 "type": "object",
37 "properties": {
38 "accuracy": {
39 "type": "any"
40 },
41 "activityId": {
42 "type": "any"
43 },
44 "altitude": {
45 "type": "any"
46 },
47 "altitudeAccuracy": {
48 "type": "any"
49 },
50 "heading": {
51 "type": "any"
52 },
53 "kind": {
54 "type": "string",
55 "default": "latitude#location"
56 },
57 "latitude": {
58 "type": "any"
59 },
60 "longitude": {
61 "type": "any"
62 },
63 "placeid": {
64 "type": "any"
65 },
66 "speed": {
67 "type": "any"
68 },
69 "timestampMs": {
70 "type": "any"
71 }
72 }
73 },
74 "LocationFeed": {
75 "id": "LocationFeed",
76 "type": "object",
77 "properties": {
78 "items": {
79 "type": "array",
80 "items": {
81 "$ref": "Location"
82 }
83 },
84 "kind": {
85 "type": "string",
86 "default": "latitude#locationFeed"
87 }
88 }
89 }
90 },
Joe Gregorio2379ecc2010-10-26 10:51:28 -040091 "resources": {
92 "currentLocation": {
93 "methods": {
94 "delete": {
Joe Gregorio6a63a762011-05-02 22:36:05 -040095 "id": "latitude.currentLocation.delete",
96 "path": "currentLocation",
97 "httpMethod": "DELETE",
98 "description": "Deletes the authenticated user's current location.",
99 "scopes": [
100 "https://www.googleapis.com/auth/latitude"
101 ]
Joe Gregorio2379ecc2010-10-26 10:51:28 -0400102 },
103 "get": {
Joe Gregorio6a63a762011-05-02 22:36:05 -0400104 "id": "latitude.currentLocation.get",
105 "path": "currentLocation",
Joe Gregorio2379ecc2010-10-26 10:51:28 -0400106 "httpMethod": "GET",
Joe Gregorio6a63a762011-05-02 22:36:05 -0400107 "description": "Returns the authenticated user's current location.",
Joe Gregorio2379ecc2010-10-26 10:51:28 -0400108 "parameters": {
109 "granularity": {
Joe Gregorio6a63a762011-05-02 22:36:05 -0400110 "type": "string",
111 "description": "Granularity of the requested location.",
112 "location": "query"
Joe Gregorioba9ea7f2010-08-19 15:49:04 -0400113 }
Joe Gregorio6a63a762011-05-02 22:36:05 -0400114 },
115 "response": {
116 "$ref": "LatitudeCurrentlocationResourceJson"
117 },
118 "scopes": [
119 "https://www.googleapis.com/auth/latitude"
120 ]
Joe Gregorio2379ecc2010-10-26 10:51:28 -0400121 },
122 "insert": {
Joe Gregorio6a63a762011-05-02 22:36:05 -0400123 "id": "latitude.currentLocation.insert",
124 "path": "currentLocation",
125 "httpMethod": "POST",
126 "description": "Updates or creates the user's current location.",
127 "request": {
128 "$ref": "LatitudeCurrentlocationResourceJson"
129 },
130 "response": {
131 "$ref": "LatitudeCurrentlocationResourceJson"
132 },
133 "scopes": [
134 "https://www.googleapis.com/auth/latitude"
135 ]
Joe Gregorio2379ecc2010-10-26 10:51:28 -0400136 }
137 }
138 },
139 "location": {
140 "methods": {
141 "delete": {
Joe Gregorio6a63a762011-05-02 22:36:05 -0400142 "id": "latitude.location.delete",
143 "path": "location/{locationId}",
Joe Gregorio2379ecc2010-10-26 10:51:28 -0400144 "httpMethod": "DELETE",
Joe Gregorio6a63a762011-05-02 22:36:05 -0400145 "description": "Deletes a location from the user's location history.",
Joe Gregorio2379ecc2010-10-26 10:51:28 -0400146 "parameters": {
147 "locationId": {
Joe Gregorio6a63a762011-05-02 22:36:05 -0400148 "type": "string",
149 "description": "Timestamp of the location to delete (ms since epoch).",
150 "required": true,
151 "location": "path"
Joe Gregorio2379ecc2010-10-26 10:51:28 -0400152 }
Joe Gregorio6a63a762011-05-02 22:36:05 -0400153 },
154 "parameterOrder": [
155 "locationId"
156 ],
157 "scopes": [
158 "https://www.googleapis.com/auth/latitude"
159 ]
Joe Gregorio2379ecc2010-10-26 10:51:28 -0400160 },
161 "get": {
Joe Gregorio6a63a762011-05-02 22:36:05 -0400162 "id": "latitude.location.get",
163 "path": "location/{locationId}",
Joe Gregorio2379ecc2010-10-26 10:51:28 -0400164 "httpMethod": "GET",
Joe Gregorio6a63a762011-05-02 22:36:05 -0400165 "description": "Reads a location from the user's location history.",
Joe Gregorio2379ecc2010-10-26 10:51:28 -0400166 "parameters": {
167 "granularity": {
Joe Gregorio6a63a762011-05-02 22:36:05 -0400168 "type": "string",
169 "description": "Granularity of the location to return.",
170 "location": "query"
Joe Gregorio2379ecc2010-10-26 10:51:28 -0400171 },
172 "locationId": {
Joe Gregorio6a63a762011-05-02 22:36:05 -0400173 "type": "string",
174 "description": "Timestamp of the location to read (ms since epoch).",
175 "required": true,
176 "location": "path"
Joe Gregorio2379ecc2010-10-26 10:51:28 -0400177 }
Joe Gregorio6a63a762011-05-02 22:36:05 -0400178 },
179 "parameterOrder": [
180 "locationId"
181 ],
182 "response": {
183 "$ref": "Location"
184 },
185 "scopes": [
186 "https://www.googleapis.com/auth/latitude"
187 ]
Joe Gregorio2379ecc2010-10-26 10:51:28 -0400188 },
189 "insert": {
Joe Gregorio6a63a762011-05-02 22:36:05 -0400190 "id": "latitude.location.insert",
191 "path": "location",
192 "httpMethod": "POST",
193 "description": "Inserts or updates a location in the user's location history.",
194 "request": {
195 "$ref": "Location"
196 },
197 "response": {
198 "$ref": "Location"
199 },
200 "scopes": [
201 "https://www.googleapis.com/auth/latitude"
202 ]
Joe Gregorio2379ecc2010-10-26 10:51:28 -0400203 },
204 "list": {
Joe Gregorio6a63a762011-05-02 22:36:05 -0400205 "id": "latitude.location.list",
206 "path": "location",
Joe Gregorio2379ecc2010-10-26 10:51:28 -0400207 "httpMethod": "GET",
Joe Gregorio6a63a762011-05-02 22:36:05 -0400208 "description": "Lists the user's location history.",
Joe Gregorio2379ecc2010-10-26 10:51:28 -0400209 "parameters": {
210 "granularity": {
Joe Gregorio6a63a762011-05-02 22:36:05 -0400211 "type": "string",
212 "description": "Granularity of the requested locations.",
213 "location": "query"
Joe Gregorio2379ecc2010-10-26 10:51:28 -0400214 },
215 "max-results": {
Joe Gregorio6a63a762011-05-02 22:36:05 -0400216 "type": "string",
217 "description": "Maximum number of locations to return.",
218 "location": "query"
Joe Gregorio2379ecc2010-10-26 10:51:28 -0400219 },
220 "max-time": {
Joe Gregorio6a63a762011-05-02 22:36:05 -0400221 "type": "string",
222 "description": "Maximum timestamp of locations to return (ms since epoch).",
223 "location": "query"
Joe Gregorio2379ecc2010-10-26 10:51:28 -0400224 },
225 "min-time": {
Joe Gregorio6a63a762011-05-02 22:36:05 -0400226 "type": "string",
227 "description": "Minimum timestamp of locations to return (ms since epoch).",
228 "location": "query"
Joe Gregorioba9ea7f2010-08-19 15:49:04 -0400229 }
Joe Gregorio6a63a762011-05-02 22:36:05 -0400230 },
231 "response": {
232 "$ref": "LocationFeed"
233 },
234 "scopes": [
235 "https://www.googleapis.com/auth/latitude"
236 ]
Joe Gregorioba9ea7f2010-08-19 15:49:04 -0400237 }
238 }
239 }
240 }
241}