google-apis-vectortile_v1 0.1.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +7 -0
- data/.yardopts +13 -0
- data/CHANGELOG.md +7 -0
- data/LICENSE.md +202 -0
- data/OVERVIEW.md +96 -0
- data/lib/google-apis-vectortile_v1.rb +15 -0
- data/lib/google/apis/vectortile_v1.rb +33 -0
- data/lib/google/apis/vectortile_v1/classes.rb +854 -0
- data/lib/google/apis/vectortile_v1/gem_version.rb +28 -0
- data/lib/google/apis/vectortile_v1/representations.rb +348 -0
- data/lib/google/apis/vectortile_v1/service.rb +257 -0
- metadata +76 -0
checksums.yaml
ADDED
@@ -0,0 +1,7 @@
|
|
1
|
+
---
|
2
|
+
SHA256:
|
3
|
+
metadata.gz: 2a7a42c64cf72434f32d268c12482b47133833e94ed98e432c485d968f25773f
|
4
|
+
data.tar.gz: 98780ebad3a4acd3aa5986595910e8423b7cb78c5bda6bb8154b7185cb8a62b4
|
5
|
+
SHA512:
|
6
|
+
metadata.gz: 05bf2d85ed2e0b8e57769388819f5ed51529ffa3f3b76f519a0dfa4870e73442f71dbac3e6c3f624063885db61c5b57e881e4b7a15314a438eeaba2a9e5b379d
|
7
|
+
data.tar.gz: c630fd67d46401c2fbe988e660bbef4114db25227d7215d6dba35502f98d9288d9c1e8d5327d776eab49144a9793f58bad6a43bae337ca14a1709d28a3dd9612
|
data/.yardopts
ADDED
@@ -0,0 +1,13 @@
|
|
1
|
+
--hide-void-return
|
2
|
+
--no-private
|
3
|
+
--verbose
|
4
|
+
--title=google-apis-vectortile_v1
|
5
|
+
--markup-provider=redcarpet
|
6
|
+
--markup=markdown
|
7
|
+
--main OVERVIEW.md
|
8
|
+
lib/google/apis/vectortile_v1/*.rb
|
9
|
+
lib/google/apis/vectortile_v1.rb
|
10
|
+
-
|
11
|
+
OVERVIEW.md
|
12
|
+
CHANGELOG.md
|
13
|
+
LICENSE.md
|
data/CHANGELOG.md
ADDED
data/LICENSE.md
ADDED
@@ -0,0 +1,202 @@
|
|
1
|
+
|
2
|
+
Apache License
|
3
|
+
Version 2.0, January 2004
|
4
|
+
http://www.apache.org/licenses/
|
5
|
+
|
6
|
+
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
|
7
|
+
|
8
|
+
1. Definitions.
|
9
|
+
|
10
|
+
"License" shall mean the terms and conditions for use, reproduction,
|
11
|
+
and distribution as defined by Sections 1 through 9 of this document.
|
12
|
+
|
13
|
+
"Licensor" shall mean the copyright owner or entity authorized by
|
14
|
+
the copyright owner that is granting the License.
|
15
|
+
|
16
|
+
"Legal Entity" shall mean the union of the acting entity and all
|
17
|
+
other entities that control, are controlled by, or are under common
|
18
|
+
control with that entity. For the purposes of this definition,
|
19
|
+
"control" means (i) the power, direct or indirect, to cause the
|
20
|
+
direction or management of such entity, whether by contract or
|
21
|
+
otherwise, or (ii) ownership of fifty percent (50%) or more of the
|
22
|
+
outstanding shares, or (iii) beneficial ownership of such entity.
|
23
|
+
|
24
|
+
"You" (or "Your") shall mean an individual or Legal Entity
|
25
|
+
exercising permissions granted by this License.
|
26
|
+
|
27
|
+
"Source" form shall mean the preferred form for making modifications,
|
28
|
+
including but not limited to software source code, documentation
|
29
|
+
source, and configuration files.
|
30
|
+
|
31
|
+
"Object" form shall mean any form resulting from mechanical
|
32
|
+
transformation or translation of a Source form, including but
|
33
|
+
not limited to compiled object code, generated documentation,
|
34
|
+
and conversions to other media types.
|
35
|
+
|
36
|
+
"Work" shall mean the work of authorship, whether in Source or
|
37
|
+
Object form, made available under the License, as indicated by a
|
38
|
+
copyright notice that is included in or attached to the work
|
39
|
+
(an example is provided in the Appendix below).
|
40
|
+
|
41
|
+
"Derivative Works" shall mean any work, whether in Source or Object
|
42
|
+
form, that is based on (or derived from) the Work and for which the
|
43
|
+
editorial revisions, annotations, elaborations, or other modifications
|
44
|
+
represent, as a whole, an original work of authorship. For the purposes
|
45
|
+
of this License, Derivative Works shall not include works that remain
|
46
|
+
separable from, or merely link (or bind by name) to the interfaces of,
|
47
|
+
the Work and Derivative Works thereof.
|
48
|
+
|
49
|
+
"Contribution" shall mean any work of authorship, including
|
50
|
+
the original version of the Work and any modifications or additions
|
51
|
+
to that Work or Derivative Works thereof, that is intentionally
|
52
|
+
submitted to Licensor for inclusion in the Work by the copyright owner
|
53
|
+
or by an individual or Legal Entity authorized to submit on behalf of
|
54
|
+
the copyright owner. For the purposes of this definition, "submitted"
|
55
|
+
means any form of electronic, verbal, or written communication sent
|
56
|
+
to the Licensor or its representatives, including but not limited to
|
57
|
+
communication on electronic mailing lists, source code control systems,
|
58
|
+
and issue tracking systems that are managed by, or on behalf of, the
|
59
|
+
Licensor for the purpose of discussing and improving the Work, but
|
60
|
+
excluding communication that is conspicuously marked or otherwise
|
61
|
+
designated in writing by the copyright owner as "Not a Contribution."
|
62
|
+
|
63
|
+
"Contributor" shall mean Licensor and any individual or Legal Entity
|
64
|
+
on behalf of whom a Contribution has been received by Licensor and
|
65
|
+
subsequently incorporated within the Work.
|
66
|
+
|
67
|
+
2. Grant of Copyright License. Subject to the terms and conditions of
|
68
|
+
this License, each Contributor hereby grants to You a perpetual,
|
69
|
+
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
70
|
+
copyright license to reproduce, prepare Derivative Works of,
|
71
|
+
publicly display, publicly perform, sublicense, and distribute the
|
72
|
+
Work and such Derivative Works in Source or Object form.
|
73
|
+
|
74
|
+
3. Grant of Patent License. Subject to the terms and conditions of
|
75
|
+
this License, each Contributor hereby grants to You a perpetual,
|
76
|
+
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
77
|
+
(except as stated in this section) patent license to make, have made,
|
78
|
+
use, offer to sell, sell, import, and otherwise transfer the Work,
|
79
|
+
where such license applies only to those patent claims licensable
|
80
|
+
by such Contributor that are necessarily infringed by their
|
81
|
+
Contribution(s) alone or by combination of their Contribution(s)
|
82
|
+
with the Work to which such Contribution(s) was submitted. If You
|
83
|
+
institute patent litigation against any entity (including a
|
84
|
+
cross-claim or counterclaim in a lawsuit) alleging that the Work
|
85
|
+
or a Contribution incorporated within the Work constitutes direct
|
86
|
+
or contributory patent infringement, then any patent licenses
|
87
|
+
granted to You under this License for that Work shall terminate
|
88
|
+
as of the date such litigation is filed.
|
89
|
+
|
90
|
+
4. Redistribution. You may reproduce and distribute copies of the
|
91
|
+
Work or Derivative Works thereof in any medium, with or without
|
92
|
+
modifications, and in Source or Object form, provided that You
|
93
|
+
meet the following conditions:
|
94
|
+
|
95
|
+
(a) You must give any other recipients of the Work or
|
96
|
+
Derivative Works a copy of this License; and
|
97
|
+
|
98
|
+
(b) You must cause any modified files to carry prominent notices
|
99
|
+
stating that You changed the files; and
|
100
|
+
|
101
|
+
(c) You must retain, in the Source form of any Derivative Works
|
102
|
+
that You distribute, all copyright, patent, trademark, and
|
103
|
+
attribution notices from the Source form of the Work,
|
104
|
+
excluding those notices that do not pertain to any part of
|
105
|
+
the Derivative Works; and
|
106
|
+
|
107
|
+
(d) If the Work includes a "NOTICE" text file as part of its
|
108
|
+
distribution, then any Derivative Works that You distribute must
|
109
|
+
include a readable copy of the attribution notices contained
|
110
|
+
within such NOTICE file, excluding those notices that do not
|
111
|
+
pertain to any part of the Derivative Works, in at least one
|
112
|
+
of the following places: within a NOTICE text file distributed
|
113
|
+
as part of the Derivative Works; within the Source form or
|
114
|
+
documentation, if provided along with the Derivative Works; or,
|
115
|
+
within a display generated by the Derivative Works, if and
|
116
|
+
wherever such third-party notices normally appear. The contents
|
117
|
+
of the NOTICE file are for informational purposes only and
|
118
|
+
do not modify the License. You may add Your own attribution
|
119
|
+
notices within Derivative Works that You distribute, alongside
|
120
|
+
or as an addendum to the NOTICE text from the Work, provided
|
121
|
+
that such additional attribution notices cannot be construed
|
122
|
+
as modifying the License.
|
123
|
+
|
124
|
+
You may add Your own copyright statement to Your modifications and
|
125
|
+
may provide additional or different license terms and conditions
|
126
|
+
for use, reproduction, or distribution of Your modifications, or
|
127
|
+
for any such Derivative Works as a whole, provided Your use,
|
128
|
+
reproduction, and distribution of the Work otherwise complies with
|
129
|
+
the conditions stated in this License.
|
130
|
+
|
131
|
+
5. Submission of Contributions. Unless You explicitly state otherwise,
|
132
|
+
any Contribution intentionally submitted for inclusion in the Work
|
133
|
+
by You to the Licensor shall be under the terms and conditions of
|
134
|
+
this License, without any additional terms or conditions.
|
135
|
+
Notwithstanding the above, nothing herein shall supersede or modify
|
136
|
+
the terms of any separate license agreement you may have executed
|
137
|
+
with Licensor regarding such Contributions.
|
138
|
+
|
139
|
+
6. Trademarks. This License does not grant permission to use the trade
|
140
|
+
names, trademarks, service marks, or product names of the Licensor,
|
141
|
+
except as required for reasonable and customary use in describing the
|
142
|
+
origin of the Work and reproducing the content of the NOTICE file.
|
143
|
+
|
144
|
+
7. Disclaimer of Warranty. Unless required by applicable law or
|
145
|
+
agreed to in writing, Licensor provides the Work (and each
|
146
|
+
Contributor provides its Contributions) on an "AS IS" BASIS,
|
147
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
148
|
+
implied, including, without limitation, any warranties or conditions
|
149
|
+
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
|
150
|
+
PARTICULAR PURPOSE. You are solely responsible for determining the
|
151
|
+
appropriateness of using or redistributing the Work and assume any
|
152
|
+
risks associated with Your exercise of permissions under this License.
|
153
|
+
|
154
|
+
8. Limitation of Liability. In no event and under no legal theory,
|
155
|
+
whether in tort (including negligence), contract, or otherwise,
|
156
|
+
unless required by applicable law (such as deliberate and grossly
|
157
|
+
negligent acts) or agreed to in writing, shall any Contributor be
|
158
|
+
liable to You for damages, including any direct, indirect, special,
|
159
|
+
incidental, or consequential damages of any character arising as a
|
160
|
+
result of this License or out of the use or inability to use the
|
161
|
+
Work (including but not limited to damages for loss of goodwill,
|
162
|
+
work stoppage, computer failure or malfunction, or any and all
|
163
|
+
other commercial damages or losses), even if such Contributor
|
164
|
+
has been advised of the possibility of such damages.
|
165
|
+
|
166
|
+
9. Accepting Warranty or Additional Liability. While redistributing
|
167
|
+
the Work or Derivative Works thereof, You may choose to offer,
|
168
|
+
and charge a fee for, acceptance of support, warranty, indemnity,
|
169
|
+
or other liability obligations and/or rights consistent with this
|
170
|
+
License. However, in accepting such obligations, You may act only
|
171
|
+
on Your own behalf and on Your sole responsibility, not on behalf
|
172
|
+
of any other Contributor, and only if You agree to indemnify,
|
173
|
+
defend, and hold each Contributor harmless for any liability
|
174
|
+
incurred by, or claims asserted against, such Contributor by reason
|
175
|
+
of your accepting any such warranty or additional liability.
|
176
|
+
|
177
|
+
END OF TERMS AND CONDITIONS
|
178
|
+
|
179
|
+
APPENDIX: How to apply the Apache License to your work.
|
180
|
+
|
181
|
+
To apply the Apache License to your work, attach the following
|
182
|
+
boilerplate notice, with the fields enclosed by brackets "[]"
|
183
|
+
replaced with your own identifying information. (Don't include
|
184
|
+
the brackets!) The text should be enclosed in the appropriate
|
185
|
+
comment syntax for the file format. We also recommend that a
|
186
|
+
file or class name and description of purpose be included on the
|
187
|
+
same "printed page" as the copyright notice for easier
|
188
|
+
identification within third-party archives.
|
189
|
+
|
190
|
+
Copyright [yyyy] [name of copyright owner]
|
191
|
+
|
192
|
+
Licensed under the Apache License, Version 2.0 (the "License");
|
193
|
+
you may not use this file except in compliance with the License.
|
194
|
+
You may obtain a copy of the License at
|
195
|
+
|
196
|
+
http://www.apache.org/licenses/LICENSE-2.0
|
197
|
+
|
198
|
+
Unless required by applicable law or agreed to in writing, software
|
199
|
+
distributed under the License is distributed on an "AS IS" BASIS,
|
200
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
201
|
+
See the License for the specific language governing permissions and
|
202
|
+
limitations under the License.
|
data/OVERVIEW.md
ADDED
@@ -0,0 +1,96 @@
|
|
1
|
+
# Simple REST client for version V1 of the Semantic Tile API
|
2
|
+
|
3
|
+
This is a simple client library for version V1 of the Semantic Tile API. It provides:
|
4
|
+
|
5
|
+
* A client object that connects to the HTTP/JSON REST endpoint for the service.
|
6
|
+
* Ruby objects for data structures related to the service.
|
7
|
+
* Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts.
|
8
|
+
* Control of retry, pagination, and timeouts.
|
9
|
+
|
10
|
+
Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information.
|
11
|
+
|
12
|
+
## Getting started
|
13
|
+
|
14
|
+
### Before you begin
|
15
|
+
|
16
|
+
There are a few setup steps you need to complete before you can use this library:
|
17
|
+
|
18
|
+
1. If you don't already have a Google account, [sign up](https://www.google.com/accounts).
|
19
|
+
2. If you have never created a Google APIs Console project, read about [Managing Projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects) and create a project in the [Google API Console](https://console.cloud.google.com/).
|
20
|
+
3. Most APIs need to be enabled for your project. [Enable it](https://console.cloud.google.com/apis/library/vectortile.googleapis.com) in the console.
|
21
|
+
|
22
|
+
### Installation
|
23
|
+
|
24
|
+
Add this line to your application's Gemfile:
|
25
|
+
|
26
|
+
```ruby
|
27
|
+
gem 'google-apis-vectortile_v1', '~> 0.1'
|
28
|
+
```
|
29
|
+
|
30
|
+
And then execute:
|
31
|
+
|
32
|
+
```
|
33
|
+
$ bundle
|
34
|
+
```
|
35
|
+
|
36
|
+
Or install it yourself as:
|
37
|
+
|
38
|
+
```
|
39
|
+
$ gem install google-apis-vectortile_v1
|
40
|
+
```
|
41
|
+
|
42
|
+
### Creating a client object
|
43
|
+
|
44
|
+
Once the gem is installed, you can load the client code and instantiate a client.
|
45
|
+
|
46
|
+
```ruby
|
47
|
+
# Load the client
|
48
|
+
require "google/apis/vectortile_v1"
|
49
|
+
|
50
|
+
# Create a client object
|
51
|
+
client = Google::Apis::VectortileV1::SemanticTileService.new
|
52
|
+
|
53
|
+
# Authenticate calls
|
54
|
+
client.authentication = # ... use the googleauth gem to create credentials
|
55
|
+
```
|
56
|
+
|
57
|
+
See the class reference docs for information on the methods you can call from a client.
|
58
|
+
|
59
|
+
## Documentation
|
60
|
+
|
61
|
+
More detailed descriptions of the Google simple REST clients are available in two documents.
|
62
|
+
|
63
|
+
* The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging.
|
64
|
+
* The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables.
|
65
|
+
|
66
|
+
(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Vectortile service in particular.)
|
67
|
+
|
68
|
+
For reference information on specific calls in the Semantic Tile API, see the {Google::Apis::VectortileV1::SemanticTileService class reference docs}.
|
69
|
+
|
70
|
+
## Which client should I use?
|
71
|
+
|
72
|
+
Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**.
|
73
|
+
|
74
|
+
This library, `google-apis-vectortile_v1`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-<servicename>_<serviceversion>`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward.
|
75
|
+
|
76
|
+
Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients.
|
77
|
+
|
78
|
+
Gem names for modern clients are often of the form `google-cloud-<service_name>`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud-<service_name>-<version>`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended.
|
79
|
+
|
80
|
+
**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure.
|
81
|
+
|
82
|
+
The [product documentation](https://developers.google.com/maps/contact-sales/) may provide guidance regarding the preferred client library to use.
|
83
|
+
|
84
|
+
## Supported Ruby versions
|
85
|
+
|
86
|
+
This library is supported on Ruby 2.5+.
|
87
|
+
|
88
|
+
Google provides official support for Ruby versions that are actively supported by Ruby Core -- that is, Ruby versions that are either in normal maintenance or in security maintenance, and not end of life. Currently, this means Ruby 2.5 and later. Older versions of Ruby _may_ still work, but are unsupported and not recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details about the Ruby support schedule.
|
89
|
+
|
90
|
+
## License
|
91
|
+
|
92
|
+
This library is licensed under Apache 2.0. Full license text is available in the {file:LICENSE.md LICENSE}.
|
93
|
+
|
94
|
+
## Support
|
95
|
+
|
96
|
+
Please [report bugs at the project on Github](https://github.com/google/google-api-ruby-client/issues). Don't hesitate to [ask questions](http://stackoverflow.com/questions/tagged/google-api-ruby-client) about the client or APIs on [StackOverflow](http://stackoverflow.com).
|
@@ -0,0 +1,15 @@
|
|
1
|
+
# Copyright 2020 Google LLC
|
2
|
+
#
|
3
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
4
|
+
# you may not use this file except in compliance with the License.
|
5
|
+
# You may obtain a copy of the License at
|
6
|
+
#
|
7
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
8
|
+
#
|
9
|
+
# Unless required by applicable law or agreed to in writing, software
|
10
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
11
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
12
|
+
# See the License for the specific language governing permissions and
|
13
|
+
# limitations under the License.
|
14
|
+
|
15
|
+
require "google/apis/vectortile_v1"
|
@@ -0,0 +1,33 @@
|
|
1
|
+
# Copyright 2020 Google LLC
|
2
|
+
#
|
3
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
4
|
+
# you may not use this file except in compliance with the License.
|
5
|
+
# You may obtain a copy of the License at
|
6
|
+
#
|
7
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
8
|
+
#
|
9
|
+
# Unless required by applicable law or agreed to in writing, software
|
10
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
11
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
12
|
+
# See the License for the specific language governing permissions and
|
13
|
+
# limitations under the License.
|
14
|
+
|
15
|
+
require 'google/apis/vectortile_v1/service.rb'
|
16
|
+
require 'google/apis/vectortile_v1/classes.rb'
|
17
|
+
require 'google/apis/vectortile_v1/representations.rb'
|
18
|
+
require 'google/apis/vectortile_v1/gem_version.rb'
|
19
|
+
|
20
|
+
module Google
|
21
|
+
module Apis
|
22
|
+
# Semantic Tile API
|
23
|
+
#
|
24
|
+
# Serves vector tiles containing geospatial data.
|
25
|
+
#
|
26
|
+
# @see https://developers.google.com/maps/contact-sales/
|
27
|
+
module VectortileV1
|
28
|
+
# Version of the Semantic Tile API this client connects to.
|
29
|
+
# This is NOT the gem version.
|
30
|
+
VERSION = 'V1'
|
31
|
+
end
|
32
|
+
end
|
33
|
+
end
|
@@ -0,0 +1,854 @@
|
|
1
|
+
# Copyright 2020 Google LLC
|
2
|
+
#
|
3
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
4
|
+
# you may not use this file except in compliance with the License.
|
5
|
+
# You may obtain a copy of the License at
|
6
|
+
#
|
7
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
8
|
+
#
|
9
|
+
# Unless required by applicable law or agreed to in writing, software
|
10
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
11
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
12
|
+
# See the License for the specific language governing permissions and
|
13
|
+
# limitations under the License.
|
14
|
+
|
15
|
+
require 'date'
|
16
|
+
require 'google/apis/core/base_service'
|
17
|
+
require 'google/apis/core/json_representation'
|
18
|
+
require 'google/apis/core/hashable'
|
19
|
+
require 'google/apis/errors'
|
20
|
+
|
21
|
+
module Google
|
22
|
+
module Apis
|
23
|
+
module VectortileV1
|
24
|
+
|
25
|
+
# Represents an area. Used to represent regions such as water, parks, etc. Next
|
26
|
+
# ID: 10
|
27
|
+
class Area
|
28
|
+
include Google::Apis::Core::Hashable
|
29
|
+
|
30
|
+
# Metadata necessary to determine the ordering of a particular basemap element
|
31
|
+
# relative to others. To render the basemap correctly, sort by z-plane, then z-
|
32
|
+
# grade, then z-within-grade.
|
33
|
+
# Corresponds to the JSON property `basemapZOrder`
|
34
|
+
# @return [Google::Apis::VectortileV1::BasemapZOrder]
|
35
|
+
attr_accessor :basemap_z_order
|
36
|
+
|
37
|
+
# True if the polygon is not entirely internal to the feature that it belongs to:
|
38
|
+
# that is, some of the edges are bordering another feature.
|
39
|
+
# Corresponds to the JSON property `hasExternalEdges`
|
40
|
+
# @return [Boolean]
|
41
|
+
attr_accessor :has_external_edges
|
42
|
+
alias_method :has_external_edges?, :has_external_edges
|
43
|
+
|
44
|
+
# When has_external_edges is true, the polygon has some edges that border
|
45
|
+
# another feature. This field indicates the internal edges that do not border
|
46
|
+
# another feature. Each value is an index into the vertices array, and denotes
|
47
|
+
# the start vertex of the internal edge (the next vertex in the boundary loop is
|
48
|
+
# the end of the edge). If the selected vertex is the last vertex in the
|
49
|
+
# boundary loop, then the edge between that vertex and the starting vertex of
|
50
|
+
# the loop is internal. This field may be used for styling. For example,
|
51
|
+
# building parapets could be placed only on the external edges of a building
|
52
|
+
# polygon, or water could be lighter colored near the external edges of a body
|
53
|
+
# of water. If has_external_edges is false, all edges are internal and this
|
54
|
+
# field will be empty.
|
55
|
+
# Corresponds to the JSON property `internalEdges`
|
56
|
+
# @return [Array<Fixnum>]
|
57
|
+
attr_accessor :internal_edges
|
58
|
+
|
59
|
+
# Identifies the boundary loops of the polygon. Only set for INDEXED_TRIANGLE
|
60
|
+
# polygons. Each value is an index into the vertices array indicating the
|
61
|
+
# beginning of a loop. For instance, values of [2, 5] would indicate loop_data
|
62
|
+
# contained 3 loops with indices 0-1, 2-4, and 5-end. This may be used in
|
63
|
+
# conjunction with the internal_edges field for styling polygon boundaries. Note
|
64
|
+
# that an edge may be on a polygon boundary but still internal to the feature.
|
65
|
+
# For example, a feature split across multiple tiles will have an internal
|
66
|
+
# polygon boundary edge along the edge of the tile.
|
67
|
+
# Corresponds to the JSON property `loopBreaks`
|
68
|
+
# @return [Array<Fixnum>]
|
69
|
+
attr_accessor :loop_breaks
|
70
|
+
|
71
|
+
# When the polygon encoding is of type INDEXED_TRIANGLES, this contains the
|
72
|
+
# indices of the triangle vertices in the vertex_offsets field. There are 3
|
73
|
+
# vertex indices per triangle.
|
74
|
+
# Corresponds to the JSON property `triangleIndices`
|
75
|
+
# @return [Array<Fixnum>]
|
76
|
+
attr_accessor :triangle_indices
|
77
|
+
|
78
|
+
# The polygon encoding type used for this area.
|
79
|
+
# Corresponds to the JSON property `type`
|
80
|
+
# @return [String]
|
81
|
+
attr_accessor :type
|
82
|
+
|
83
|
+
# 2D vertex list used for lines and areas. Each entry represents an offset from
|
84
|
+
# the previous one in local tile coordinates. The first entry is offset from (0,
|
85
|
+
# 0). For example, the list of vertices [(1,1), (2, 2), (1, 2)] would be encoded
|
86
|
+
# in vertex offsets as [(1, 1), (1, 1), (-1, 0)].
|
87
|
+
# Corresponds to the JSON property `vertexOffsets`
|
88
|
+
# @return [Google::Apis::VectortileV1::Vertex2DList]
|
89
|
+
attr_accessor :vertex_offsets
|
90
|
+
|
91
|
+
# The z-ordering of this area. Areas with a lower z-order should be rendered
|
92
|
+
# beneath areas with a higher z-order. This z-ordering does not imply anything
|
93
|
+
# about the altitude of the line relative to the ground, but it can be used to
|
94
|
+
# prevent z-fighting during rendering on the client. This z-ordering can only be
|
95
|
+
# used to compare areas, and cannot be compared with the z_order field in the
|
96
|
+
# Line message. The z-order may be negative or zero. Prefer Area.basemap_z_order.
|
97
|
+
# Corresponds to the JSON property `zOrder`
|
98
|
+
# @return [Fixnum]
|
99
|
+
attr_accessor :z_order
|
100
|
+
|
101
|
+
def initialize(**args)
|
102
|
+
update!(**args)
|
103
|
+
end
|
104
|
+
|
105
|
+
# Update properties of this object
|
106
|
+
def update!(**args)
|
107
|
+
@basemap_z_order = args[:basemap_z_order] if args.key?(:basemap_z_order)
|
108
|
+
@has_external_edges = args[:has_external_edges] if args.key?(:has_external_edges)
|
109
|
+
@internal_edges = args[:internal_edges] if args.key?(:internal_edges)
|
110
|
+
@loop_breaks = args[:loop_breaks] if args.key?(:loop_breaks)
|
111
|
+
@triangle_indices = args[:triangle_indices] if args.key?(:triangle_indices)
|
112
|
+
@type = args[:type] if args.key?(:type)
|
113
|
+
@vertex_offsets = args[:vertex_offsets] if args.key?(:vertex_offsets)
|
114
|
+
@z_order = args[:z_order] if args.key?(:z_order)
|
115
|
+
end
|
116
|
+
end
|
117
|
+
|
118
|
+
# Metadata necessary to determine the ordering of a particular basemap element
|
119
|
+
# relative to others. To render the basemap correctly, sort by z-plane, then z-
|
120
|
+
# grade, then z-within-grade.
|
121
|
+
class BasemapZOrder
|
122
|
+
include Google::Apis::Core::Hashable
|
123
|
+
|
124
|
+
# The second most significant component of the ordering of a component to be
|
125
|
+
# rendered onto the basemap.
|
126
|
+
# Corresponds to the JSON property `zGrade`
|
127
|
+
# @return [Fixnum]
|
128
|
+
attr_accessor :z_grade
|
129
|
+
|
130
|
+
# The most significant component of the ordering of a component to be rendered
|
131
|
+
# onto the basemap.
|
132
|
+
# Corresponds to the JSON property `zPlane`
|
133
|
+
# @return [Fixnum]
|
134
|
+
attr_accessor :z_plane
|
135
|
+
|
136
|
+
# The least significant component of the ordering of a component to be rendered
|
137
|
+
# onto the basemap.
|
138
|
+
# Corresponds to the JSON property `zWithinGrade`
|
139
|
+
# @return [Fixnum]
|
140
|
+
attr_accessor :z_within_grade
|
141
|
+
|
142
|
+
def initialize(**args)
|
143
|
+
update!(**args)
|
144
|
+
end
|
145
|
+
|
146
|
+
# Update properties of this object
|
147
|
+
def update!(**args)
|
148
|
+
@z_grade = args[:z_grade] if args.key?(:z_grade)
|
149
|
+
@z_plane = args[:z_plane] if args.key?(:z_plane)
|
150
|
+
@z_within_grade = args[:z_within_grade] if args.key?(:z_within_grade)
|
151
|
+
end
|
152
|
+
end
|
153
|
+
|
154
|
+
# Represents a height-extruded area: a 3D prism with a constant X-Y plane cross
|
155
|
+
# section. Used to represent extruded buildings. A single building may consist
|
156
|
+
# of several extruded areas. The min_z and max_z fields are scaled to the size
|
157
|
+
# of the tile. An extruded area with a max_z value of 4096 has the same height
|
158
|
+
# as the width of the tile that it is on.
|
159
|
+
class ExtrudedArea
|
160
|
+
include Google::Apis::Core::Hashable
|
161
|
+
|
162
|
+
# Represents an area. Used to represent regions such as water, parks, etc. Next
|
163
|
+
# ID: 10
|
164
|
+
# Corresponds to the JSON property `area`
|
165
|
+
# @return [Google::Apis::VectortileV1::Area]
|
166
|
+
attr_accessor :area
|
167
|
+
|
168
|
+
# The z-value in local tile coordinates where the extruded area ends.
|
169
|
+
# Corresponds to the JSON property `maxZ`
|
170
|
+
# @return [Fixnum]
|
171
|
+
attr_accessor :max_z
|
172
|
+
|
173
|
+
# The z-value in local tile coordinates where the extruded area begins. This is
|
174
|
+
# non-zero for extruded areas that begin off the ground. For example, a building
|
175
|
+
# with a skybridge may have an extruded area component with a non-zero min_z.
|
176
|
+
# Corresponds to the JSON property `minZ`
|
177
|
+
# @return [Fixnum]
|
178
|
+
attr_accessor :min_z
|
179
|
+
|
180
|
+
def initialize(**args)
|
181
|
+
update!(**args)
|
182
|
+
end
|
183
|
+
|
184
|
+
# Update properties of this object
|
185
|
+
def update!(**args)
|
186
|
+
@area = args[:area] if args.key?(:area)
|
187
|
+
@max_z = args[:max_z] if args.key?(:max_z)
|
188
|
+
@min_z = args[:min_z] if args.key?(:min_z)
|
189
|
+
end
|
190
|
+
end
|
191
|
+
|
192
|
+
# A feature representing a single geographic entity.
|
193
|
+
class Feature
|
194
|
+
include Google::Apis::Core::Hashable
|
195
|
+
|
196
|
+
# The localized name of this feature. Currently only returned for roads.
|
197
|
+
# Corresponds to the JSON property `displayName`
|
198
|
+
# @return [String]
|
199
|
+
attr_accessor :display_name
|
200
|
+
|
201
|
+
# Represents the geometry of a feature, that is, the shape that it has on the
|
202
|
+
# map. The local tile coordinate system has the origin at the north-west (upper-
|
203
|
+
# left) corner of the tile, and is scaled to 4096 units across each edge. The
|
204
|
+
# height (Z) axis has the same scale factor: an extruded area with a max_z value
|
205
|
+
# of 4096 has the same height as the width of the tile that it is on. There is
|
206
|
+
# no clipping boundary, so it is possible that some coordinates will lie outside
|
207
|
+
# the tile boundaries.
|
208
|
+
# Corresponds to the JSON property `geometry`
|
209
|
+
# @return [Google::Apis::VectortileV1::Geometry]
|
210
|
+
attr_accessor :geometry
|
211
|
+
|
212
|
+
# Place ID of this feature, suitable for use in Places API details requests.
|
213
|
+
# Corresponds to the JSON property `placeId`
|
214
|
+
# @return [String]
|
215
|
+
attr_accessor :place_id
|
216
|
+
|
217
|
+
# Relations to other features.
|
218
|
+
# Corresponds to the JSON property `relations`
|
219
|
+
# @return [Array<Google::Apis::VectortileV1::Relation>]
|
220
|
+
attr_accessor :relations
|
221
|
+
|
222
|
+
# Extra metadata relating to segments.
|
223
|
+
# Corresponds to the JSON property `segmentInfo`
|
224
|
+
# @return [Google::Apis::VectortileV1::SegmentInfo]
|
225
|
+
attr_accessor :segment_info
|
226
|
+
|
227
|
+
# The type of this feature.
|
228
|
+
# Corresponds to the JSON property `type`
|
229
|
+
# @return [String]
|
230
|
+
attr_accessor :type
|
231
|
+
|
232
|
+
def initialize(**args)
|
233
|
+
update!(**args)
|
234
|
+
end
|
235
|
+
|
236
|
+
# Update properties of this object
|
237
|
+
def update!(**args)
|
238
|
+
@display_name = args[:display_name] if args.key?(:display_name)
|
239
|
+
@geometry = args[:geometry] if args.key?(:geometry)
|
240
|
+
@place_id = args[:place_id] if args.key?(:place_id)
|
241
|
+
@relations = args[:relations] if args.key?(:relations)
|
242
|
+
@segment_info = args[:segment_info] if args.key?(:segment_info)
|
243
|
+
@type = args[:type] if args.key?(:type)
|
244
|
+
end
|
245
|
+
end
|
246
|
+
|
247
|
+
# A tile containing information about the map features located in the region it
|
248
|
+
# covers.
|
249
|
+
class FeatureTile
|
250
|
+
include Google::Apis::Core::Hashable
|
251
|
+
|
252
|
+
# Global tile coordinates. Global tile coordinates reference a specific tile on
|
253
|
+
# the map at a specific zoom level. The origin of this coordinate system is
|
254
|
+
# always at the northwest corner of the map, with x values increasing from west
|
255
|
+
# to east and y values increasing from north to south. Tiles are indexed using x,
|
256
|
+
# y coordinates from that origin. The zoom level containing the entire world in
|
257
|
+
# a tile is 0, and it increases as you zoom in. Zoom level n + 1 will contain 4
|
258
|
+
# times as many tiles as zoom level n. The zoom level controls the level of
|
259
|
+
# detail of the data that is returned. In particular, this affects the set of
|
260
|
+
# feature types returned, their density, and geometry simplification. The exact
|
261
|
+
# tile contents may change over time, but care will be taken to keep supporting
|
262
|
+
# the most important use cases. For example, zoom level 15 shows roads for
|
263
|
+
# orientation and planning in the local neighborhood and zoom level 17 shows
|
264
|
+
# buildings to give users on foot a sense of situational awareness.
|
265
|
+
# Corresponds to the JSON property `coordinates`
|
266
|
+
# @return [Google::Apis::VectortileV1::TileCoordinates]
|
267
|
+
attr_accessor :coordinates
|
268
|
+
|
269
|
+
# Features present on this map tile.
|
270
|
+
# Corresponds to the JSON property `features`
|
271
|
+
# @return [Array<Google::Apis::VectortileV1::Feature>]
|
272
|
+
attr_accessor :features
|
273
|
+
|
274
|
+
# Resource name of the tile. The tile resource name is prefixed by its
|
275
|
+
# collection ID `tiles/` followed by the resource ID, which encodes the tile's
|
276
|
+
# global x and y coordinates and zoom level as `@,,z`. For example, `tiles/@1,2,
|
277
|
+
# 3z`.
|
278
|
+
# Corresponds to the JSON property `name`
|
279
|
+
# @return [String]
|
280
|
+
attr_accessor :name
|
281
|
+
|
282
|
+
# Data providers for the data contained in this tile.
|
283
|
+
# Corresponds to the JSON property `providers`
|
284
|
+
# @return [Array<Google::Apis::VectortileV1::ProviderInfo>]
|
285
|
+
attr_accessor :providers
|
286
|
+
|
287
|
+
# Tile response status code to support tile caching.
|
288
|
+
# Corresponds to the JSON property `status`
|
289
|
+
# @return [String]
|
290
|
+
attr_accessor :status
|
291
|
+
|
292
|
+
# An opaque value, usually less than 30 characters, that contains version info
|
293
|
+
# about this tile and the data that was used to generate it. The client should
|
294
|
+
# store this value in its tile cache and pass it back to the API in the
|
295
|
+
# client_tile_version_id field of subsequent tile requests in order to enable
|
296
|
+
# the API to detect when the new tile would be the same as the one the client
|
297
|
+
# already has in its cache. Also see STATUS_OK_DATA_UNCHANGED.
|
298
|
+
# Corresponds to the JSON property `versionId`
|
299
|
+
# @return [String]
|
300
|
+
attr_accessor :version_id
|
301
|
+
|
302
|
+
def initialize(**args)
|
303
|
+
update!(**args)
|
304
|
+
end
|
305
|
+
|
306
|
+
# Update properties of this object
|
307
|
+
def update!(**args)
|
308
|
+
@coordinates = args[:coordinates] if args.key?(:coordinates)
|
309
|
+
@features = args[:features] if args.key?(:features)
|
310
|
+
@name = args[:name] if args.key?(:name)
|
311
|
+
@providers = args[:providers] if args.key?(:providers)
|
312
|
+
@status = args[:status] if args.key?(:status)
|
313
|
+
@version_id = args[:version_id] if args.key?(:version_id)
|
314
|
+
end
|
315
|
+
end
|
316
|
+
|
317
|
+
# A packed representation of a 2D grid of uniformly spaced points containing
|
318
|
+
# elevation data. Each point within the grid represents the altitude in meters
|
319
|
+
# above average sea level at that location within the tile. Elevations provided
|
320
|
+
# are (generally) relative to the EGM96 geoid, however some areas will be
|
321
|
+
# relative to NAVD88. EGM96 and NAVD88 are off by no more than 2 meters. The
|
322
|
+
# grid is oriented north-west to south-east, as illustrated: rows[0].a[0] rows[0]
|
323
|
+
# .a[m] +-----------------+ | | | N | | ^ | | | | | W <-----> E | | | | | v | |
|
324
|
+
# S | | | +-----------------+ rows[n].a[0] rows[n].a[m] Rather than storing the
|
325
|
+
# altitudes directly, we store the diffs between them as integers at some
|
326
|
+
# requested level of precision to take advantage of integer packing. The actual
|
327
|
+
# altitude values a[] can be reconstructed using the scale and each row's
|
328
|
+
# first_altitude and altitude_diff fields.
|
329
|
+
class FirstDerivativeElevationGrid
|
330
|
+
include Google::Apis::Core::Hashable
|
331
|
+
|
332
|
+
# A multiplier applied to the altitude fields below to extract the actual
|
333
|
+
# altitudes in meters from the elevation grid.
|
334
|
+
# Corresponds to the JSON property `altitudeMultiplier`
|
335
|
+
# @return [Float]
|
336
|
+
attr_accessor :altitude_multiplier
|
337
|
+
|
338
|
+
# Rows of points containing altitude data making up the elevation grid. Each row
|
339
|
+
# is the same length. Rows are ordered from north to south. E.g: rows[0] is the
|
340
|
+
# north-most row, and rows[n] is the south-most row.
|
341
|
+
# Corresponds to the JSON property `rows`
|
342
|
+
# @return [Array<Google::Apis::VectortileV1::Row>]
|
343
|
+
attr_accessor :rows
|
344
|
+
|
345
|
+
def initialize(**args)
|
346
|
+
update!(**args)
|
347
|
+
end
|
348
|
+
|
349
|
+
# Update properties of this object
|
350
|
+
def update!(**args)
|
351
|
+
@altitude_multiplier = args[:altitude_multiplier] if args.key?(:altitude_multiplier)
|
352
|
+
@rows = args[:rows] if args.key?(:rows)
|
353
|
+
end
|
354
|
+
end
|
355
|
+
|
356
|
+
# Represents the geometry of a feature, that is, the shape that it has on the
|
357
|
+
# map. The local tile coordinate system has the origin at the north-west (upper-
|
358
|
+
# left) corner of the tile, and is scaled to 4096 units across each edge. The
|
359
|
+
# height (Z) axis has the same scale factor: an extruded area with a max_z value
|
360
|
+
# of 4096 has the same height as the width of the tile that it is on. There is
|
361
|
+
# no clipping boundary, so it is possible that some coordinates will lie outside
|
362
|
+
# the tile boundaries.
|
363
|
+
class Geometry
|
364
|
+
include Google::Apis::Core::Hashable
|
365
|
+
|
366
|
+
# The areas present in this geometry.
|
367
|
+
# Corresponds to the JSON property `areas`
|
368
|
+
# @return [Array<Google::Apis::VectortileV1::Area>]
|
369
|
+
attr_accessor :areas
|
370
|
+
|
371
|
+
# The extruded areas present in this geometry.
|
372
|
+
# Corresponds to the JSON property `extrudedAreas`
|
373
|
+
# @return [Array<Google::Apis::VectortileV1::ExtrudedArea>]
|
374
|
+
attr_accessor :extruded_areas
|
375
|
+
|
376
|
+
# The lines present in this geometry.
|
377
|
+
# Corresponds to the JSON property `lines`
|
378
|
+
# @return [Array<Google::Apis::VectortileV1::Line>]
|
379
|
+
attr_accessor :lines
|
380
|
+
|
381
|
+
# The modeled volumes present in this geometry.
|
382
|
+
# Corresponds to the JSON property `modeledVolumes`
|
383
|
+
# @return [Array<Google::Apis::VectortileV1::ModeledVolume>]
|
384
|
+
attr_accessor :modeled_volumes
|
385
|
+
|
386
|
+
def initialize(**args)
|
387
|
+
update!(**args)
|
388
|
+
end
|
389
|
+
|
390
|
+
# Update properties of this object
|
391
|
+
def update!(**args)
|
392
|
+
@areas = args[:areas] if args.key?(:areas)
|
393
|
+
@extruded_areas = args[:extruded_areas] if args.key?(:extruded_areas)
|
394
|
+
@lines = args[:lines] if args.key?(:lines)
|
395
|
+
@modeled_volumes = args[:modeled_volumes] if args.key?(:modeled_volumes)
|
396
|
+
end
|
397
|
+
end
|
398
|
+
|
399
|
+
# Represents a 2D polyline. Used to represent segments such as roads, train
|
400
|
+
# tracks, etc.
|
401
|
+
class Line
|
402
|
+
include Google::Apis::Core::Hashable
|
403
|
+
|
404
|
+
# Metadata necessary to determine the ordering of a particular basemap element
|
405
|
+
# relative to others. To render the basemap correctly, sort by z-plane, then z-
|
406
|
+
# grade, then z-within-grade.
|
407
|
+
# Corresponds to the JSON property `basemapZOrder`
|
408
|
+
# @return [Google::Apis::VectortileV1::BasemapZOrder]
|
409
|
+
attr_accessor :basemap_z_order
|
410
|
+
|
411
|
+
# 2D vertex list used for lines and areas. Each entry represents an offset from
|
412
|
+
# the previous one in local tile coordinates. The first entry is offset from (0,
|
413
|
+
# 0). For example, the list of vertices [(1,1), (2, 2), (1, 2)] would be encoded
|
414
|
+
# in vertex offsets as [(1, 1), (1, 1), (-1, 0)].
|
415
|
+
# Corresponds to the JSON property `vertexOffsets`
|
416
|
+
# @return [Google::Apis::VectortileV1::Vertex2DList]
|
417
|
+
attr_accessor :vertex_offsets
|
418
|
+
|
419
|
+
# The z-order of the line. Lines with a lower z-order should be rendered beneath
|
420
|
+
# lines with a higher z-order. This z-ordering does not imply anything about the
|
421
|
+
# altitude of the area relative to the ground, but it can be used to prevent z-
|
422
|
+
# fighting during rendering on the client. In general, larger and more important
|
423
|
+
# road features will have a higher z-order line associated with them. This z-
|
424
|
+
# ordering can only be used to compare lines, and cannot be compared with the
|
425
|
+
# z_order field in the Area message. The z-order may be negative or zero. Prefer
|
426
|
+
# Line.basemap_z_order.
|
427
|
+
# Corresponds to the JSON property `zOrder`
|
428
|
+
# @return [Fixnum]
|
429
|
+
attr_accessor :z_order
|
430
|
+
|
431
|
+
def initialize(**args)
|
432
|
+
update!(**args)
|
433
|
+
end
|
434
|
+
|
435
|
+
# Update properties of this object
|
436
|
+
def update!(**args)
|
437
|
+
@basemap_z_order = args[:basemap_z_order] if args.key?(:basemap_z_order)
|
438
|
+
@vertex_offsets = args[:vertex_offsets] if args.key?(:vertex_offsets)
|
439
|
+
@z_order = args[:z_order] if args.key?(:z_order)
|
440
|
+
end
|
441
|
+
end
|
442
|
+
|
443
|
+
# Represents a modeled volume in 3D space. Used to represent 3D buildings.
|
444
|
+
class ModeledVolume
|
445
|
+
include Google::Apis::Core::Hashable
|
446
|
+
|
447
|
+
# The triangle strips present in this mesh.
|
448
|
+
# Corresponds to the JSON property `strips`
|
449
|
+
# @return [Array<Google::Apis::VectortileV1::TriangleStrip>]
|
450
|
+
attr_accessor :strips
|
451
|
+
|
452
|
+
# 3D vertex list used for modeled volumes. Each entry represents an offset from
|
453
|
+
# the previous one in local tile coordinates. The first coordinate is offset
|
454
|
+
# from (0, 0, 0).
|
455
|
+
# Corresponds to the JSON property `vertexOffsets`
|
456
|
+
# @return [Google::Apis::VectortileV1::Vertex3DList]
|
457
|
+
attr_accessor :vertex_offsets
|
458
|
+
|
459
|
+
def initialize(**args)
|
460
|
+
update!(**args)
|
461
|
+
end
|
462
|
+
|
463
|
+
# Update properties of this object
|
464
|
+
def update!(**args)
|
465
|
+
@strips = args[:strips] if args.key?(:strips)
|
466
|
+
@vertex_offsets = args[:vertex_offsets] if args.key?(:vertex_offsets)
|
467
|
+
end
|
468
|
+
end
|
469
|
+
|
470
|
+
# Information about the data providers that should be included in the
|
471
|
+
# attribution string shown by the client.
|
472
|
+
class ProviderInfo
|
473
|
+
include Google::Apis::Core::Hashable
|
474
|
+
|
475
|
+
# Attribution string for this provider. This string is not localized.
|
476
|
+
# Corresponds to the JSON property `description`
|
477
|
+
# @return [String]
|
478
|
+
attr_accessor :description
|
479
|
+
|
480
|
+
def initialize(**args)
|
481
|
+
update!(**args)
|
482
|
+
end
|
483
|
+
|
484
|
+
# Update properties of this object
|
485
|
+
def update!(**args)
|
486
|
+
@description = args[:description] if args.key?(:description)
|
487
|
+
end
|
488
|
+
end
|
489
|
+
|
490
|
+
# Represents a relation to another feature in the tile. For example, a building
|
491
|
+
# might be occupied by a given POI. The related feature can be retrieved using
|
492
|
+
# the related feature index.
|
493
|
+
class Relation
|
494
|
+
include Google::Apis::Core::Hashable
|
495
|
+
|
496
|
+
# Zero-based index to look up the related feature from the list of features in
|
497
|
+
# the tile.
|
498
|
+
# Corresponds to the JSON property `relatedFeatureIndex`
|
499
|
+
# @return [Fixnum]
|
500
|
+
attr_accessor :related_feature_index
|
501
|
+
|
502
|
+
# Relation type between the origin feature to the related feature.
|
503
|
+
# Corresponds to the JSON property `relationType`
|
504
|
+
# @return [String]
|
505
|
+
attr_accessor :relation_type
|
506
|
+
|
507
|
+
def initialize(**args)
|
508
|
+
update!(**args)
|
509
|
+
end
|
510
|
+
|
511
|
+
# Update properties of this object
|
512
|
+
def update!(**args)
|
513
|
+
@related_feature_index = args[:related_feature_index] if args.key?(:related_feature_index)
|
514
|
+
@relation_type = args[:relation_type] if args.key?(:relation_type)
|
515
|
+
end
|
516
|
+
end
|
517
|
+
|
518
|
+
# Extra metadata relating to roads.
|
519
|
+
class RoadInfo
|
520
|
+
include Google::Apis::Core::Hashable
|
521
|
+
|
522
|
+
# Road has signage discouraging or prohibiting use by the general public. E.g.,
|
523
|
+
# roads with signs that say "Private", or "No trespassing."
|
524
|
+
# Corresponds to the JSON property `isPrivate`
|
525
|
+
# @return [Boolean]
|
526
|
+
attr_accessor :is_private
|
527
|
+
alias_method :is_private?, :is_private
|
528
|
+
|
529
|
+
def initialize(**args)
|
530
|
+
update!(**args)
|
531
|
+
end
|
532
|
+
|
533
|
+
# Update properties of this object
|
534
|
+
def update!(**args)
|
535
|
+
@is_private = args[:is_private] if args.key?(:is_private)
|
536
|
+
end
|
537
|
+
end
|
538
|
+
|
539
|
+
# A row of altitude points in the elevation grid, ordered from west to east.
|
540
|
+
class Row
|
541
|
+
include Google::Apis::Core::Hashable
|
542
|
+
|
543
|
+
# The difference between each successive pair of altitudes, from west to east.
|
544
|
+
# The first, westmost point, is just the altitude rather than a diff. The units
|
545
|
+
# are specified by the altitude_multiplier parameter above; the value in meters
|
546
|
+
# is given by altitude_multiplier * altitude_diffs[n]. The altitude row (in
|
547
|
+
# metres above sea level) can be reconstructed with: a[0] = altitude_diffs[0] *
|
548
|
+
# altitude_multiplier when n > 0, a[n] = a[n-1] + altitude_diffs[n-1] *
|
549
|
+
# altitude_multiplier.
|
550
|
+
# Corresponds to the JSON property `altitudeDiffs`
|
551
|
+
# @return [Array<Fixnum>]
|
552
|
+
attr_accessor :altitude_diffs
|
553
|
+
|
554
|
+
def initialize(**args)
|
555
|
+
update!(**args)
|
556
|
+
end
|
557
|
+
|
558
|
+
# Update properties of this object
|
559
|
+
def update!(**args)
|
560
|
+
@altitude_diffs = args[:altitude_diffs] if args.key?(:altitude_diffs)
|
561
|
+
end
|
562
|
+
end
|
563
|
+
|
564
|
+
# A packed representation of a 2D grid of uniformly spaced points containing
|
565
|
+
# elevation data. Each point within the grid represents the altitude in meters
|
566
|
+
# above average sea level at that location within the tile. Elevations provided
|
567
|
+
# are (generally) relative to the EGM96 geoid, however some areas will be
|
568
|
+
# relative to NAVD88. EGM96 and NAVD88 are off by no more than 2 meters. The
|
569
|
+
# grid is oriented north-west to south-east, as illustrated: rows[0].a[0] rows[0]
|
570
|
+
# .a[m] +-----------------+ | | | N | | ^ | | | | | W <-----> E | | | | | v | |
|
571
|
+
# S | | | +-----------------+ rows[n].a[0] rows[n].a[m] Rather than storing the
|
572
|
+
# altitudes directly, we store the diffs of the diffs between them as integers
|
573
|
+
# at some requested level of precision to take advantage of integer packing.
|
574
|
+
# Note that the data is packed in such a way that is fast to decode in Unity and
|
575
|
+
# that further optimizes wire size.
|
576
|
+
class SecondDerivativeElevationGrid
|
577
|
+
include Google::Apis::Core::Hashable
|
578
|
+
|
579
|
+
# A multiplier applied to the elements in the encoded data to extract the actual
|
580
|
+
# altitudes in meters.
|
581
|
+
# Corresponds to the JSON property `altitudeMultiplier`
|
582
|
+
# @return [Float]
|
583
|
+
attr_accessor :altitude_multiplier
|
584
|
+
|
585
|
+
# The number of columns included in the encoded elevation data (i.e. the
|
586
|
+
# horizontal resolution of the grid).
|
587
|
+
# Corresponds to the JSON property `columnCount`
|
588
|
+
# @return [Fixnum]
|
589
|
+
attr_accessor :column_count
|
590
|
+
|
591
|
+
# A stream of elements each representing a point on the tile running across each
|
592
|
+
# row from left to right, top to bottom. There will be precisely
|
593
|
+
# horizontal_resolution * vertical_resolution elements in the stream. The
|
594
|
+
# elements are not the heights, rather the second order derivative of the values
|
595
|
+
# one would expect in a stream of height data. Each element is a varint with the
|
596
|
+
# following encoding: -----------------------------------------------------------
|
597
|
+
# -------------| | Head Nibble | ------------------------------------------------
|
598
|
+
# ------------------------| | Bit 0 | Bit 1 | Bits 2-3 | | Terminator| Sign (1=
|
599
|
+
# neg) | Least significant 2 bits of absolute error | ---------------------------
|
600
|
+
# ---------------------------------------------| | Tail Nibble #1 | -------------
|
601
|
+
# -----------------------------------------------------------| | Bit 0 | Bit 1-3
|
602
|
+
# | | Terminator| Least significant 3 bits of absolute error | ------------------
|
603
|
+
# ------------------------------------------------------| | ... | Tail Nibble #n
|
604
|
+
# | ------------------------------------------------------------------------| |
|
605
|
+
# Bit 0 | Bit 1-3 | | Terminator| Least significant 3 bits of absolute error | --
|
606
|
+
# ----------------------------------------------------------------------|
|
607
|
+
# Corresponds to the JSON property `encodedData`
|
608
|
+
# NOTE: Values are automatically base64 encoded/decoded in the client library.
|
609
|
+
# @return [String]
|
610
|
+
attr_accessor :encoded_data
|
611
|
+
|
612
|
+
# The number of rows included in the encoded elevation data (i.e. the vertical
|
613
|
+
# resolution of the grid).
|
614
|
+
# Corresponds to the JSON property `rowCount`
|
615
|
+
# @return [Fixnum]
|
616
|
+
attr_accessor :row_count
|
617
|
+
|
618
|
+
def initialize(**args)
|
619
|
+
update!(**args)
|
620
|
+
end
|
621
|
+
|
622
|
+
# Update properties of this object
|
623
|
+
def update!(**args)
|
624
|
+
@altitude_multiplier = args[:altitude_multiplier] if args.key?(:altitude_multiplier)
|
625
|
+
@column_count = args[:column_count] if args.key?(:column_count)
|
626
|
+
@encoded_data = args[:encoded_data] if args.key?(:encoded_data)
|
627
|
+
@row_count = args[:row_count] if args.key?(:row_count)
|
628
|
+
end
|
629
|
+
end
|
630
|
+
|
631
|
+
# Extra metadata relating to segments.
|
632
|
+
class SegmentInfo
|
633
|
+
include Google::Apis::Core::Hashable
|
634
|
+
|
635
|
+
# Extra metadata relating to roads.
|
636
|
+
# Corresponds to the JSON property `roadInfo`
|
637
|
+
# @return [Google::Apis::VectortileV1::RoadInfo]
|
638
|
+
attr_accessor :road_info
|
639
|
+
|
640
|
+
def initialize(**args)
|
641
|
+
update!(**args)
|
642
|
+
end
|
643
|
+
|
644
|
+
# Update properties of this object
|
645
|
+
def update!(**args)
|
646
|
+
@road_info = args[:road_info] if args.key?(:road_info)
|
647
|
+
end
|
648
|
+
end
|
649
|
+
|
650
|
+
# A tile containing information about the terrain located in the region it
|
651
|
+
# covers.
|
652
|
+
class TerrainTile
|
653
|
+
include Google::Apis::Core::Hashable
|
654
|
+
|
655
|
+
# Global tile coordinates. Global tile coordinates reference a specific tile on
|
656
|
+
# the map at a specific zoom level. The origin of this coordinate system is
|
657
|
+
# always at the northwest corner of the map, with x values increasing from west
|
658
|
+
# to east and y values increasing from north to south. Tiles are indexed using x,
|
659
|
+
# y coordinates from that origin. The zoom level containing the entire world in
|
660
|
+
# a tile is 0, and it increases as you zoom in. Zoom level n + 1 will contain 4
|
661
|
+
# times as many tiles as zoom level n. The zoom level controls the level of
|
662
|
+
# detail of the data that is returned. In particular, this affects the set of
|
663
|
+
# feature types returned, their density, and geometry simplification. The exact
|
664
|
+
# tile contents may change over time, but care will be taken to keep supporting
|
665
|
+
# the most important use cases. For example, zoom level 15 shows roads for
|
666
|
+
# orientation and planning in the local neighborhood and zoom level 17 shows
|
667
|
+
# buildings to give users on foot a sense of situational awareness.
|
668
|
+
# Corresponds to the JSON property `coordinates`
|
669
|
+
# @return [Google::Apis::VectortileV1::TileCoordinates]
|
670
|
+
attr_accessor :coordinates
|
671
|
+
|
672
|
+
# A packed representation of a 2D grid of uniformly spaced points containing
|
673
|
+
# elevation data. Each point within the grid represents the altitude in meters
|
674
|
+
# above average sea level at that location within the tile. Elevations provided
|
675
|
+
# are (generally) relative to the EGM96 geoid, however some areas will be
|
676
|
+
# relative to NAVD88. EGM96 and NAVD88 are off by no more than 2 meters. The
|
677
|
+
# grid is oriented north-west to south-east, as illustrated: rows[0].a[0] rows[0]
|
678
|
+
# .a[m] +-----------------+ | | | N | | ^ | | | | | W <-----> E | | | | | v | |
|
679
|
+
# S | | | +-----------------+ rows[n].a[0] rows[n].a[m] Rather than storing the
|
680
|
+
# altitudes directly, we store the diffs between them as integers at some
|
681
|
+
# requested level of precision to take advantage of integer packing. The actual
|
682
|
+
# altitude values a[] can be reconstructed using the scale and each row's
|
683
|
+
# first_altitude and altitude_diff fields.
|
684
|
+
# Corresponds to the JSON property `firstDerivative`
|
685
|
+
# @return [Google::Apis::VectortileV1::FirstDerivativeElevationGrid]
|
686
|
+
attr_accessor :first_derivative
|
687
|
+
|
688
|
+
# Resource name of the tile. The tile resource name is prefixed by its
|
689
|
+
# collection ID `terrain/` followed by the resource ID, which encodes the tile's
|
690
|
+
# global x and y coordinates and zoom level as `@,,z`. For example, `terrain/@1,
|
691
|
+
# 2,3z`.
|
692
|
+
# Corresponds to the JSON property `name`
|
693
|
+
# @return [String]
|
694
|
+
attr_accessor :name
|
695
|
+
|
696
|
+
# A packed representation of a 2D grid of uniformly spaced points containing
|
697
|
+
# elevation data. Each point within the grid represents the altitude in meters
|
698
|
+
# above average sea level at that location within the tile. Elevations provided
|
699
|
+
# are (generally) relative to the EGM96 geoid, however some areas will be
|
700
|
+
# relative to NAVD88. EGM96 and NAVD88 are off by no more than 2 meters. The
|
701
|
+
# grid is oriented north-west to south-east, as illustrated: rows[0].a[0] rows[0]
|
702
|
+
# .a[m] +-----------------+ | | | N | | ^ | | | | | W <-----> E | | | | | v | |
|
703
|
+
# S | | | +-----------------+ rows[n].a[0] rows[n].a[m] Rather than storing the
|
704
|
+
# altitudes directly, we store the diffs of the diffs between them as integers
|
705
|
+
# at some requested level of precision to take advantage of integer packing.
|
706
|
+
# Note that the data is packed in such a way that is fast to decode in Unity and
|
707
|
+
# that further optimizes wire size.
|
708
|
+
# Corresponds to the JSON property `secondDerivative`
|
709
|
+
# @return [Google::Apis::VectortileV1::SecondDerivativeElevationGrid]
|
710
|
+
attr_accessor :second_derivative
|
711
|
+
|
712
|
+
def initialize(**args)
|
713
|
+
update!(**args)
|
714
|
+
end
|
715
|
+
|
716
|
+
# Update properties of this object
|
717
|
+
def update!(**args)
|
718
|
+
@coordinates = args[:coordinates] if args.key?(:coordinates)
|
719
|
+
@first_derivative = args[:first_derivative] if args.key?(:first_derivative)
|
720
|
+
@name = args[:name] if args.key?(:name)
|
721
|
+
@second_derivative = args[:second_derivative] if args.key?(:second_derivative)
|
722
|
+
end
|
723
|
+
end
|
724
|
+
|
725
|
+
# Global tile coordinates. Global tile coordinates reference a specific tile on
|
726
|
+
# the map at a specific zoom level. The origin of this coordinate system is
|
727
|
+
# always at the northwest corner of the map, with x values increasing from west
|
728
|
+
# to east and y values increasing from north to south. Tiles are indexed using x,
|
729
|
+
# y coordinates from that origin. The zoom level containing the entire world in
|
730
|
+
# a tile is 0, and it increases as you zoom in. Zoom level n + 1 will contain 4
|
731
|
+
# times as many tiles as zoom level n. The zoom level controls the level of
|
732
|
+
# detail of the data that is returned. In particular, this affects the set of
|
733
|
+
# feature types returned, their density, and geometry simplification. The exact
|
734
|
+
# tile contents may change over time, but care will be taken to keep supporting
|
735
|
+
# the most important use cases. For example, zoom level 15 shows roads for
|
736
|
+
# orientation and planning in the local neighborhood and zoom level 17 shows
|
737
|
+
# buildings to give users on foot a sense of situational awareness.
|
738
|
+
class TileCoordinates
|
739
|
+
include Google::Apis::Core::Hashable
|
740
|
+
|
741
|
+
# Required. The x coordinate.
|
742
|
+
# Corresponds to the JSON property `x`
|
743
|
+
# @return [Fixnum]
|
744
|
+
attr_accessor :x
|
745
|
+
|
746
|
+
# Required. The y coordinate.
|
747
|
+
# Corresponds to the JSON property `y`
|
748
|
+
# @return [Fixnum]
|
749
|
+
attr_accessor :y
|
750
|
+
|
751
|
+
# Required. The Google Maps API zoom level.
|
752
|
+
# Corresponds to the JSON property `zoom`
|
753
|
+
# @return [Fixnum]
|
754
|
+
attr_accessor :zoom
|
755
|
+
|
756
|
+
def initialize(**args)
|
757
|
+
update!(**args)
|
758
|
+
end
|
759
|
+
|
760
|
+
# Update properties of this object
|
761
|
+
def update!(**args)
|
762
|
+
@x = args[:x] if args.key?(:x)
|
763
|
+
@y = args[:y] if args.key?(:y)
|
764
|
+
@zoom = args[:zoom] if args.key?(:zoom)
|
765
|
+
end
|
766
|
+
end
|
767
|
+
|
768
|
+
# Represents a strip of triangles. Each triangle uses the last edge of the
|
769
|
+
# previous one. The following diagram shows an example of a triangle strip, with
|
770
|
+
# each vertex labeled with its index in the vertex_index array. (1)-----(3) / \ /
|
771
|
+
# \ / \ / \ / \ / \ (0)-----(2)-----(4) Vertices may be in either clockwise or
|
772
|
+
# counter-clockwise order.
|
773
|
+
class TriangleStrip
|
774
|
+
include Google::Apis::Core::Hashable
|
775
|
+
|
776
|
+
# Index into the vertex_offset array representing the next vertex in the
|
777
|
+
# triangle strip.
|
778
|
+
# Corresponds to the JSON property `vertexIndices`
|
779
|
+
# @return [Array<Fixnum>]
|
780
|
+
attr_accessor :vertex_indices
|
781
|
+
|
782
|
+
def initialize(**args)
|
783
|
+
update!(**args)
|
784
|
+
end
|
785
|
+
|
786
|
+
# Update properties of this object
|
787
|
+
def update!(**args)
|
788
|
+
@vertex_indices = args[:vertex_indices] if args.key?(:vertex_indices)
|
789
|
+
end
|
790
|
+
end
|
791
|
+
|
792
|
+
# 2D vertex list used for lines and areas. Each entry represents an offset from
|
793
|
+
# the previous one in local tile coordinates. The first entry is offset from (0,
|
794
|
+
# 0). For example, the list of vertices [(1,1), (2, 2), (1, 2)] would be encoded
|
795
|
+
# in vertex offsets as [(1, 1), (1, 1), (-1, 0)].
|
796
|
+
class Vertex2DList
|
797
|
+
include Google::Apis::Core::Hashable
|
798
|
+
|
799
|
+
# List of x-offsets in local tile coordinates.
|
800
|
+
# Corresponds to the JSON property `xOffsets`
|
801
|
+
# @return [Array<Fixnum>]
|
802
|
+
attr_accessor :x_offsets
|
803
|
+
|
804
|
+
# List of y-offsets in local tile coordinates.
|
805
|
+
# Corresponds to the JSON property `yOffsets`
|
806
|
+
# @return [Array<Fixnum>]
|
807
|
+
attr_accessor :y_offsets
|
808
|
+
|
809
|
+
def initialize(**args)
|
810
|
+
update!(**args)
|
811
|
+
end
|
812
|
+
|
813
|
+
# Update properties of this object
|
814
|
+
def update!(**args)
|
815
|
+
@x_offsets = args[:x_offsets] if args.key?(:x_offsets)
|
816
|
+
@y_offsets = args[:y_offsets] if args.key?(:y_offsets)
|
817
|
+
end
|
818
|
+
end
|
819
|
+
|
820
|
+
# 3D vertex list used for modeled volumes. Each entry represents an offset from
|
821
|
+
# the previous one in local tile coordinates. The first coordinate is offset
|
822
|
+
# from (0, 0, 0).
|
823
|
+
class Vertex3DList
|
824
|
+
include Google::Apis::Core::Hashable
|
825
|
+
|
826
|
+
# List of x-offsets in local tile coordinates.
|
827
|
+
# Corresponds to the JSON property `xOffsets`
|
828
|
+
# @return [Array<Fixnum>]
|
829
|
+
attr_accessor :x_offsets
|
830
|
+
|
831
|
+
# List of y-offsets in local tile coordinates.
|
832
|
+
# Corresponds to the JSON property `yOffsets`
|
833
|
+
# @return [Array<Fixnum>]
|
834
|
+
attr_accessor :y_offsets
|
835
|
+
|
836
|
+
# List of z-offsets in local tile coordinates.
|
837
|
+
# Corresponds to the JSON property `zOffsets`
|
838
|
+
# @return [Array<Fixnum>]
|
839
|
+
attr_accessor :z_offsets
|
840
|
+
|
841
|
+
def initialize(**args)
|
842
|
+
update!(**args)
|
843
|
+
end
|
844
|
+
|
845
|
+
# Update properties of this object
|
846
|
+
def update!(**args)
|
847
|
+
@x_offsets = args[:x_offsets] if args.key?(:x_offsets)
|
848
|
+
@y_offsets = args[:y_offsets] if args.key?(:y_offsets)
|
849
|
+
@z_offsets = args[:z_offsets] if args.key?(:z_offsets)
|
850
|
+
end
|
851
|
+
end
|
852
|
+
end
|
853
|
+
end
|
854
|
+
end
|