Places SDK for Android（新）可提供更出色的性能和新的价格模式，因此值得更新使用 Places SDK for Android（旧）的应用。如需详细了解如何比较功能，请参阅选择 SDK。
本指南将帮助您了解 Places SDK for Android（新）与 Places SDK for Android（旧）之间的主要区别，以及如何处理必要的更改。
迁移结算方面的最佳实践
warning_amber
如果您的 API 用量足够高，可以采用第二级定价，则此指南适用。迁移到较新版本的 API 时，您还需要为不同的 SKU 付费。为避免在过渡当月增加费用，我们建议您在尽可能接近月初时切换到生产环境中的新 API。这样可确保您在迁移月份达到最具成本效益的月度价格层级。如需了解价格层级，请参阅价格页面和价格常见问题解答。
启用 Places SDK for Android（新）
Places SDK for Android（旧版）依赖于 Places API 服务。如需使用 Places SDK for Android（新）的功能，您必须先在 Google Cloud 项目中启用 Places API（新）。如需了解详情，请参阅设置您的 Google Cloud 项目。
然后，您必须确保已将 Places API（新）添加到您的应用所使用的 API 密钥中。如需了解详情，请参阅使用 API 密钥。
[null,null,["最后更新时间 (UTC)：2025-08-30。"],[],[],null,["# Migration overview\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\nThe Places SDK for Android (New) provides improved performance and a new\npricing model, making it worthwhile to update apps that use the\nPlaces SDK for Android (Legacy). For more details on comparing features,\nsee [Choose your SDK](/maps/documentation/places/android-sdk/choose-sdk).\n\nUse this guide to understand key differences in the\nPlaces SDK for Android (New) compared to the\nPlaces SDK for Android (Legacy), along with how to handle necessary\nchanges.\n\n\nBilling best practices for migration\n------------------------------------\n\nwarning_amber\n\nThis guidance applies if your API usage is high enough to\nmove into second-tier pricing. When migrating to a newer version of an API,\nyou're also being billed for a different SKU. To avoid increased costs during the month of\nyour transition, we recommend switching to the new APIs in production as close to the\nbeginning of the month as possible. This will ensure that you reach the most cost-effective\nmonthly pricing tiers during the migration month. For information about pricing tiers,\nsee the [pricing page](/maps/billing-and-pricing/pricing)\nand the [pricing FAQ](/maps/billing-and-pricing/faq).\n\n\u003cbr /\u003e\n\nEnable Places SDK for Android (New)\n-----------------------------------\n\nPlaces SDK for Android (Legacy) relies on the\n**Places API** service. To use the features of\nPlaces SDK for Android (New), you must first enable\n**Places API (New)** in your Google Cloud project. For more\ninformation, see [Set up your Google Cloud\nproject](/maps/documentation/places/android-sdk/cloud-setup).\n\nYou then must ensure that you have added **Places API\n(New)** to the API key used by your app. For more information, see [Use API\nKeys](/maps/documentation/places/android-sdk/get-api-key).\n\nGeneral changes\n---------------\n\nSome general changes that apply to multiple APIs include:\n\n- Uses a new pricing model. For pricing information for all APIs, see [Places SDK for Android\n (New)](/maps/billing-and-pricing/pricing#places-pricing).\n\n- [Place Details\n (New)](/maps/documentation/places/android-sdk/place-details), [Nearby Search\n (New)](/maps/documentation/places/android-sdk/nearby-search), and [Text Search\n (New)](/maps/documentation/places/android-sdk/text-search) require field\n masks to specify which fields you want returned in the response.\n\n- New classes have been added to define the requests or to add new fields to\n the response.\n\n- The response [`Place`](/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/model/Place)\n object contains the new\n [`getReviews()`](/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/model/Place#getReviews())\n method that returns a List of\n [`Review`](/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/model/Review)\n objects. When your app displays information obtained from the `Place`\n object, such as photos and reviews, the app must also display the required\n attributions.\n\n For more information, see the documentation on\n [attributions](/maps/documentation/places/android-sdk/policies#other_attribution_requirements).\n\n| **Note:** Because Text Search (New) and Nearby Search (New) were added to Places SDK for Android and did not replace any existing APIs, there is no migration required to use them.\n\nAPI-specific changes\n--------------------\n\nThis section includes the following migration guides for each API:\n\n- [Migrate to Place Details (New)](/maps/documentation/places/android-sdk/migrate-details)\n- [Migrate to Place Photo (New)](/maps/documentation/places/android-sdk/migrate-photo)\n- [Migrate to Autocomplete (New)](/maps/documentation/places/android-sdk/migrate-autocomplete)"]]
