Skip to content

Commit 3037ab3

Browse files
noahdietznoahdietz
authored
feat(maps-isochrones): onboard v1 API (#13817)
1 parent c9738ea commit 3037ab3

44 files changed

Lines changed: 10252 additions & 0 deletions

File tree

Some content is hidden

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

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

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
{
2+
"api_shortname": "isochrones",
3+
"name_pretty": "Isochrones",
4+
"product_documentation": "https://developers.google.com/maps/documentation/isochrones/overview",
5+
"api_description": "isochrones.googleapis.com API.",
6+
"client_documentation": "https://cloud.google.com/java/docs/reference/google-maps-isochrones/latest/overview",
7+
"release_level": "preview",
8+
"transport": "grpc+rest",
9+
"language": "java",
10+
"repo": "googleapis/google-cloud-java",
11+
"repo_short": "java-maps-isochrones",
12+
"distribution_name": "com.google.maps:google-maps-isochrones",
13+
"api_id": "isochrones.googleapis.com",
14+
"library_type": "GAPIC_AUTO"
15+
}

‎java-maps-isochrones/README.md‎

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

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

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
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-isochrones-bom</artifactId>
6+
<version>0.1.0-SNAPSHOT</version><!-- {x-version-update:google-maps-isochrones:current} -->
7+
<packaging>pom</packaging>
8+
<parent>
9+
<groupId>com.google.cloud</groupId>
10+
<artifactId>google-cloud-pom-parent</artifactId>
11+
<version>1.89.0-SNAPSHOT</version><!-- {x-version-update:google-cloud-pom-parent:current} -->
12+
<relativePath>../../google-cloud-pom-parent/pom.xml</relativePath>
13+
</parent>
14+
15+
<name>Google Isochrones BOM</name>
16+
<description>
17+
BOM for Isochrones
18+
</description>
19+
20+
<properties>
21+
<maven.antrun.skip>true</maven.antrun.skip>
22+
</properties>
23+
24+
<dependencyManagement>
25+
<dependencies>
26+
<!-- {x-generated-dependencies-start} -->
27+
<dependency>
28+
<groupId>com.google.maps</groupId>
29+
<artifactId>google-maps-isochrones</artifactId>
30+
<version>0.1.0-SNAPSHOT</version><!-- {x-version-update:google-maps-isochrones:current} -->
31+
</dependency>
32+
<dependency>
33+
<groupId>com.google.maps.api.grpc</groupId>
34+
<artifactId>grpc-google-maps-isochrones-v1</artifactId>
35+
<version>0.1.0-SNAPSHOT</version><!-- {x-version-update:grpc-google-maps-isochrones-v1:current} -->
36+
</dependency>
37+
<dependency>
38+
<groupId>com.google.maps.api.grpc</groupId>
39+
<artifactId>proto-google-maps-isochrones-v1</artifactId>
40+
<version>0.1.0-SNAPSHOT</version><!-- {x-version-update:proto-google-maps-isochrones-v1:current} -->
41+
</dependency>
42+
<!-- {x-generated-dependencies-end} -->
43+
</dependencies>
44+
</dependencyManagement>
45+
</project>

‎java-maps-isochrones/google-maps-isochrones/pom.xml‎

Lines changed: 117 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,117 @@
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-isochrones</artifactId>
6+
<version>0.1.0-SNAPSHOT</version><!-- {x-version-update:google-maps-isochrones:current} -->
7+
<packaging>jar</packaging>
8+
<name>Google Isochrones</name>
9+
<description>Isochrones isochrones.googleapis.com API.</description>
10+
<parent>
11+
<groupId>com.google.maps</groupId>
12+
<artifactId>google-maps-isochrones-parent</artifactId>
13+
<version>0.1.0-SNAPSHOT</version><!-- {x-version-update:google-maps-isochrones:current} -->
14+
</parent>
15+
<properties>
16+
<site.installationModule>google-maps-isochrones</site.installationModule>
17+
</properties>
18+
<dependencies>
19+
<dependency>
20+
<groupId>io.grpc</groupId>
21+
<artifactId>grpc-api</artifactId>
22+
</dependency>
23+
<dependency>
24+
<groupId>io.grpc</groupId>
25+
<artifactId>grpc-stub</artifactId>
26+
</dependency>
27+
<dependency>
28+
<groupId>io.grpc</groupId>
29+
<artifactId>grpc-protobuf</artifactId>
30+
</dependency>
31+
<dependency>
32+
<groupId>com.google.api</groupId>
33+
<artifactId>api-common</artifactId>
34+
</dependency>
35+
<dependency>
36+
<groupId>com.google.protobuf</groupId>
37+
<artifactId>protobuf-java</artifactId>
38+
</dependency>
39+
<dependency>
40+
<groupId>com.google.api.grpc</groupId>
41+
<artifactId>proto-google-common-protos</artifactId>
42+
</dependency>
43+
<!-- {x-generated-proto-dependencies-start} -->
44+
<dependency>
45+
<groupId>com.google.maps.api.grpc</groupId>
46+
<artifactId>proto-google-maps-isochrones-v1</artifactId>
47+
</dependency>
48+
<!-- {x-generated-proto-dependencies-end} -->
49+
<dependency>
50+
<groupId>com.google.guava</groupId>
51+
<artifactId>guava</artifactId>
52+
</dependency>
53+
<dependency>
54+
<groupId>com.google.api</groupId>
55+
<artifactId>gax</artifactId>
56+
</dependency>
57+
<dependency>
58+
<groupId>com.google.api</groupId>
59+
<artifactId>gax-grpc</artifactId>
60+
</dependency>
61+
<dependency>
62+
<groupId>com.google.api</groupId>
63+
<artifactId>gax-httpjson</artifactId>
64+
</dependency>
65+
<dependency>
66+
<groupId>com.google.api.grpc</groupId>
67+
<artifactId>proto-google-iam-v1</artifactId>
68+
</dependency>
69+
<dependency>
70+
<groupId>org.threeten</groupId>
71+
<artifactId>threetenbp</artifactId>
72+
</dependency>
73+
74+
<!-- Test dependencies -->
75+
<dependency>
76+
<groupId>com.google.api.grpc</groupId>
77+
<artifactId>grpc-google-common-protos</artifactId>
78+
<scope>test</scope>
79+
</dependency>
80+
<dependency>
81+
<groupId>com.google.api.grpc</groupId>
82+
<artifactId>grpc-google-iam-v1</artifactId>
83+
<scope>test</scope>
84+
</dependency>
85+
<dependency>
86+
<groupId>junit</groupId>
87+
<artifactId>junit</artifactId>
88+
<scope>test</scope>
89+
</dependency>
90+
<!-- {x-generated-grpc-dependencies-start} -->
91+
<dependency>
92+
<groupId>com.google.maps.api.grpc</groupId>
93+
<artifactId>grpc-google-maps-isochrones-v1</artifactId>
94+
<scope>test</scope>
95+
</dependency>
96+
<!-- {x-generated-grpc-dependencies-end} -->
97+
<!-- Need testing utility classes for generated gRPC clients tests -->
98+
<dependency>
99+
<groupId>com.google.api</groupId>
100+
<artifactId>gax</artifactId>
101+
<classifier>testlib</classifier>
102+
<scope>test</scope>
103+
</dependency>
104+
<dependency>
105+
<groupId>com.google.api</groupId>
106+
<artifactId>gax-grpc</artifactId>
107+
<classifier>testlib</classifier>
108+
<scope>test</scope>
109+
</dependency>
110+
<dependency>
111+
<groupId>com.google.api</groupId>
112+
<artifactId>gax-httpjson</artifactId>
113+
<classifier>testlib</classifier>
114+
<scope>test</scope>
115+
</dependency>
116+
</dependencies>
117+
</project>

0 commit comments

Comments
 (0)