You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
[](http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22com.google.maps%22%20a%3A%22google-maps-services%22)
> If you are looking for Java client libraries for the following APIs, see the [Google Maps Platform APIs in the Cloud Client Libraries for Java](https://github.com/googleapis/google-cloud-java/tree/main) ([releases](https://github.com/googleapis/google-cloud-java/releases?q=maps&expanded=true)).
@@ -19,37 +25,32 @@
19
25
20
26
## Description
21
27
22
-
Use Java? Want to [geocode][Geocoding API] something? Looking for [directions][Directions API]?
23
-
Maybe [matrices of directions][Distance Matrix API]? This library brings the [Google Maps API Web
24
-
Services] to your server-side Java application.
25
-
26
-
The Java Client for Google Maps Services is a Java Client library for the following Google Maps
27
-
APIs:
28
+
Use Java? Want to [geocode][Geocoding API] something? Looking for [directions][Directions API]? This client library brings the following [Google Maps Web Services APIs] to your server-side Java applications:
28
29
30
+
-[Maps Static API]
29
31
-[Directions API]
30
32
-[Distance Matrix API]
31
33
-[Elevation API]
32
34
-[Geocoding API]
33
-
-[Maps Static API]
34
35
-[Places API]
35
36
-[Roads API]
36
37
-[Time Zone API]
37
38
38
39
## Requirements
39
40
40
-
- Java 1.8 or later
41
-
- A [Cloud project](https://developers.google.com/maps/get-started) with the relevant API(s) enabled
42
-
- An [API key](https://developers.google.com/maps/get-started) associated with the project above
41
+
*[Sign up with Google Maps Platform]
42
+
* A Google Maps Platform [project] with the desired API(s) from the above list enabled
43
+
* An [API key] associated with the project above
44
+
* Java 1.8+
45
+
46
+
## API Key Security
43
47
44
-
### API Key Security
48
+
This client library is designed for use in both server and Android applications.
45
49
46
-
The Java Client for Google Maps Services is designed for use in both server and Android applications.
47
-
In either case, it is important to add [API key restrictions](https://developers.google.com/maps/api-security-best-practices?hl=it)
48
-
to improve the security of your API key. Additional security measures, such as hiding your key
50
+
In either case, it is important to add [API key restrictions](https://developers.google.com/maps/api-security-best-practices#restricting-api-keys) to improve its security. Additional security measures, such as hiding your key
49
51
from version control, should also be put in place to further improve the security of your API key.
50
52
51
-
You can refer to [API Security Best Practices](https://developers.google.com/maps/api-security-best-practices) to learn
52
-
more about this topic.
53
+
Check out the [API Security Best Practices](https://developers.google.com/maps/api-security-best-practices) guide to learn more.
53
54
54
55
> [!NOTE]
55
56
> If you are using this library on Android, ensure that your application is using at least version 0.19.0 of this library so that API key restrictions can be enforced.
"1600 Amphitheatre Parkway Mountain View, CA 94043").await();
@@ -138,7 +135,7 @@ For more usage examples, check out [the tests](src/test/java/com/google/maps).
138
135
139
136
### Google App Engine Support
140
137
141
-
To use Google App Engine with this client library add the latest [App Engine dependency](https://mvnrepository.com/artifact/com.google.appengine/appengine-api-1.0-sdk)
138
+
To use [Google App Engine](https://cloud.google.com/appengine) with this client library add the latest [App Engine dependency](https://mvnrepository.com/artifact/com.google.appengine/appengine-api-1.0-sdk)
142
139
to your `build.gradle` file:
143
140
144
141
```groovy
@@ -147,17 +144,17 @@ dependencies {
147
144
}
148
145
```
149
146
150
-
You can then use this client library on Google App Engine with the following code change:
147
+
You can then use this client library on App Engine with the following code change:
The `new GaeRequestHandler.Builder()` argument to `GeoApiContext.Builder`'s `requestHandlerBuilder`
159
156
tells the Java Client for Google Maps Services to utilise the appropriate calls for making HTTP
160
-
requests from Google App Engine, instead of the default [OkHttp3](https://square.github.io/okhttp/)
157
+
requests from App Engine, instead of the default [OkHttp3](https://square.github.io/okhttp/)
161
158
based strategy.
162
159
163
160
### Rate Limiting
@@ -227,28 +224,52 @@ $ ./gradlew jar
227
224
$ ./gradlew test
228
225
```
229
226
230
-
## Terms
227
+
## Contributing
228
+
229
+
Contributions are welcome and encouraged! If you'd like to contribute, send us a [pull request] and refer to our [code of conduct] and [contributing guide].
230
+
231
+
## Terms of Service
231
232
232
-
This library uses Google Maps Platform services. Use of Google Maps Platform services through this library is subject to the [Google Maps Platform Terms of Service](https://cloud.google.com/maps-platform/terms).
233
+
This library uses Google Maps Platform services. Use of Google Maps Platform services through this library is subject to the Google Maps Platform [Terms of Service].
233
234
234
235
This library is not a Google Maps Platform Core Service. Therefore, the Google Maps Platform Terms of Service (e.g. Technical Support Services, Service Level Agreements, and Deprecation Policy) do not apply to the code in this library.
235
236
236
237
## Support
237
238
238
-
This library is offered via an open source license. It is not governed by the [Google Maps Platform Support Technical Support Services Guidelines](https://cloud.google.com/maps-platform/terms/tssg), the [SLA](https://cloud.google.com/maps-platform/terms/sla), or the [Deprecation Policy](https://cloud.google.com/maps-platform/terms) (however, any Google Maps Platform services used by the library remain subject to the Google Maps Platform Terms of Service).
239
+
This library is offered via an open source [license]. It is not governed by the Google Maps Platform Support [Technical Support Services Guidelines, the SLA, or the [Deprecation Policy]. However, any Google Maps Platform services used by the library remain subject to the Google Maps Platform Terms of Service.
239
240
240
-
This library adheres to [semantic versioning](https://semver.org/) to indicate when backwards-incompatible changes are introduced. Accordingly, while the library is in version 0.x, backwards-incompatible changes may be introduced at any time.
241
+
This library adheres to [semantic versioning] to indicate when backwards-incompatible changes are introduced. Accordingly, while the library is in version 0.x, backwards-incompatible changes may be introduced at any time.
241
242
242
-
If you find a bug, or have a feature request, please file an [issue][issues] on GitHub. If you would like to get answers to technical questions from other Google Maps Platform developers, ask through one of our [developer community channels](https://developers.google.com/maps/developer-community). If you'd like to contribute, please check the [Contributing guide][contrib] in the GitHub repository.
243
+
If you find a bug, or have a feature request, please [file an issue] on GitHub. If you would like to get answers to technical questions from other Google Maps Platform developers, ask through one of our [developer community channels]. If you'd like to contribute, please check the [contributing guide].
0 commit comments