Skip to content

Commit 0720279

Browse files
cloud-java-botdiegomarquezp
cloud-java-bot
and
diegomarquezp
authored
feat: [mapmanagement] new module for mapmanagement (#12874)
Generated by @diegomarquezp via [generate_new_client_hermetic_build.yaml](https://github.com/googleapis/google-cloud-java/actions/workflows/generate_new_client_hermetic_build.yaml) Command used: ``` python generation/new_client_hermetic_build/add-new-client-config.py add-new-library --api-shortname "mapmanagement" --name-pretty "Map Management API" --api-description "The Map Management API is a RESTful service that accepts HTTP requests for map styling data through a variety of methods. It returns formatted configuration data about map styling resources so that you can programmatically manage your Cloud-based map styles." --proto-path "google/maps/mapmanagement/v2beta" --product-docs "https://developers.google.com/maps/documentation/mapmanagement/overview" --library-name "maps-mapmanagement" --distribution-name "com.google.maps:google-maps-mapmanagement" ``` --------- Co-authored-by: Diego Marquez <diegomarquezp@google.com>
1 parent d1585fc commit 0720279

147 files changed

Lines changed: 48241 additions & 16 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.

‎generation_config.yaml‎

Lines changed: 35 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -188,7 +188,7 @@ libraries:
188188
product_documentation: https://docs.cloud.google.com/app-optimize/overview
189189
api_description: The App Optimize API provides developers and platform teams with
190190
tools to monitor, analyze, and improve the performance and cost-efficiency of
191-
their cloud applications.
191+
their cloud applications.
192192
client_documentation:
193193
https://cloud.google.com/java/docs/reference/google-cloud-appoptimize/latest/overview
194194
release_level: preview
@@ -1299,6 +1299,15 @@ libraries:
12991299
- proto_path: google/cloud/hypercomputecluster/v1beta
13001300
- proto_path: google/cloud/hypercomputecluster/v1
13011301
requires_billing: true
1302+
- api_shortname: iam-admin
1303+
name_pretty: IAM Admin API
1304+
product_documentation: https://cloud.google.com/iam/docs/apis
1305+
api_description: you to manage your Service Accounts and IAM bindings.
1306+
release_level: stable
1307+
distribution_name: com.google.cloud:google-iam-admin
1308+
api_id: iam.googleapis.com
1309+
GAPICs:
1310+
- proto_path: google/iam/admin/v1
13021311
- api_shortname: iam-policy
13031312
name_pretty: IAM
13041313
product_documentation: n/a
@@ -1316,15 +1325,6 @@ libraries:
13161325
- proto_path: google/iam/v2beta
13171326
- proto_path: google/iam/v3
13181327
- proto_path: google/iam/v3beta
1319-
- api_shortname: iam-admin
1320-
name_pretty: IAM Admin API
1321-
product_documentation: https://cloud.google.com/iam/docs/apis
1322-
api_description: you to manage your Service Accounts and IAM bindings.
1323-
release_level: stable
1324-
distribution_name: com.google.cloud:google-iam-admin
1325-
api_id: iam.googleapis.com
1326-
GAPICs:
1327-
- proto_path: google/iam/admin/v1
13281328
- api_shortname: iamcredentials
13291329
name_pretty: IAM Service Account Credentials API
13301330
product_documentation: https://cloud.google.com/iam/credentials/reference/rest/
@@ -1654,6 +1654,25 @@ libraries:
16541654
- proto_path: google/maps/geocode/v4
16551655
library_name: maps-geocode
16561656
requires_billing: true
1657+
- api_shortname: mapmanagement
1658+
name_pretty: Map Management API
1659+
product_documentation: https://developers.google.com/maps/documentation/mapmanagement/overview
1660+
api_description: The Map Management API is a RESTful service that accepts HTTP requests
1661+
for map styling data through a variety of methods. It returns formatted configuration
1662+
data about map styling resources so that you can programmatically manage your
1663+
Cloud-based map styles.
1664+
client_documentation:
1665+
https://cloud.google.com/java/docs/reference/google-maps-mapmanagement/latest/overview
1666+
release_level: preview
1667+
distribution_name: com.google.maps:google-maps-mapmanagement
1668+
api_id: mapmanagement.googleapis.com
1669+
library_type: GAPIC_AUTO
1670+
group_id: com.google.maps
1671+
cloud_api: false
1672+
GAPICs:
1673+
- proto_path: google/maps/mapmanagement/v2beta
1674+
library_name: maps-mapmanagement
1675+
requires_billing: true
16571676
- api_shortname: maps-mapsplatformdatasets
16581677
name_pretty: Maps Platform Datasets API
16591678
product_documentation: https://developers.google.com/maps/documentation
@@ -2923,12 +2942,12 @@ libraries:
29232942
product_documentation: https://cloud.google.com/web-risk/docs/
29242943
api_description: is a Google Cloud service that lets client applications check URLs
29252944
against Google's constantly updated lists of unsafe web resources. Unsafe web
2926-
resources include social engineering sites - such as phishing and deceptive sites - and
2927-
sites that host malware or unwanted software. With the Web Risk API, you can quickly
2928-
identify known bad sites, warn users before they click infected links, and prevent
2929-
users from posting links to known infected pages from your site. The Web Risk
2930-
API includes data on more than a million unsafe URLs and stays up to date by examining
2931-
billions of URLs each day.
2945+
resources include social engineering sites - such as phishing and deceptive sites
2946+
- and sites that host malware or unwanted software. With the Web Risk API, you
2947+
can quickly identify known bad sites, warn users before they click infected links,
2948+
and prevent users from posting links to known infected pages from your site. The
2949+
Web Risk API includes data on more than a million unsafe URLs and stays up to
2950+
date by examining billions of URLs each day.
29322951
release_level: stable
29332952
requires_billing: false
29342953
issue_tracker: ''

‎java-maps-mapmanagement/.OwlBot-hermetic.yaml‎

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

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

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
{
2+
"api_shortname": "mapmanagement",
3+
"name_pretty": "Map Management API",
4+
"product_documentation": "https://developers.google.com/maps/documentation/mapmanagement/overview",
5+
"api_description": "The Map Management API is a RESTful service that accepts HTTP requests for map styling data through a variety of methods. It returns formatted configuration data about map styling resources so that you can programmatically manage your Cloud-based map styles.",
6+
"client_documentation": "https://cloud.google.com/java/docs/reference/google-maps-mapmanagement/latest/overview",
7+
"release_level": "preview",
8+
"transport": "both",
9+
"language": "java",
10+
"repo": "googleapis/google-cloud-java",
11+
"repo_short": "java-maps-mapmanagement",
12+
"distribution_name": "com.google.maps:google-maps-mapmanagement",
13+
"api_id": "mapmanagement.googleapis.com",
14+
"library_type": "GAPIC_AUTO",
15+
"requires_billing": true
16+
}

‎java-maps-mapmanagement/README.md‎

Lines changed: 182 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,182 @@
1+
# Google Map Management API Client for Java
2+
3+
Java idiomatic client for [Map Management 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-mapmanagement</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-mapmanagement: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-mapmanagement" % "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 Map Management API APIs, and the authenticated principal must have the [IAM role(s)][predefined-iam-roles] required to access GCP resources using the Map Management 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 Map Management API [API enabled][enable-api].
54+
You will need to [enable billing][enable-billing] to use Google Map Management 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 Command Line Interface][cloud-cli] 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-mapmanagement` library. See the [Quickstart](#quickstart) section
62+
to add `google-maps-mapmanagement` as a dependency in your code.
63+
64+
## About Map Management API
65+
66+
67+
[Map Management API][product-docs] The Map Management API is a RESTful service that accepts HTTP requests for map styling data through a variety of methods. It returns formatted configuration data about map styling resources so that you can programmatically manage your Cloud-based map styles.
68+
69+
See the [Map Management API client library docs][javadocs] to learn how to
70+
use this Map Management 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+
Map Management API uses both gRPC and HTTP/JSON 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+
Java is a registered trademark of Oracle and/or its affiliates.
156+
157+
[product-docs]: https://developers.google.com/maps/documentation/mapmanagement/overview
158+
[javadocs]: https://cloud.google.com/java/docs/reference/google-maps-mapmanagement/latest/overview
159+
[stability-image]: https://img.shields.io/badge/stability-preview-yellow
160+
[maven-version-image]: https://img.shields.io/maven-central/v/com.google.maps/google-maps-mapmanagement.svg
161+
[maven-version-link]: https://central.sonatype.com/artifact/com.google.maps/google-maps-mapmanagement/0.0.0
162+
[authentication]: https://github.com/googleapis/google-cloud-java#authentication
163+
[auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes
164+
[predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles
165+
[iam-policy]: https://cloud.google.com/iam/docs/overview#cloud-iam-policy
166+
[developer-console]: https://console.developers.google.com/
167+
[create-project]: https://cloud.google.com/resource-manager/docs/creating-managing-projects
168+
[cloud-cli]: https://cloud.google.com/cli
169+
[troubleshooting]: https://github.com/googleapis/google-cloud-java/blob/main/TROUBLESHOOTING.md
170+
[contributing]: https://github.com/googleapis/google-cloud-java/blob/main/CONTRIBUTING.md
171+
[code-of-conduct]: https://github.com/googleapis/google-cloud-java/blob/main/CODE_OF_CONDUCT.md#contributor-code-of-conduct
172+
[license]: https://github.com/googleapis/google-cloud-java/blob/main/LICENSE
173+
[enable-billing]: https://cloud.google.com/apis/docs/getting-started#enabling_billing
174+
[enable-api]: https://console.cloud.google.com/flows/enableapi?apiid=mapmanagement.googleapis.com
175+
[libraries-bom]: https://github.com/GoogleCloudPlatform/cloud-opensource-java/wiki/The-Google-Cloud-Platform-Libraries-BOM
176+
[shell_img]: https://gstatic.com/cloudssh/images/open-btn.png
177+
178+
[semver]: https://semver.org/
179+
[cloudlibs]: https://cloud.google.com/apis/docs/client-libraries-explained
180+
[apilibs]: https://cloud.google.com/apis/docs/client-libraries-explained#google_api_client_libraries
181+
[oracle]: https://www.oracle.com/java/technologies/java-se-support-roadmap.html
182+
[g-c-j]: http://github.com/googleapis/google-cloud-java

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

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

0 commit comments

Comments
 (0)