Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / 614db98bf45b9da1f29c35a9d942536111e99d41 / . / docs / dyn / mapsengine_v1.tables.features.html
blob: 1a3871f17027becc5e3e9f7380cb6693a49ae072 [file] [log] [blame]
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame^]1<html><body>
2<style>
3
4body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13}
14
15body {
16 font-size: 13px;
17 padding: 1em;
18}
19
20h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23}
24
25h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28}
29
30h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34}
35
36pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42 margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46 font-family: Arial, sans serif;
47}
48
49h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51}
52
53.toc_element {
54 margin-top: 0.5em;
55}
56
57.firstline {
58 margin-left: 2 em;
59}
60
61.method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66}
67
68.details {
69 font-weight: bold;
70 font-size: 14px;
71}
72
73</style>
74
75<h1><a href="mapsengine_v1.html">Google Maps Engine API</a> . <a href="mapsengine_v1.tables.html">tables</a> . <a href="mapsengine_v1.tables.features.html">features</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78 <code><a href="#batchDelete">batchDelete(id, body)</a></code></p>
79<p class="firstline">Delete all features matching the given IDs.</p>
80<p class="toc_element">
81 <code><a href="#batchInsert">batchInsert(id, body)</a></code></p>
82<p class="firstline">Append features to an existing table.</p>
83<p class="toc_element">
84 <code><a href="#batchPatch">batchPatch(id, body)</a></code></p>
85<p class="firstline">Update the supplied features.</p>
86<p class="toc_element">
87 <code><a href="#get">get(tableId, id, version=None, select=None)</a></code></p>
88<p class="firstline">Return a single feature, given its ID.</p>
89<p class="toc_element">
90 <code><a href="#list">list(id, orderBy=None, intersects=None, pageToken=None, maxResults=None, version=None, limit=None, include=None, where=None, select=None)</a></code></p>
91<p class="firstline">Return all features readable by the current user.</p>
92<p class="toc_element">
93 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
94<p class="firstline">Retrieves the next page of results.</p>
95<h3>Method Details</h3>
96<div class="method">
97 <code class="details" id="batchDelete">batchDelete(id, body)</code>
98 <pre>Delete all features matching the given IDs.
99
100Args:
101 id: string, The ID of the table that contains the features to be deleted. (required)
102 body: object, The request body. (required)
103 The object takes the form of:
104
105{ # The request sent to features.BatchDelete.
106 "gx_ids": [
107 "A String",
108 ],
109 "primaryKeys": [
110 "A String",
111 ],
112 }
113
114</pre>
115</div>
116
117<div class="method">
118 <code class="details" id="batchInsert">batchInsert(id, body)</code>
119 <pre>Append features to an existing table.
120
121A single batchInsert request can create:
122
123- Up to 50 features.
124- A combined total of 10 000 vertices.
125Feature limits are documented in the Supported data formats and limits article of the Google Maps Engine help center. Note that free and paid accounts have different limits.
126
127For more information about inserting features, read Creating features in the Google Maps Engine developer's guide.
128
129Args:
130 id: string, The ID of the table to append the features to. (required)
131 body: object, The request body. (required)
132 The object takes the form of:
133
134{ # The request sent to features.Insert.
135 "features": [
136 { # A feature within a table.
137 "geometry": { # A geometry object # The geometry member of this Feature.
138 },
139 "type": "Feature", # Identifies this object as a feature.
140 "properties": { # The properties associated with a feature. # Key/value pairs of this Feature.
141 "a_key": "",
142 },
143 },
144 ],
145 }
146
147</pre>
148</div>
149
150<div class="method">
151 <code class="details" id="batchPatch">batchPatch(id, body)</code>
152 <pre>Update the supplied features.
153
154A single batchPatch request can update:
155
156- Up to 50 features.
157- A combined total of 10 000 vertices.
158Feature limits are documented in the Supported data formats and limits article of the Google Maps Engine help center. Note that free and paid accounts have different limits.
159
160Feature updates use HTTP PATCH semantics:
161
162- A supplied value replaces an existing value (if any) in that field.
163- Omitted fields remain unchanged.
164- Complex values in geometries and properties must be replaced as atomic units. For example, providing just the coordinates of a geometry is not allowed; the complete geometry, including type, must be supplied.
165- Setting a property's value to null deletes that property.
166For more information about updating features, read Updating features in the Google Maps Engine developer's guide.
167
168Args:
169 id: string, The ID of the table containing the features to be patched. (required)
170 body: object, The request body. (required)
171 The object takes the form of:
172
173{ # The request sent to features.BatchPatch.
174 "features": [
175 { # A feature within a table.
176 "geometry": { # A geometry object # The geometry member of this Feature.
177 },
178 "type": "Feature", # Identifies this object as a feature.
179 "properties": { # The properties associated with a feature. # Key/value pairs of this Feature.
180 "a_key": "",
181 },
182 },
183 ],
184 }
185
186</pre>
187</div>
188
189<div class="method">
190 <code class="details" id="get">get(tableId, id, version=None, select=None)</code>
191 <pre>Return a single feature, given its ID.
192
193Args:
194 tableId: string, The ID of the table. (required)
195 id: string, The ID of the feature to get. (required)
196 version: string, The table version to access. See Accessing Public Data for information.
197 Allowed values
198 draft - The draft version.
199 published - The published version.
200 select: string, A SQL-like projection clause used to specify returned properties. If this parameter is not included, all properties are returned.
201
202Returns:
203 An object of the form:
204
205 { # A feature within a table.
206 "geometry": { # A geometry object # The geometry member of this Feature.
207 },
208 "type": "Feature", # Identifies this object as a feature.
209 "properties": { # The properties associated with a feature. # Key/value pairs of this Feature.
210 "a_key": "",
211 },
212 }</pre>
213</div>
214
215<div class="method">
216 <code class="details" id="list">list(id, orderBy=None, intersects=None, pageToken=None, maxResults=None, version=None, limit=None, include=None, where=None, select=None)</code>
217 <pre>Return all features readable by the current user.
218
219Args:
220 id: string, The ID of the table to which these features belong. (required)
221 orderBy: string, An SQL-like order by clause used to sort results. If this parameter is not included, the order of features is undefined.
222 intersects: string, A geometry literal that specifies the spatial restriction of the query.
223 pageToken: string, The continuation token, used to page through large result sets. To get the next page of results, set this parameter to the value of nextPageToken from the previous response.
224 maxResults: integer, The maximum number of items to include in the response, used for paging.
225 version: string, The table version to access. See Accessing Public Data for information.
226 Allowed values
227 draft - The draft version.
228 published - The published version.
229 limit: integer, The total number of features to return from the query, irrespective of the number of pages.
230 include: string, A comma separated list of optional data to include. Optional data available: schema.
231 where: string, An SQL-like predicate used to filter results.
232 select: string, A SQL-like projection clause used to specify returned properties. If this parameter is not included, all properties are returned.
233
234Returns:
235 An object of the form:
236
237 { # The response returned by a call to features.List.
238 "nextPageToken": "A String", # Next page token.
239 "allowedQueriesPerSecond": 3.14, # An indicator of the maximum rate at which queries may be made, if all queries were as expensive as this query.
240 "type": "FeatureCollection",
241 "features": [ # Resources returned.
242 { # A feature within a table.
243 "geometry": { # A geometry object # The geometry member of this Feature.
244 },
245 "type": "Feature", # Identifies this object as a feature.
246 "properties": { # The properties associated with a feature. # Key/value pairs of this Feature.
247 "a_key": "",
248 },
249 },
250 ],
251 "schema": { # A schema indicating the properties which may be associated with features within a Table, and the types of those properties. # The feature schema.
252 "primaryGeometry": "A String", # The name of the column that contains a feature's geometry. This field can be omitted during table create; Google Maps Engine supports only a single geometry column, which must be named geometry and be the first object in the columns array.
253 "primaryKey": "A String", # The name of the column that contains the unique identifier of a Feature.
254 "columns": [ # An array of column objects. The first object in the array must be named geometry and be of type points, lineStrings, polygons, or mixedGeometry.
255 {
256 "type": "A String", # The type of data stored in this column. Accepted values are:
257 #
258 # - integer
259 # - double
260 # - boolean
261 # - string
262 # - mixedGeometry
263 # - points
264 # - lineStrings
265 # - polygons
266 "name": "A String", # The column name.
267 },
268 ],
269 },
270 }</pre>
271</div>
272
273<div class="method">
274 <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
275 <pre>Retrieves the next page of results.
276
277Args:
278 previous_request: The request for the previous page. (required)
279 previous_response: The response from the request for the previous page. (required)
280
281Returns:
282 A request object that you can call 'execute()' on to request the next
283 page. Returns None if there are no more items in the collection.
284 </pre>
285</div>
286
287</body></html>