Skip to content

Commit 53488e4

Browse files
JoeWang1127gcf-owl-bot[bot]
JoeWang1127
and
gcf-owl-bot[bot]
authored
feat: [maps-fleetengine] new module for maps-fleetengine (#10033)
* feat: [maps-fleetengine] new module for maps-fleetengine * change package name * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md --------- Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
1 parent 7e76fbc commit 53488e4

File tree

169 files changed

+116002
-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.

169 files changed

+116002
-0
lines changed

‎java-maps-fleetengine/.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-fleetengine/grpc-google-.*/src"
18+
- "/java-maps-fleetengine/proto-google-.*/src"
19+
- "/java-maps-fleetengine/google-.*/src"
20+
- "/java-maps-fleetengine/samples/snippets/generated"
21+
22+
deep-preserve-regex:
23+
- "/java-maps-fleetengine/google-.*/src/test/java/com/google/cloud/.*/v.*/it/IT.*Test.java"
24+
25+
deep-copy-regex:
26+
- source: "/google/maps/fleetengine/(v.*)/.*-java/proto-google-.*/src"
27+
dest: "/owl-bot-staging/java-maps-fleetengine/$1/proto-google-maps-fleetengine-$1/src"
28+
- source: "/google/maps/fleetengine/(v.*)/.*-java/grpc-google-.*/src"
29+
dest: "/owl-bot-staging/java-maps-fleetengine/$1/grpc-google-maps-fleetengine-$1/src"
30+
- source: "/google/maps/fleetengine/(v.*)/.*-java/gapic-google-.*/src"
31+
dest: "/owl-bot-staging/java-maps-fleetengine/$1/google-maps-fleetengine/src"
32+
- source: "/google/maps/fleetengine/(v.*)/.*-java/samples/snippets/generated"
33+
dest: "/owl-bot-staging/java-maps-fleetengine/$1/samples/snippets/generated"
34+
35+
36+
api-name: maps-fleetengine

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

+16
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
{
2+
"api_shortname": "maps-fleetengine",
3+
"name_pretty": "Local Rides and Deliveries API",
4+
"product_documentation": "https://developers.google.com/maps/documentation/transportation-logistics/mobility",
5+
"api_description": "Enables Fleet Engine for access to the On Demand Rides and Deliveries and\n Last Mile Fleet Solution APIs. Customer's use of Google Maps Content in\n the Cloud Logging Services is subject to the Google Maps Platform Terms of\n Service located at https://cloud.google.com/maps-platform/terms.",
6+
"client_documentation": "https://cloud.google.com/java/docs/reference/google-maps-fleetengine/latest/overview",
7+
"release_level": "preview",
8+
"transport": "grpc",
9+
"language": "java",
10+
"repo": "googleapis/java-maps-fleetengine",
11+
"repo_short": "java-maps-fleetengine",
12+
"distribution_name": "com.google.maps:google-maps-fleetengine",
13+
"api_id": "maps-fleetengine.googleapis.com",
14+
"library_type": "GAPIC_AUTO",
15+
"requires_billing": true
16+
}

‎java-maps-fleetengine/README.md

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

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

+44
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
<?xml version='1.0' encoding='UTF-8'?>
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-fleetengine-bom</artifactId>
6+
<version>0.0.1-SNAPSHOT</version><!-- {x-version-update:google-maps-fleetengine:current} -->
7+
<packaging>pom</packaging>
8+
9+
<parent>
10+
<groupId>com.google.cloud</groupId>
11+
<artifactId>google-cloud-pom-parent</artifactId>
12+
<version>1.24.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 Local Rides and Deliveries API BOM</name>
17+
<description>
18+
BOM for Local Rides and Deliveries 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-fleetengine</artifactId>
30+
<version>0.0.1-SNAPSHOT</version><!-- {x-version-update:google-maps-fleetengine:current} -->
31+
</dependency>
32+
<dependency>
33+
<groupId>com.google.maps.api.grpc</groupId>
34+
<artifactId>grpc-google-maps-fleetengine-v1</artifactId>
35+
<version>0.0.1-SNAPSHOT</version><!-- {x-version-update:grpc-google-maps-fleetengine-v1:current} -->
36+
</dependency>
37+
<dependency>
38+
<groupId>com.google.maps.api.grpc</groupId>
39+
<artifactId>proto-google-maps-fleetengine-v1</artifactId>
40+
<version>0.0.1-SNAPSHOT</version><!-- {x-version-update:proto-google-maps-fleetengine-v1:current} -->
41+
</dependency>
42+
</dependencies>
43+
</dependencyManagement>
44+
</project>

0 commit comments

Comments
 (0)