Skip to content

Commit c8e3fc0

Browse files
emmileafemmileaf
authored
feat: [maps-mapsplatformdatasets] new module for maps-mapsplatformdatasets (#9159)
* feat: [maps-mapsplatformdatasets] new module for maps-mapsplatformdatasets * chore: remove .python-version * chore: fix api_id
1 parent 27248c8 commit c8e3fc0

File tree

98 files changed

+25471
-0
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

98 files changed

+25471
-0
lines changed

‎java-maps-mapsplatformdatasets/.OwlBot.yaml

+36
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
# Copyright 2022 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+
16+
deep-remove-regex:
17+
- "/java-maps-mapsplatformdatasets/grpc-google-.*/src"
18+
- "/java-maps-mapsplatformdatasets/proto-google-.*/src"
19+
- "/java-maps-mapsplatformdatasets/google-.*/src"
20+
- "/java-maps-mapsplatformdatasets/samples/snippets/generated"
21+
22+
deep-preserve-regex:
23+
- "/java-maps-mapsplatformdatasets/google-.*/src/test/java/com/google/cloud/.*/v.*/it/IT.*Test.java"
24+
25+
deep-copy-regex:
26+
- source: "/google/maps/mapsplatformdatasets/(v.*)/.*-java/proto-google-.*/src"
27+
dest: "/owl-bot-staging/java-maps-mapsplatformdatasets/$1/proto-google-maps-mapsplatformdatasets-$1/src"
28+
- source: "/google/maps/mapsplatformdatasets/(v.*)/.*-java/grpc-google-.*/src"
29+
dest: "/owl-bot-staging/java-maps-mapsplatformdatasets/$1/grpc-google-maps-mapsplatformdatasets-$1/src"
30+
- source: "/google/maps/mapsplatformdatasets/(v.*)/.*-java/gapic-google-.*/src"
31+
dest: "/owl-bot-staging/java-maps-mapsplatformdatasets/$1/google-maps-mapsplatformdatasets/src"
32+
- source: "/google/maps/mapsplatformdatasets/(v.*)/.*-java/samples/snippets/generated"
33+
dest: "/owl-bot-staging/java-maps-mapsplatformdatasets/$1/samples/snippets/generated"
34+
35+
36+
api-name: maps-mapsplatformdatasets

‎java-maps-mapsplatformdatasets/.repo-metadata.json

+16
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
{
2+
"api_shortname": "maps-mapsplatformdatasets",
3+
"name_pretty": "Maps Platform Datasets API",
4+
"product_documentation": "https://developers.google.com/maps/documentation",
5+
"api_description": "The Maps Platform Datasets API enables developers to ingest geospatially-tied datasets\n that they can use to enrich their experience of Maps Platform solutions (e.g. styling, routing).",
6+
"client_documentation": "https://cloud.google.com/java/docs/reference/google-maps-mapsplatformdatasets/latest/overview",
7+
"release_level": "preview",
8+
"transport": "grpc",
9+
"language": "java",
10+
"repo": "googleapis/java-maps-mapsplatformdatasets",
11+
"repo_short": "java-maps-mapsplatformdatasets",
12+
"distribution_name": "com.google.maps:google-maps-mapsplatformdatasets",
13+
"api_id": "mapsplatformdatasets.googleapis.com",
14+
"library_type": "GAPIC_AUTO",
15+
"requires_billing": true
16+
}

‎java-maps-mapsplatformdatasets/README.md

+202
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,202 @@
1+
# Google Maps Platform Datasets API Client for Java
2+
3+
Java idiomatic client for [Maps Platform Datasets API][product-docs].
4+
5+
[![Maven][maven-version-image]][maven-version-link]
6+
![Stability][stability-image]
7+
8+
- [Product Documentation][product-docs]
9+
- [Client Library Documentation][javadocs]
10+
11+
> Note: This client is a work-in-progress, and may occasionally
12+
> make backwards-incompatible changes.
13+
14+
15+
## Quickstart
16+
17+
18+
If you are using Maven, add this to your pom.xml file:
19+
20+
21+
```xml
22+
<dependency>
23+
<groupId>com.google.maps</groupId>
24+
<artifactId>google-maps-mapsplatformdatasets</artifactId>
25+
<version>0.0.0</version>
26+
</dependency>
27+
```
28+
29+
If you are using Gradle without BOM, add this to your dependencies:
30+
31+
```Groovy
32+
implementation 'com.google.maps:google-maps-mapsplatformdatasets:0.0.0'
33+
```
34+
35+
If you are using SBT, add this to your dependencies:
36+
37+
```Scala
38+
libraryDependencies += "com.google.maps" % "google-maps-mapsplatformdatasets" % "0.0.0"
39+
```
40+
41+
## Authentication
42+
43+
See the [Authentication][authentication] section in the base directory's README.
44+
45+
## Authorization
46+
47+
The client application making API calls must be granted [authorization scopes][auth-scopes] required for the desired Maps Platform Datasets API APIs, and the authenticated principal must have the [IAM role(s)][predefined-iam-roles] required to access GCP resources using the Maps Platform Datasets API API calls.
48+
49+
## Getting Started
50+
51+
### Prerequisites
52+
53+
You will need a [Google Cloud Platform Console][developer-console] project with the Maps Platform Datasets API [API enabled][enable-api].
54+
You will need to [enable billing][enable-billing] to use Google Maps Platform Datasets API.
55+
[Follow these instructions][create-project] to get your project set up. You will also need to set up the local development environment by
56+
[installing the Google Cloud SDK][cloud-sdk] and running the following commands in command line:
57+
`gcloud auth login` and `gcloud config set project [YOUR PROJECT ID]`.
58+
59+
### Installation and setup
60+
61+
You'll need to obtain the `google-maps-mapsplatformdatasets` library. See the [Quickstart](#quickstart) section
62+
to add `google-maps-mapsplatformdatasets` as a dependency in your code.
63+
64+
## About Maps Platform Datasets API
65+
66+
67+
[Maps Platform Datasets API][product-docs] The Maps Platform Datasets API enables developers to ingest geospatially-tied datasets
68+
that they can use to enrich their experience of Maps Platform solutions (e.g. styling, routing).
69+
70+
See the [Maps Platform Datasets API client library docs][javadocs] to learn how to
71+
use this Maps Platform Datasets API Client Library.
72+
73+
74+
75+
76+
77+
78+
## Troubleshooting
79+
80+
To get help, follow the instructions in the [shared Troubleshooting document][troubleshooting].
81+
82+
## Transport
83+
84+
Maps Platform Datasets API uses gRPC for the transport layer.
85+
86+
## Supported Java Versions
87+
88+
Java 8 or above is required for using this client.
89+
90+
Google's Java client libraries,
91+
[Google Cloud Client Libraries][cloudlibs]
92+
and
93+
[Google Cloud API Libraries][apilibs],
94+
follow the
95+
[Oracle Java SE support roadmap][oracle]
96+
(see the Oracle Java SE Product Releases section).
97+
98+
### For new development
99+
100+
In general, new feature development occurs with support for the lowest Java
101+
LTS version covered by Oracle's Premier Support (which typically lasts 5 years
102+
from initial General Availability). If the minimum required JVM for a given
103+
library is changed, it is accompanied by a [semver][semver] major release.
104+
105+
Java 11 and (in September 2021) Java 17 are the best choices for new
106+
development.
107+
108+
### Keeping production systems current
109+
110+
Google tests its client libraries with all current LTS versions covered by
111+
Oracle's Extended Support (which typically lasts 8 years from initial
112+
General Availability).
113+
114+
#### Legacy support
115+
116+
Google's client libraries support legacy versions of Java runtimes with long
117+
term stable libraries that don't receive feature updates on a best efforts basis
118+
as it may not be possible to backport all patches.
119+
120+
Google provides updates on a best efforts basis to apps that continue to use
121+
Java 7, though apps might need to upgrade to current versions of the library
122+
that supports their JVM.
123+
124+
#### Where to find specific information
125+
126+
The latest versions and the supported Java versions are identified on
127+
the individual GitHub repository `github.com/GoogleAPIs/java-SERVICENAME`
128+
and on [google-cloud-java][g-c-j].
129+
130+
## Versioning
131+
132+
133+
This library follows [Semantic Versioning](http://semver.org/).
134+
135+
136+
It is currently in major version zero (``0.y.z``), which means that anything may change at any time
137+
and the public API should not be considered stable.
138+
139+
140+
## Contributing
141+
142+
143+
Contributions to this library are always welcome and highly encouraged.
144+
145+
See [CONTRIBUTING][contributing] for more information how to get started.
146+
147+
Please note that this project is released with a Contributor Code of Conduct. By participating in
148+
this project you agree to abide by its terms. See [Code of Conduct][code-of-conduct] for more
149+
information.
150+
151+
152+
## License
153+
154+
Apache 2.0 - See [LICENSE][license] for more information.
155+
156+
## CI Status
157+
158+
Java Version | Status
159+
------------ | ------
160+
Java 8 | [![Kokoro CI][kokoro-badge-image-2]][kokoro-badge-link-2]
161+
Java 8 OSX | [![Kokoro CI][kokoro-badge-image-3]][kokoro-badge-link-3]
162+
Java 8 Windows | [![Kokoro CI][kokoro-badge-image-4]][kokoro-badge-link-4]
163+
Java 11 | [![Kokoro CI][kokoro-badge-image-5]][kokoro-badge-link-5]
164+
165+
Java is a registered trademark of Oracle and/or its affiliates.
166+
167+
[product-docs]: https://developers.google.com/maps/documentation
168+
[javadocs]: https://cloud.google.com/java/docs/reference/google-maps-mapsplatformdatasets/latest/overview
169+
[kokoro-badge-image-1]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-maps-mapsplatformdatasets/java7.svg
170+
[kokoro-badge-link-1]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-maps-mapsplatformdatasets/java7.html
171+
[kokoro-badge-image-2]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-maps-mapsplatformdatasets/java8.svg
172+
[kokoro-badge-link-2]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-maps-mapsplatformdatasets/java8.html
173+
[kokoro-badge-image-3]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-maps-mapsplatformdatasets/java8-osx.svg
174+
[kokoro-badge-link-3]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-maps-mapsplatformdatasets/java8-osx.html
175+
[kokoro-badge-image-4]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-maps-mapsplatformdatasets/java8-win.svg
176+
[kokoro-badge-link-4]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-maps-mapsplatformdatasets/java8-win.html
177+
[kokoro-badge-image-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-maps-mapsplatformdatasets/java11.svg
178+
[kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-maps-mapsplatformdatasets/java11.html
179+
[stability-image]: https://img.shields.io/badge/stability-preview-yellow
180+
[maven-version-image]: https://img.shields.io/maven-central/v/com.google.maps/google-maps-mapsplatformdatasets.svg
181+
[maven-version-link]: https://search.maven.org/search?q=g:com.google.maps%20AND%20a:google-maps-mapsplatformdatasets&core=gav
182+
[authentication]: https://github.com/googleapis/google-cloud-java#authentication
183+
[auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes
184+
[predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles
185+
[iam-policy]: https://cloud.google.com/iam/docs/overview#cloud-iam-policy
186+
[developer-console]: https://console.developers.google.com/
187+
[create-project]: https://cloud.google.com/resource-manager/docs/creating-managing-projects
188+
[cloud-sdk]: https://cloud.google.com/sdk/
189+
[troubleshooting]: https://github.com/googleapis/google-cloud-common/blob/main/troubleshooting/readme.md#troubleshooting
190+
[contributing]: https://github.com/googleapis/java-maps-mapsplatformdatasets/blob/main/CONTRIBUTING.md
191+
[code-of-conduct]: https://github.com/googleapis/java-maps-mapsplatformdatasets/blob/main/CODE_OF_CONDUCT.md#contributor-code-of-conduct
192+
[license]: https://github.com/googleapis/java-maps-mapsplatformdatasets/blob/main/LICENSE
193+
[enable-billing]: https://cloud.google.com/apis/docs/getting-started#enabling_billing
194+
[enable-api]: https://console.cloud.google.com/flows/enableapi?apiid=maps-mapsplatformdatasets.googleapis.com
195+
[libraries-bom]: https://github.com/GoogleCloudPlatform/cloud-opensource-java/wiki/The-Google-Cloud-Platform-Libraries-BOM
196+
[shell_img]: https://gstatic.com/cloudssh/images/open-btn.png
197+
198+
[semver]: https://semver.org/
199+
[cloudlibs]: https://cloud.google.com/apis/docs/client-libraries-explained
200+
[apilibs]: https://cloud.google.com/apis/docs/client-libraries-explained#google_api_client_libraries
201+
[oracle]: https://www.oracle.com/java/technologies/java-se-support-roadmap.html
202+
[g-c-j]: http://github.com/googleapis/google-cloud-java

‎java-maps-mapsplatformdatasets/google-maps-mapsplatformdatasets-bom/pom.xml

+44
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
<?xml version="1.0"?>
2+
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
3+
<modelVersion>4.0.0</modelVersion>
4+
<groupId>com.google.maps</groupId>
5+
<artifactId>google-maps-mapsplatformdatasets-bom</artifactId>
6+
<version>0.0.1-SNAPSHOT</version><!-- {x-version-update:google-maps-mapsplatformdatasets:current} -->
7+
<packaging>pom</packaging>
8+
9+
<parent>
10+
<groupId>com.google.cloud</groupId>
11+
<artifactId>google-cloud-pom-parent</artifactId>
12+
<version>1.6.0-SNAPSHOT</version><!-- {x-version-update:google-cloud-java:current} -->
13+
<relativePath>../../google-cloud-pom-parent/pom.xml</relativePath>
14+
</parent>
15+
16+
<name>Google Maps Platform Datasets API BOM</name>
17+
<description>
18+
BOM for Maps Platform Datasets API
19+
</description>
20+
21+
<properties>
22+
<maven.antrun.skip>true</maven.antrun.skip>
23+
</properties>
24+
25+
<dependencyManagement>
26+
<dependencies>
27+
<dependency>
28+
<groupId>com.google.maps</groupId>
29+
<artifactId>google-maps-mapsplatformdatasets</artifactId>
30+
<version>0.0.1-SNAPSHOT</version><!-- {x-version-update:google-maps-mapsplatformdatasets:current} -->
31+
</dependency>
32+
<dependency>
33+
<groupId>com.google.maps.api.grpc</groupId>
34+
<artifactId>grpc-google-maps-mapsplatformdatasets-v1alpha</artifactId>
35+
<version>0.0.1-SNAPSHOT</version><!-- {x-version-update:grpc-google-maps-mapsplatformdatasets-v1alpha:current} -->
36+
</dependency>
37+
<dependency>
38+
<groupId>com.google.maps.api.grpc</groupId>
39+
<artifactId>proto-google-maps-mapsplatformdatasets-v1alpha</artifactId>
40+
<version>0.0.1-SNAPSHOT</version><!-- {x-version-update:proto-google-maps-mapsplatformdatasets-v1alpha:current} -->
41+
</dependency>
42+
</dependencies>
43+
</dependencyManagement>
44+
</project>

0 commit comments

Comments
 (0)