با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
توسعه دهندگان منطقه اقتصادی اروپا (EEA).
Places SDK برای Android (جدید) عملکرد بهبود یافته و یک مدل قیمت گذاری جدید را ارائه می دهد و به روز رسانی برنامه هایی که از Places SDK برای Android (Legacy) استفاده می کنند ارزشمند است. برای جزئیات بیشتر در مورد مقایسه ویژگی‌ها، به انتخاب SDK خود مراجعه کنید.
از این راهنما برای درک تفاوت‌های کلیدی Places SDK برای Android (جدید) در مقایسه با Places SDK برای Android (Legacy) و نحوه انجام تغییرات ضروری استفاده کنید.
بهترین شیوه های صدور صورت حساب برای مهاجرت
warning_amber
این راهنما در صورتی اعمال می‌شود که میزان استفاده از API شما به اندازه کافی بالا باشد تا به قیمت‌گذاری سطح دوم بروید. هنگام مهاجرت به نسخه جدیدتر یک API، برای SKU دیگری نیز صورتحساب دریافت می کنید. برای جلوگیری از افزایش هزینه‌ها در طول ماه انتقال، توصیه می‌کنیم تا حد امکان نزدیک به ابتدای ماه به APIهای جدید در حال تولید تغییر دهید. این تضمین می کند که در طول ماه مهاجرت به مقرون به صرفه ترین سطوح قیمت گذاری ماهانه برسید. برای اطلاعات در مورد سطوح قیمت‌گذاری، صفحه قیمت‌گذاری و پرسش‌های متداول قیمت‌گذاری را ببینید.
فعال کردن Places SDK برای Android (جدید)
Places SDK برای Android (Legacy) به سرویس Places API متکی است. برای استفاده از ویژگی‌های Places SDK برای Android (جدید)، ابتدا باید Places API (جدید) را در پروژه Google Cloud خود فعال کنید. برای اطلاعات بیشتر، به تنظیم پروژه Google Cloud خود مراجعه کنید.
سپس باید مطمئن شوید که Places API (جدید) را به کلید API مورد استفاده برنامه خود اضافه کرده اید. برای اطلاعات بیشتر، استفاده از کلیدهای API را ببینید.
تغییرات کلی
برخی از تغییرات کلی که برای چندین API اعمال می شود عبارتند از:
کلاس‌های جدیدی برای تعریف درخواست‌ها یا افزودن فیلدهای جدید به پاسخ اضافه شده‌اند.
شی پاسخ Place حاوی متد getReviews() جدید است که لیستی از اشیاء Review را برمی گرداند. هنگامی که برنامه شما اطلاعات به دست آمده از شی Place را نمایش می دهد، مانند عکس ها و نظرات، برنامه باید اسناد مورد نیاز را نیز نمایش دهد.
برای اطلاعات بیشتر، به اسناد مربوط به اسناد مراجعه کنید.
تغییرات ویژه API
این بخش شامل راهنماهای مهاجرت زیر برای هر API است:
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[],[],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)"]]
