diff --git a/README.md b/README.md index 2df2287e..856189a2 100644 --- a/README.md +++ b/README.md @@ -7,13 +7,19 @@ ![GitHub contributors](https://img.shields.io/github/contributors/googlemaps/google-maps-services-java?color=green) [![Stack Exchange questions](https://img.shields.io/stackexchange/stackoverflow/t/google-maps?color=orange&label=google-maps&logo=stackoverflow)](https://stackoverflow.com/questions/tagged/google-maps) -> [!TIP] -> 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)). +> [!IMPORTANT] +> **Legacy APIs End of Sale & Newer Client Libraries** > -> - [Address Validation API](https://github.com/googleapis/google-cloud-java/tree/main/java-maps-addressvalidation) -> - [Datasets API](https://github.com/googleapis/google-cloud-java/tree/main/java-maps-mapsplatformdatasets) +> Several APIs supported by this library are in [Legacy status](https://developers.google.com/maps/legacy): +> - **Places API (Legacy):** This product is in [Legacy status](https://developers.google.com/maps/legacy). As of October 2026, Places API (Legacy) can no longer be enabled for new Google Cloud projects. Existing projects remain fully supported. For new features and improved performance, [migrate to Places API (New)](https://developers.google.com/maps/documentation/places/web-service/legacy/migrate-overview). +> - **Directions API (Legacy):** This product is in [Legacy status](https://developers.google.com/maps/legacy). As of October 2026, Directions API (Legacy) can no longer be enabled for new Google Cloud projects. Existing projects remain fully supported. For new features and improved performance, [migrate to the Routes API](https://developers.google.com/maps/documentation/routes/migrate-routes). +> - **Distance Matrix API (Legacy):** This product is in [Legacy status](https://developers.google.com/maps/legacy). As of October 2026, Distance Matrix API (Legacy) can no longer be enabled for new Google Cloud projects. Existing projects remain fully supported. For new features and improved performance, [migrate to the Routes API](https://developers.google.com/maps/documentation/routes/migrate-routes). +> +> If you are looking for Java client libraries for our newer APIs, see the [Google Maps Platform APIs in the Cloud Client Libraries for Java](https://github.com/googleapis/google-cloud-java/tree/main) ([overview](https://docs.cloud.google.com/apis/docs/cloud-client-libraries), [releases](https://github.com/googleapis/google-cloud-java/releases?q=maps&expanded=true)): > - [Places API (New)](https://github.com/googleapis/google-cloud-java/tree/main/java-maps-places) > - [Routes API](https://github.com/googleapis/google-cloud-java/tree/main/java-maps-routing) +> - [Address Validation API](https://github.com/googleapis/google-cloud-java/tree/main/java-maps-addressvalidation) +> - [Datasets API](https://github.com/googleapis/google-cloud-java/tree/main/java-maps-mapsplatformdatasets) > > The new APIs will not be added to this client library. @@ -26,15 +32,18 @@ Services] to your server-side Java application. The Java Client for Google Maps Services is a Java Client library for the following Google Maps APIs: -- [Directions API] -- [Distance Matrix API] - [Elevation API] - [Geocoding API] - [Maps Static API] -- [Places API] - [Roads API] - [Time Zone API] +As well as the following legacy APIs: + +- [Directions API (Legacy)][Directions API] +- [Distance Matrix API (Legacy)][Distance Matrix API] +- [Places API (Legacy)][Places API] + ## Requirements - Java 1.8 or later