Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly
Appearance settings

Commit 4e67caa

Browse filesBrowse files
suztomogcf-owl-bot[bot]
suztomo
and
gcf-owl-bot[bot]
authored
feat: [maps-routiting] new module for maps-routiting (#8724)
* feat: [maps-routiting] new module for maps-routiting * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md * remove bash_history * bom script Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
1 parent 5473bee commit 4e67caa
Copy full SHA for 4e67caa

File tree

Expand file treeCollapse file tree

120 files changed

+49269
-0
lines changed
Filter options

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.
Dismiss banner
Expand file treeCollapse file tree

120 files changed

+49269
-0
lines changed

‎.release-please-manifest.json

Copy file name to clipboardExpand all lines: .release-please-manifest.json
+1Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -85,6 +85,7 @@
8585
"java-language": "2.6.0",
8686
"java-life-sciences": "0.7.0",
8787
"java-managed-identities": "1.3.0",
88+
"java-maps-routiting": "0.0.0",
8889
"java-mediatranslation": "0.11.0",
8990
"java-memcache": "2.5.0",
9091
"java-monitoring-dashboards": "2.7.0",

‎generation/generate_gapic_bom.sh

Copy file name to clipboardExpand all lines: generation/generate_gapic_bom.sh
+5Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,11 @@ for bom_directory in $(find . -maxdepth 3 -name 'google-*-bom' | sort --dictiona
1717
artifactId_line=$(grep --max-count=1 'artifactId' "${pom_file}")
1818
version_line=$(grep --max-count=1 'x-version-update' "${pom_file}")
1919

20+
if [[ "$groupId_line" == *"com.google.maps"* ]]; then
21+
# The gapic bom includes cloud libraries
22+
continue
23+
fi
24+
2025
bom_lines+=" <dependency>\n\
2126
${groupId_line}\n\
2227
${artifactId_line}\n\

‎java-maps-routiting/.OwlBot.yaml

Copy file name to clipboard
+33Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
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-routiting/grpc-google-.*/src"
18+
- "/java-maps-routiting/proto-google-.*/src"
19+
- "/java-maps-routiting/google-.*/src"
20+
21+
deep-preserve-regex:
22+
- "/java-maps-routiting/google-.*/src/test/java/com/google/cloud/.*/v.*/it/IT.*Test.java"
23+
24+
deep-copy-regex:
25+
- source: "/google/maps/routing/(v.*)/.*-java/proto-google-.*/src"
26+
dest: "/owl-bot-staging/java-maps-routiting/$1/proto-google-maps-routes-$1/src"
27+
- source: "/google/maps/routing/(v.*)/.*-java/grpc-google-.*/src"
28+
dest: "/owl-bot-staging/java-maps-routiting/$1/grpc-google-maps-routes-$1/src"
29+
- source: "/google/maps/routing/(v.*)/.*-java/gapic-google-.*/src"
30+
dest: "/owl-bot-staging/java-maps-routiting/$1/google-maps-routes/src"
31+
32+
33+
api-name: java-maps-routiting

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

Copy file name to clipboard
+15Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
{
2+
"api_shortname": "maps-routiting",
3+
"name_pretty": "Routes API",
4+
"product_documentation": "https://developers.google.com/maps/documentation/routes",
5+
"api_description": "Routes API is the next generation, performance optimized version of the existing Directions API and Distance Matrix API. It helps you find the ideal route from A to Z, calculates ETAs and distances for matrices of origin and destination locations, and also offers new features.",
6+
"client_documentation": "https://cloud.google.com/java/docs/reference/google-maps-routes/latest/overview",
7+
"release_level": "preview",
8+
"transport": "grpc",
9+
"language": "java",
10+
"repo": "googleapis/java-maps-routiting",
11+
"repo_short": "java-maps-routiting",
12+
"distribution_name": "com.google.maps:google-maps-routes",
13+
"api_id": "routes.googleapis.com",
14+
"library_type": "GAPIC_AUTO"
15+
}

‎java-maps-routiting/README.md

Copy file name to clipboard
+201Lines changed: 201 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,201 @@
1+
# Google Routes API Client for Java
2+
3+
Java idiomatic client for [Routes 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-routes</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-routes: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-routes" % "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 Routes API APIs, and the authenticated principal must have the [IAM role(s)][predefined-iam-roles] required to access GCP resources using the Routes 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 Routes API [API enabled][enable-api].
54+
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-routes` library. See the [Quickstart](#quickstart) section
62+
to add `google-maps-routes` as a dependency in your code.
63+
64+
## About Routes API
65+
66+
67+
[Routes API][product-docs] Routes API is the next generation, performance optimized version of the existing Directions API and Distance Matrix API. It helps you find the ideal route from A to Z, calculates ETAs and distances for matrices of origin and destination locations, and also offers new features.
68+
69+
See the [Routes API client library docs][javadocs] to learn how to
70+
use this Routes API Client Library.
71+
72+
73+
74+
75+
76+
77+
## Troubleshooting
78+
79+
To get help, follow the instructions in the [shared Troubleshooting document][troubleshooting].
80+
81+
## Transport
82+
83+
Routes API uses gRPC for the transport layer.
84+
85+
## Supported Java Versions
86+
87+
Java 8 or above is required for using this client.
88+
89+
Google's Java client libraries,
90+
[Google Cloud Client Libraries][cloudlibs]
91+
and
92+
[Google Cloud API Libraries][apilibs],
93+
follow the
94+
[Oracle Java SE support roadmap][oracle]
95+
(see the Oracle Java SE Product Releases section).
96+
97+
### For new development
98+
99+
In general, new feature development occurs with support for the lowest Java
100+
LTS version covered by Oracle's Premier Support (which typically lasts 5 years
101+
from initial General Availability). If the minimum required JVM for a given
102+
library is changed, it is accompanied by a [semver][semver] major release.
103+
104+
Java 11 and (in September 2021) Java 17 are the best choices for new
105+
development.
106+
107+
### Keeping production systems current
108+
109+
Google tests its client libraries with all current LTS versions covered by
110+
Oracle's Extended Support (which typically lasts 8 years from initial
111+
General Availability).
112+
113+
#### Legacy support
114+
115+
Google's client libraries support legacy versions of Java runtimes with long
116+
term stable libraries that don't receive feature updates on a best efforts basis
117+
as it may not be possible to backport all patches.
118+
119+
Google provides updates on a best efforts basis to apps that continue to use
120+
Java 7, though apps might need to upgrade to current versions of the library
121+
that supports their JVM.
122+
123+
#### Where to find specific information
124+
125+
The latest versions and the supported Java versions are identified on
126+
the individual GitHub repository `github.com/GoogleAPIs/java-SERVICENAME`
127+
and on [google-cloud-java][g-c-j].
128+
129+
## Versioning
130+
131+
132+
This library follows [Semantic Versioning](http://semver.org/).
133+
134+
135+
It is currently in major version zero (``0.y.z``), which means that anything may change at any time
136+
and the public API should not be considered stable.
137+
138+
139+
## Contributing
140+
141+
142+
Contributions to this library are always welcome and highly encouraged.
143+
144+
See [CONTRIBUTING][contributing] for more information how to get started.
145+
146+
Please note that this project is released with a Contributor Code of Conduct. By participating in
147+
this project you agree to abide by its terms. See [Code of Conduct][code-of-conduct] for more
148+
information.
149+
150+
151+
## License
152+
153+
Apache 2.0 - See [LICENSE][license] for more information.
154+
155+
## CI Status
156+
157+
Java Version | Status
158+
------------ | ------
159+
Java 8 | [![Kokoro CI][kokoro-badge-image-2]][kokoro-badge-link-2]
160+
Java 8 OSX | [![Kokoro CI][kokoro-badge-image-3]][kokoro-badge-link-3]
161+
Java 8 Windows | [![Kokoro CI][kokoro-badge-image-4]][kokoro-badge-link-4]
162+
Java 11 | [![Kokoro CI][kokoro-badge-image-5]][kokoro-badge-link-5]
163+
164+
Java is a registered trademark of Oracle and/or its affiliates.
165+
166+
[product-docs]: https://developers.google.com/maps/documentation/routes
167+
[javadocs]: https://cloud.google.com/java/docs/reference/google-maps-routes/latest/overview
168+
[kokoro-badge-image-1]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-maps-routiting/java7.svg
169+
[kokoro-badge-link-1]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-maps-routiting/java7.html
170+
[kokoro-badge-image-2]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-maps-routiting/java8.svg
171+
[kokoro-badge-link-2]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-maps-routiting/java8.html
172+
[kokoro-badge-image-3]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-maps-routiting/java8-osx.svg
173+
[kokoro-badge-link-3]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-maps-routiting/java8-osx.html
174+
[kokoro-badge-image-4]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-maps-routiting/java8-win.svg
175+
[kokoro-badge-link-4]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-maps-routiting/java8-win.html
176+
[kokoro-badge-image-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-maps-routiting/java11.svg
177+
[kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-maps-routiting/java11.html
178+
[stability-image]: https://img.shields.io/badge/stability-preview-yellow
179+
[maven-version-image]: https://img.shields.io/maven-central/v/com.google.maps/google-maps-routes.svg
180+
[maven-version-link]: https://search.maven.org/search?q=g:com.google.maps%20AND%20a:google-maps-routes&core=gav
181+
[authentication]: https://github.com/googleapis/google-cloud-java#authentication
182+
[auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes
183+
[predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles
184+
[iam-policy]: https://cloud.google.com/iam/docs/overview#cloud-iam-policy
185+
[developer-console]: https://console.developers.google.com/
186+
[create-project]: https://cloud.google.com/resource-manager/docs/creating-managing-projects
187+
[cloud-sdk]: https://cloud.google.com/sdk/
188+
[troubleshooting]: https://github.com/googleapis/google-cloud-common/blob/main/troubleshooting/readme.md#troubleshooting
189+
[contributing]: https://github.com/googleapis/java-maps-routiting/blob/main/CONTRIBUTING.md
190+
[code-of-conduct]: https://github.com/googleapis/java-maps-routiting/blob/main/CODE_OF_CONDUCT.md#contributor-code-of-conduct
191+
[license]: https://github.com/googleapis/java-maps-routiting/blob/main/LICENSE
192+
193+
[enable-api]: https://console.cloud.google.com/flows/enableapi?apiid=routes.googleapis.com
194+
[libraries-bom]: https://github.com/GoogleCloudPlatform/cloud-opensource-java/wiki/The-Google-Cloud-Platform-Libraries-BOM
195+
[shell_img]: https://gstatic.com/cloudssh/images/open-btn.png
196+
197+
[semver]: https://semver.org/
198+
[cloudlibs]: https://cloud.google.com/apis/docs/client-libraries-explained
199+
[apilibs]: https://cloud.google.com/apis/docs/client-libraries-explained#google_api_client_libraries
200+
[oracle]: https://www.oracle.com/java/technologies/java-se-support-roadmap.html
201+
[g-c-j]: http://github.com/googleapis/google-cloud-java

‎java-maps-routiting/google-maps-routes-bom/pom.xml

Copy file name to clipboard
+44Lines changed: 44 additions & 0 deletions
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-routes-bom</artifactId>
6+
<version>0.0.1-SNAPSHOT</version><!-- {x-version-update:google-maps-routes:current} -->
7+
<packaging>pom</packaging>
8+
9+
<parent>
10+
<groupId>com.google.cloud</groupId>
11+
<artifactId>google-cloud-pom-parent</artifactId>
12+
<version>0.2.1-SNAPSHOT</version><!-- {x-version-update:google-cloud-pom-parent:current} -->
13+
<relativePath>../../google-cloud-pom-parent/pom.xml</relativePath>
14+
</parent>
15+
16+
<name>Google Routes API BOM</name>
17+
<description>
18+
BOM for Routes 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-routes</artifactId>
30+
<version>0.0.1-SNAPSHOT</version><!-- {x-version-update:google-maps-routes:current} -->
31+
</dependency>
32+
<dependency>
33+
<groupId>com.google.api.grpc</groupId>
34+
<artifactId>grpc-google-maps-routes-v2</artifactId>
35+
<version>0.0.1-SNAPSHOT</version><!-- {x-version-update:grpc-google-maps-routes-v2:current} -->
36+
</dependency>
37+
<dependency>
38+
<groupId>com.google.api.grpc</groupId>
39+
<artifactId>proto-google-maps-routes-v2</artifactId>
40+
<version>0.0.1-SNAPSHOT</version><!-- {x-version-update:proto-google-maps-routes-v2:current} -->
41+
</dependency>
42+
</dependencies>
43+
</dependencyManagement>
44+
</project>

0 commit comments

Comments
0 (0)
Morty Proxy This is a proxified and sanitized view of the page, visit original site.