This topic lists all Google Maps Platform products and features that are
currently, or scheduled to be, in the
[Legacy](https://developers.google.com/maps/launch-stages.md.txt#legacy) stage.

## How Legacy status works

Legacy is an intermediate lifecycle step to ease the transition between
Generally Available services and Deprecated services.

- Legacy-marked services will be officially feature frozen, and new feature requests will only be considered for updated non-Legacy services.
- Legacy-marked services will retain full support.
- Existing projects already using Legacy services can continue to do so.

  While we envision that Legacy services will be turned down in the coming
  years, there is no date yet for when this will happen.

Subject to the [Google Maps Platform Terms of
Service](https://cloud.google.com/maps-platform/terms) Deprecation
Policy, we will provide at least a 12-month notice prior to the decommission of
the services.

## Active services with Legacy status

This section lists all products and features which are either Legacy or
scheduled to be in Legacy.

| Product Area | Legacy Service Name | Legacy Date | New Service Name | Migration guide |
|---|---|---|---|---|
| Routes | [Distance Matrix API](https://developers.google.com/maps/documentation/distance-matrix/overview.md.txt) | March 1, 2025 | [Routes API](https://developers.google.com/maps/documentation/routes) | [Guide](https://developers.google.com/maps/documentation/routes/migrate-routes.md.txt) |
| Routes | [Directions API](https://developers.google.com/maps/documentation/directions/overview.md.txt) | March 1, 2025 | [Routes API](https://developers.google.com/maps/documentation/routes) | [Guide](https://developers.google.com/maps/documentation/routes/migrate-routes.md.txt) |
| Routes | JavaScript [Distance Matrix Service](https://developers.google.com/maps/documentation/javascript/distancematrix) | March 1, 2025 | [RouteMatrix Class](https://developers.google.com/maps/documentation/javascript/routes/route-matrix-class-overview.md.txt) | [Guide](https://developers.google.com/maps/documentation/javascript/routes/route-matrix-js-migration.md.txt) |
| Routes | JavaScript [Directions Service](https://developers.google.com/maps/documentation/javascript/directions) | March 1, 2025 | [Route Class](https://developers.google.com/maps/documentation/javascript/routes/route-class-overview.md.txt) | [Guide](https://developers.google.com/maps/documentation/javascript/routes/routes-js-migration.md.txt) |
| Places | [Places API](https://developers.google.com/maps/documentation/places/web-service/search) | March 1, 2025 | [Places API (New)](https://developers.google.com/maps/documentation/places/web-service/op-overview.md.txt) | [Guide](https://developers.google.com/maps/documentation/places/web-service/migrate-overview) |
| Places | JavaScript [Places Service](https://developers.google.com/maps/documentation/javascript/places) | March 1, 2025 | [Place Class](https://developers.google.com/maps/documentation/javascript/place.md.txt) | [Guide](https://developers.google.com/maps/documentation/javascript/places-migration-overview) |
| Places | [Places SDK for Android](https://developers.google.com/maps/documentation/places/android-sdk/autocomplete) | March 1, 2025 | [Places SDK for Android (New)](https://developers.google.com/maps/documentation/places/android-sdk/place-autocomplete.md.txt) | [Guide](https://developers.google.com/maps/documentation/places/android-sdk/migrate-overview) |
| Places | [Places SDK for iOS](https://developers.google.com/maps/documentation/places/ios-sdk/place-details) | March 1, 2025 | [Places SDK for iOS (New)](https://developers.google.com/maps/documentation/places/ios-sdk/place-autocomplete.md.txt) | [Guide](https://developers.google.com/maps/documentation/places/ios-sdk/migrate-overview) |

## LegacyApiNotActivatedMapError

Google throws this error when your application is querying a legacy API (the
[Places API (Legacy)](https://developers.google.com/places/web-service/overview-legacy), the [Directions API (Legacy)](https://developers.google.com/maps/documentation/directions/overview.md.txt), or the [Distance Matrix API (Legacy)](https://developers.google.com/maps/documentation/distance-matrix/overview.md.txt)) that isn't enabled on your project. In most cases, keep legacy APIs
disabled on new projects.

If you own the application that's throwing this error, use the [equivalent new
API](https://developers.google.com/maps/legacy#active_services_with_legacy_status) instead (such as the [Places API (New)](https://developers.google.com/maps/documentation/places/web-service/op-overview.md.txt) or the [Routes API](https://developers.google.com/maps/documentation/routes/overview)).

**Upgrading with an AI coding assistant:** Many AI coding assistants generate
code for legacy APIs by default. If you use an AI assistant, copy the prompt
for your target API to migrate your code:

- **Migrate to the Places API (New):**

  ```text
  Refactor this code to replace the legacy Google Maps Places API (or Maps JavaScript API PlacesService) with the Places API (New) (or the Maps JavaScript API Place class). Fetch the latest official documentation from https://developers.google.com/maps/documentation/places/web-service/migrate-overview and https://developers.google.com/maps/documentation/javascript/places-migration-overview before generating code, and include the required FieldMask parameter.
  ```
- **Migrate to the Routes API:**

  ```text
  Refactor this code to replace the legacy Google Maps Directions API or Distance Matrix API with the Routes API (computeRoutes or computeRouteMatrix). Fetch the latest official documentation from https://developers.google.com/maps/documentation/routes/migrate-routes before generating code, and include the required X-Goog-FieldMask header.
  ```

If you don't own the application that's throwing this error, report this issue
to your application provider by sharing this URL with them, and follow their
instructions to upgrade to a new version. As a short-term solution while you
migrate or wait for an update, you can activate the legacy API after completing
a brief feedback form:

- [The Places API (Legacy)](https://google.qualtrics.com/jfe/form/SV_5pgy4SPedA5KeIC?api=places_legacy&utm_source=Docs_error_LegacyApiNotActivatedMapError)
- [The Directions API (Legacy)](https://google.qualtrics.com/jfe/form/SV_5pgy4SPedA5KeIC?api=directions_legacy&utm_source=Docs_error_LegacyApiNotActivatedMapError)
- [The Distance Matrix API (Legacy)](https://google.qualtrics.com/jfe/form/SV_5pgy4SPedA5KeIC?api=distancematrix_legacy&utm_source=Docs_error_LegacyApiNotActivatedMapError)