Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / 065b5307fe180bfdd4a5d9af134b1c9a0a1d2aba / . / docs / dyn / mapsengine_v1.tables.html
blob: dba1a5f4f1c5be0548c4cea768674dc2561b0ed7 [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></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78 <code><a href="mapsengine_v1.tables.features.html">features()</a></code>
79</p>
80<p class="firstline">Returns the features Resource.</p>
81
82<p class="toc_element">
83 <code><a href="mapsengine_v1.tables.files.html">files()</a></code>
84</p>
85<p class="firstline">Returns the files Resource.</p>
86
87<p class="toc_element">
88 <code><a href="mapsengine_v1.tables.parents.html">parents()</a></code>
89</p>
90<p class="firstline">Returns the parents Resource.</p>
91
92<p class="toc_element">
93 <code><a href="#create">create(body)</a></code></p>
94<p class="firstline">Create a table asset.</p>
95<p class="toc_element">
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame^]96 <code><a href="#delete">delete(id)</a></code></p>
97<p class="firstline">Delete a table.</p>
98<p class="toc_element">
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]99 <code><a href="#get">get(id, version=None)</a></code></p>
100<p class="firstline">Return metadata for a particular table, including the schema.</p>
101<p class="toc_element">
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame^]102 <code><a href="#list">list(modifiedAfter=None, createdAfter=None, tags=None, projectId=None, maxResults=None, pageToken=None, createdBefore=None, bbox=None, creatorEmail=None, modifiedBefore=None)</a></code></p>
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]103<p class="firstline">Return all tables readable by the current user.</p>
104<p class="toc_element">
105 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
106<p class="firstline">Retrieves the next page of results.</p>
107<p class="toc_element">
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame^]108 <code><a href="#patch">patch(id, body)</a></code></p>
109<p class="firstline">Mutate a table asset.</p>
110<p class="toc_element">
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]111 <code><a href="#upload">upload(body)</a></code></p>
112<p class="firstline">Create a placeholder table asset to which table files can be uploaded.</p>
113<h3>Method Details</h3>
114<div class="method">
115 <code class="details" id="create">create(body)</code>
116 <pre>Create a table asset.
117
118Args:
119 body: object, The request body. (required)
120 The object takes the form of:
121
122{ # A collection of geographic features, and associated metadata.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame^]123 "files": [ # The files associated with this table.
124 { # A single File, which is a component of an Asset.
125 "size": "A String", # The size of the file in bytes.
126 "uploadStatus": "A String", # The upload status of the file.
127 "filename": "A String", # The name of the file.
128 },
129 ],
130 "schema": { # A schema indicating the properties which may be associated with features within a Table, and the types of those properties. # The schema for this table.
131 "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.
132 "primaryKey": "A String", # The name of the column that contains the unique identifier of a Feature.
133 "columns": [ # An array of TableColumn objects. The first object in the array must be named geometry and be of type points, lineStrings, polygons, or mixedGeometry.
134 {
135 "type": "A String", # The type of data stored in this column.
136 "name": "A String", # The column name.
137 },
138 ],
139 },
140 "description": "A String", # The description of this table, supplied by the author.
141 "processingStatus": "A String", # The processing status of this table.
142 "draftAccessList": "A String", # Deprecated: The name of an access list of the Map Editor type. The user on whose behalf the request is being sent must be an editor on that access list. Note: Google Maps Engine no longer uses access lists. For backward compatibility, the API still accepts access lists for projects that are already using access lists. If you created a GME account/project after July 14th, 2014, you will not be able to send API requests that include access lists. The API does not yet support the new permissions model. When you create a map via the API without specifying permissions, the account that created the map is the owner and has effective administrator access. Users can then use the Maps Engine user interface to adjust the permissions. This is a temporary workaround until the API supports the new permissions model. Read Add new users and groups in the Google Maps Engine help center for more information.
143 "projectId": "A String", # The ID of the project to which the table belongs.
144 "tags": [ # An array of text strings, with each string representing a tag. More information about tags can be found in the Tagging data article of the Maps Engine help center.
145 "A String",
146 ],
147 "creationTime": "A String", # The creation time of this table. The value is an RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z).
148 "sourceEncoding": "UTF-8", # Encoding of the uploaded files. Valid values include UTF-8, CP1251, ISO 8859-1, and Shift_JIS.
149 "etag": "A String", # The ETag, used to refer to the current version of the asset.
150 "bbox": [ # A rectangular bounding box which contains all of the data in this table. The numbers represent latitude and longitude in decimal degrees.
151 3.14,
152 ],
153 "lastModifiedTime": "A String", # The last modified time of this table. The value is an RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z).
154 "publishedAccessList": "A String", # Deprecated: The access list to whom view permissions are granted. The value must be the name of a Maps Engine access list of the Map Viewer type, and the user must be a viewer on that list. Read Share data, layers, and maps in the Google Maps Engine help center for more information.
155 "id": "A String", # A globally unique ID, used to refer to this table.
156 "name": "A String", # The name of this table, supplied by the author.
157}
158
159
160Returns:
161 An object of the form:
162
163 { # A collection of geographic features, and associated metadata.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]164 "files": [ # The files associated with this table.
165 { # A single File, which is a component of an Asset.
166 "size": "A String", # The size of the file in bytes.
167 "uploadStatus": "A String", # The upload status of the file.
168 "filename": "A String", # The name of the file.
169 },
170 ],
171 "schema": { # A schema indicating the properties which may be associated with features within a Table, and the types of those properties. # The schema for this table.
172 "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.
173 "primaryKey": "A String", # The name of the column that contains the unique identifier of a Feature.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame^]174 "columns": [ # An array of TableColumn objects. The first object in the array must be named geometry and be of type points, lineStrings, polygons, or mixedGeometry.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]175 {
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame^]176 "type": "A String", # The type of data stored in this column.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]177 "name": "A String", # The column name.
178 },
179 ],
180 },
181 "description": "A String", # The description of this table, supplied by the author.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame^]182 "processingStatus": "A String", # The processing status of this table.
183 "draftAccessList": "A String", # Deprecated: The name of an access list of the Map Editor type. The user on whose behalf the request is being sent must be an editor on that access list. Note: Google Maps Engine no longer uses access lists. For backward compatibility, the API still accepts access lists for projects that are already using access lists. If you created a GME account/project after July 14th, 2014, you will not be able to send API requests that include access lists. The API does not yet support the new permissions model. When you create a map via the API without specifying permissions, the account that created the map is the owner and has effective administrator access. Users can then use the Maps Engine user interface to adjust the permissions. This is a temporary workaround until the API supports the new permissions model. Read Add new users and groups in the Google Maps Engine help center for more information.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]184 "projectId": "A String", # The ID of the project to which the table belongs.
185 "tags": [ # An array of text strings, with each string representing a tag. More information about tags can be found in the Tagging data article of the Maps Engine help center.
186 "A String",
187 ],
188 "creationTime": "A String", # The creation time of this table. The value is an RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z).
189 "sourceEncoding": "UTF-8", # Encoding of the uploaded files. Valid values include UTF-8, CP1251, ISO 8859-1, and Shift_JIS.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame^]190 "etag": "A String", # The ETag, used to refer to the current version of the asset.
191 "bbox": [ # A rectangular bounding box which contains all of the data in this table. The numbers represent latitude and longitude in decimal degrees.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]192 3.14,
193 ],
194 "lastModifiedTime": "A String", # The last modified time of this table. The value is an RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z).
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame^]195 "publishedAccessList": "A String", # Deprecated: The access list to whom view permissions are granted. The value must be the name of a Maps Engine access list of the Map Viewer type, and the user must be a viewer on that list. Read Share data, layers, and maps in the Google Maps Engine help center for more information.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]196 "id": "A String", # A globally unique ID, used to refer to this table.
197 "name": "A String", # The name of this table, supplied by the author.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame^]198 }</pre>
199</div>
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]200
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame^]201<div class="method">
202 <code class="details" id="delete">delete(id)</code>
203 <pre>Delete a table.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]204
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame^]205Args:
206 id: string, The ID of the table. Only the table creator or project owner are permitted to delete. If the table is included in a layer, the request will fail. Remove it from all layers prior to deleting. (required)
207</pre>
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]208</div>
209
210<div class="method">
211 <code class="details" id="get">get(id, version=None)</code>
212 <pre>Return metadata for a particular table, including the schema.
213
214Args:
215 id: string, The ID of the table. (required)
216 version: string, A parameter
217 Allowed values
218 draft - The draft version.
219 published - The published version.
220
221Returns:
222 An object of the form:
223
224 { # A collection of geographic features, and associated metadata.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame^]225 "files": [ # The files associated with this table.
226 { # A single File, which is a component of an Asset.
227 "size": "A String", # The size of the file in bytes.
228 "uploadStatus": "A String", # The upload status of the file.
229 "filename": "A String", # The name of the file.
230 },
231 ],
232 "schema": { # A schema indicating the properties which may be associated with features within a Table, and the types of those properties. # The schema for this table.
233 "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.
234 "primaryKey": "A String", # The name of the column that contains the unique identifier of a Feature.
235 "columns": [ # An array of TableColumn objects. The first object in the array must be named geometry and be of type points, lineStrings, polygons, or mixedGeometry.
236 {
237 "type": "A String", # The type of data stored in this column.
238 "name": "A String", # The column name.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]239 },
240 ],
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame^]241 },
242 "description": "A String", # The description of this table, supplied by the author.
243 "processingStatus": "A String", # The processing status of this table.
244 "draftAccessList": "A String", # Deprecated: The name of an access list of the Map Editor type. The user on whose behalf the request is being sent must be an editor on that access list. Note: Google Maps Engine no longer uses access lists. For backward compatibility, the API still accepts access lists for projects that are already using access lists. If you created a GME account/project after July 14th, 2014, you will not be able to send API requests that include access lists. The API does not yet support the new permissions model. When you create a map via the API without specifying permissions, the account that created the map is the owner and has effective administrator access. Users can then use the Maps Engine user interface to adjust the permissions. This is a temporary workaround until the API supports the new permissions model. Read Add new users and groups in the Google Maps Engine help center for more information.
245 "projectId": "A String", # The ID of the project to which the table belongs.
246 "tags": [ # An array of text strings, with each string representing a tag. More information about tags can be found in the Tagging data article of the Maps Engine help center.
247 "A String",
248 ],
249 "creationTime": "A String", # The creation time of this table. The value is an RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z).
250 "sourceEncoding": "UTF-8", # Encoding of the uploaded files. Valid values include UTF-8, CP1251, ISO 8859-1, and Shift_JIS.
251 "etag": "A String", # The ETag, used to refer to the current version of the asset.
252 "bbox": [ # A rectangular bounding box which contains all of the data in this table. The numbers represent latitude and longitude in decimal degrees.
253 3.14,
254 ],
255 "lastModifiedTime": "A String", # The last modified time of this table. The value is an RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z).
256 "publishedAccessList": "A String", # Deprecated: The access list to whom view permissions are granted. The value must be the name of a Maps Engine access list of the Map Viewer type, and the user must be a viewer on that list. Read Share data, layers, and maps in the Google Maps Engine help center for more information.
257 "id": "A String", # A globally unique ID, used to refer to this table.
258 "name": "A String", # The name of this table, supplied by the author.
259 }</pre>
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]260</div>
261
262<div class="method">
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame^]263 <code class="details" id="list">list(modifiedAfter=None, createdAfter=None, tags=None, projectId=None, maxResults=None, pageToken=None, createdBefore=None, bbox=None, creatorEmail=None, modifiedBefore=None)</code>
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]264 <pre>Return all tables readable by the current user.
265
266Args:
267 modifiedAfter: string, An RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z). Returned assets will have been modified at or after this time.
268 createdAfter: string, An RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z). Returned assets will have been created at or after this time.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame^]269 tags: string, A comma separated list of tags. Returned assets will contain all the tags from the list.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]270 projectId: string, The ID of a Maps Engine project, used to filter the response. To list all available projects with their IDs, send a Projects: list request. You can also find your project ID as the value of the DashboardPlace:cid URL parameter when signed in to mapsengine.google.com.
271 maxResults: integer, The maximum number of items to include in a single response page. The maximum supported value is 100.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame^]272 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.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]273 createdBefore: string, An RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z). Returned assets will have been created at or before this time.
274 bbox: string, A bounding box, expressed as "west,south,east,north". If set, only assets which intersect this bounding box will be returned.
275 creatorEmail: string, An email address representing a user. Returned assets that have been created by the user associated with the provided email address.
276 modifiedBefore: string, An RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z). Returned assets will have been modified at or before this time.
277
278Returns:
279 An object of the form:
280
281 { # The response returned by a call to tables.List.
282 "nextPageToken": "A String", # Next page token.
283 "tables": [ # Resources returned.
284 { # A collection of geographic features, and associated metadata.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame^]285 "files": [ # The files associated with this table.
286 { # A single File, which is a component of an Asset.
287 "size": "A String", # The size of the file in bytes.
288 "uploadStatus": "A String", # The upload status of the file.
289 "filename": "A String", # The name of the file.
290 },
291 ],
292 "schema": { # A schema indicating the properties which may be associated with features within a Table, and the types of those properties. # The schema for this table.
293 "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.
294 "primaryKey": "A String", # The name of the column that contains the unique identifier of a Feature.
295 "columns": [ # An array of TableColumn objects. The first object in the array must be named geometry and be of type points, lineStrings, polygons, or mixedGeometry.
296 {
297 "type": "A String", # The type of data stored in this column.
298 "name": "A String", # The column name.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]299 },
300 ],
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]301 },
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame^]302 "description": "A String", # The description of this table, supplied by the author.
303 "processingStatus": "A String", # The processing status of this table.
304 "draftAccessList": "A String", # Deprecated: The name of an access list of the Map Editor type. The user on whose behalf the request is being sent must be an editor on that access list. Note: Google Maps Engine no longer uses access lists. For backward compatibility, the API still accepts access lists for projects that are already using access lists. If you created a GME account/project after July 14th, 2014, you will not be able to send API requests that include access lists. The API does not yet support the new permissions model. When you create a map via the API without specifying permissions, the account that created the map is the owner and has effective administrator access. Users can then use the Maps Engine user interface to adjust the permissions. This is a temporary workaround until the API supports the new permissions model. Read Add new users and groups in the Google Maps Engine help center for more information.
305 "projectId": "A String", # The ID of the project to which the table belongs.
306 "tags": [ # An array of text strings, with each string representing a tag. More information about tags can be found in the Tagging data article of the Maps Engine help center.
307 "A String",
308 ],
309 "creationTime": "A String", # The creation time of this table. The value is an RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z).
310 "sourceEncoding": "UTF-8", # Encoding of the uploaded files. Valid values include UTF-8, CP1251, ISO 8859-1, and Shift_JIS.
311 "etag": "A String", # The ETag, used to refer to the current version of the asset.
312 "bbox": [ # A rectangular bounding box which contains all of the data in this table. The numbers represent latitude and longitude in decimal degrees.
313 3.14,
314 ],
315 "lastModifiedTime": "A String", # The last modified time of this table. The value is an RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z).
316 "publishedAccessList": "A String", # Deprecated: The access list to whom view permissions are granted. The value must be the name of a Maps Engine access list of the Map Viewer type, and the user must be a viewer on that list. Read Share data, layers, and maps in the Google Maps Engine help center for more information.
317 "id": "A String", # A globally unique ID, used to refer to this table.
318 "name": "A String", # The name of this table, supplied by the author.
319 },
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]320 ],
321 }</pre>
322</div>
323
324<div class="method">
325 <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
326 <pre>Retrieves the next page of results.
327
328Args:
329 previous_request: The request for the previous page. (required)
330 previous_response: The response from the request for the previous page. (required)
331
332Returns:
333 A request object that you can call 'execute()' on to request the next
334 page. Returns None if there are no more items in the collection.
335 </pre>
336</div>
337
338<div class="method">
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame^]339 <code class="details" id="patch">patch(id, body)</code>
340 <pre>Mutate a table asset.
341
342Args:
343 id: string, The ID of the table. (required)
344 body: object, The request body. (required)
345 The object takes the form of:
346
347{ # A collection of geographic features, and associated metadata.
348 "files": [ # The files associated with this table.
349 { # A single File, which is a component of an Asset.
350 "size": "A String", # The size of the file in bytes.
351 "uploadStatus": "A String", # The upload status of the file.
352 "filename": "A String", # The name of the file.
353 },
354 ],
355 "schema": { # A schema indicating the properties which may be associated with features within a Table, and the types of those properties. # The schema for this table.
356 "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.
357 "primaryKey": "A String", # The name of the column that contains the unique identifier of a Feature.
358 "columns": [ # An array of TableColumn objects. The first object in the array must be named geometry and be of type points, lineStrings, polygons, or mixedGeometry.
359 {
360 "type": "A String", # The type of data stored in this column.
361 "name": "A String", # The column name.
362 },
363 ],
364 },
365 "description": "A String", # The description of this table, supplied by the author.
366 "processingStatus": "A String", # The processing status of this table.
367 "draftAccessList": "A String", # Deprecated: The name of an access list of the Map Editor type. The user on whose behalf the request is being sent must be an editor on that access list. Note: Google Maps Engine no longer uses access lists. For backward compatibility, the API still accepts access lists for projects that are already using access lists. If you created a GME account/project after July 14th, 2014, you will not be able to send API requests that include access lists. The API does not yet support the new permissions model. When you create a map via the API without specifying permissions, the account that created the map is the owner and has effective administrator access. Users can then use the Maps Engine user interface to adjust the permissions. This is a temporary workaround until the API supports the new permissions model. Read Add new users and groups in the Google Maps Engine help center for more information.
368 "projectId": "A String", # The ID of the project to which the table belongs.
369 "tags": [ # An array of text strings, with each string representing a tag. More information about tags can be found in the Tagging data article of the Maps Engine help center.
370 "A String",
371 ],
372 "creationTime": "A String", # The creation time of this table. The value is an RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z).
373 "sourceEncoding": "UTF-8", # Encoding of the uploaded files. Valid values include UTF-8, CP1251, ISO 8859-1, and Shift_JIS.
374 "etag": "A String", # The ETag, used to refer to the current version of the asset.
375 "bbox": [ # A rectangular bounding box which contains all of the data in this table. The numbers represent latitude and longitude in decimal degrees.
376 3.14,
377 ],
378 "lastModifiedTime": "A String", # The last modified time of this table. The value is an RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z).
379 "publishedAccessList": "A String", # Deprecated: The access list to whom view permissions are granted. The value must be the name of a Maps Engine access list of the Map Viewer type, and the user must be a viewer on that list. Read Share data, layers, and maps in the Google Maps Engine help center for more information.
380 "id": "A String", # A globally unique ID, used to refer to this table.
381 "name": "A String", # The name of this table, supplied by the author.
382}
383
384</pre>
385</div>
386
387<div class="method">
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]388 <code class="details" id="upload">upload(body)</code>
389 <pre>Create a placeholder table asset to which table files can be uploaded.
390Once the placeholder has been created, files are uploaded to the https://www.googleapis.com/upload/mapsengine/v1/tables/table_id/files endpoint.
391See Table Upload in the Developer's Guide or Table.files: insert in the reference documentation for more information.
392
393Args:
394 body: object, The request body. (required)
395 The object takes the form of:
396
397{ # A collection of geographic features, and associated metadata.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame^]398 "files": [ # The files associated with this table.
399 { # A single File, which is a component of an Asset.
400 "size": "A String", # The size of the file in bytes.
401 "uploadStatus": "A String", # The upload status of the file.
402 "filename": "A String", # The name of the file.
403 },
404 ],
405 "schema": { # A schema indicating the properties which may be associated with features within a Table, and the types of those properties. # The schema for this table.
406 "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.
407 "primaryKey": "A String", # The name of the column that contains the unique identifier of a Feature.
408 "columns": [ # An array of TableColumn objects. The first object in the array must be named geometry and be of type points, lineStrings, polygons, or mixedGeometry.
409 {
410 "type": "A String", # The type of data stored in this column.
411 "name": "A String", # The column name.
412 },
413 ],
414 },
415 "description": "A String", # The description of this table, supplied by the author.
416 "processingStatus": "A String", # The processing status of this table.
417 "draftAccessList": "A String", # Deprecated: The name of an access list of the Map Editor type. The user on whose behalf the request is being sent must be an editor on that access list. Note: Google Maps Engine no longer uses access lists. For backward compatibility, the API still accepts access lists for projects that are already using access lists. If you created a GME account/project after July 14th, 2014, you will not be able to send API requests that include access lists. The API does not yet support the new permissions model. When you create a map via the API without specifying permissions, the account that created the map is the owner and has effective administrator access. Users can then use the Maps Engine user interface to adjust the permissions. This is a temporary workaround until the API supports the new permissions model. Read Add new users and groups in the Google Maps Engine help center for more information.
418 "projectId": "A String", # The ID of the project to which the table belongs.
419 "tags": [ # An array of text strings, with each string representing a tag. More information about tags can be found in the Tagging data article of the Maps Engine help center.
420 "A String",
421 ],
422 "creationTime": "A String", # The creation time of this table. The value is an RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z).
423 "sourceEncoding": "UTF-8", # Encoding of the uploaded files. Valid values include UTF-8, CP1251, ISO 8859-1, and Shift_JIS.
424 "etag": "A String", # The ETag, used to refer to the current version of the asset.
425 "bbox": [ # A rectangular bounding box which contains all of the data in this table. The numbers represent latitude and longitude in decimal degrees.
426 3.14,
427 ],
428 "lastModifiedTime": "A String", # The last modified time of this table. The value is an RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z).
429 "publishedAccessList": "A String", # Deprecated: The access list to whom view permissions are granted. The value must be the name of a Maps Engine access list of the Map Viewer type, and the user must be a viewer on that list. Read Share data, layers, and maps in the Google Maps Engine help center for more information.
430 "id": "A String", # A globally unique ID, used to refer to this table.
431 "name": "A String", # The name of this table, supplied by the author.
432}
433
434
435Returns:
436 An object of the form:
437
438 { # A collection of geographic features, and associated metadata.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]439 "files": [ # The files associated with this table.
440 { # A single File, which is a component of an Asset.
441 "size": "A String", # The size of the file in bytes.
442 "uploadStatus": "A String", # The upload status of the file.
443 "filename": "A String", # The name of the file.
444 },
445 ],
446 "schema": { # A schema indicating the properties which may be associated with features within a Table, and the types of those properties. # The schema for this table.
447 "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.
448 "primaryKey": "A String", # The name of the column that contains the unique identifier of a Feature.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame^]449 "columns": [ # An array of TableColumn objects. The first object in the array must be named geometry and be of type points, lineStrings, polygons, or mixedGeometry.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]450 {
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame^]451 "type": "A String", # The type of data stored in this column.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]452 "name": "A String", # The column name.
453 },
454 ],
455 },
456 "description": "A String", # The description of this table, supplied by the author.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame^]457 "processingStatus": "A String", # The processing status of this table.
458 "draftAccessList": "A String", # Deprecated: The name of an access list of the Map Editor type. The user on whose behalf the request is being sent must be an editor on that access list. Note: Google Maps Engine no longer uses access lists. For backward compatibility, the API still accepts access lists for projects that are already using access lists. If you created a GME account/project after July 14th, 2014, you will not be able to send API requests that include access lists. The API does not yet support the new permissions model. When you create a map via the API without specifying permissions, the account that created the map is the owner and has effective administrator access. Users can then use the Maps Engine user interface to adjust the permissions. This is a temporary workaround until the API supports the new permissions model. Read Add new users and groups in the Google Maps Engine help center for more information.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]459 "projectId": "A String", # The ID of the project to which the table belongs.
460 "tags": [ # An array of text strings, with each string representing a tag. More information about tags can be found in the Tagging data article of the Maps Engine help center.
461 "A String",
462 ],
463 "creationTime": "A String", # The creation time of this table. The value is an RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z).
464 "sourceEncoding": "UTF-8", # Encoding of the uploaded files. Valid values include UTF-8, CP1251, ISO 8859-1, and Shift_JIS.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame^]465 "etag": "A String", # The ETag, used to refer to the current version of the asset.
466 "bbox": [ # A rectangular bounding box which contains all of the data in this table. The numbers represent latitude and longitude in decimal degrees.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]467 3.14,
468 ],
469 "lastModifiedTime": "A String", # The last modified time of this table. The value is an RFC 3339 formatted date-time value (e.g. 1970-01-01T00:00:00Z).
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame^]470 "publishedAccessList": "A String", # Deprecated: The access list to whom view permissions are granted. The value must be the name of a Maps Engine access list of the Map Viewer type, and the user must be a viewer on that list. Read Share data, layers, and maps in the Google Maps Engine help center for more information.
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]471 "id": "A String", # A globally unique ID, used to refer to this table.
472 "name": "A String", # The name of this table, supplied by the author.
Craig Citro065b5302014-08-14 00:47:23 -0700[diff] [blame^]473 }</pre>
John Asmuth614db982014-04-24 15:46:26 -0400[diff] [blame]474</div>
475
476</body></html>