Places SDK برای Android (جدید) عملکرد بهبود یافته و یک مدل قیمت گذاری جدید را ارائه می دهد و به روز رسانی برنامه هایی که از Places SDK برای Android (Legacy) استفاده می کنند ارزشمند است. برای جزئیات بیشتر در مورد مقایسه ویژگی‌ها، به انتخاب SDK خود مراجعه کنید.
از این راهنما برای درک تفاوت‌های کلیدی Places SDK برای Android (جدید) در مقایسه با Places SDK برای Android (Legacy) و نحوه انجام تغییرات ضروری استفاده کنید.
بهترین شیوه های صدور صورت حساب برای مهاجرت
این راهنما در صورتی اعمال می‌شود که میزان استفاده از API شما به اندازه کافی بالا باشد تا به قیمت‌گذاری سطح دوم بروید. هنگام مهاجرت به نسخه جدیدتر یک API، برای SKU دیگری نیز صورتحساب دریافت می کنید. برای جلوگیری از افزایش هزینه‌ها در طول ماه انتقال، توصیه می‌کنیم تا حد امکان نزدیک به ابتدای ماه به APIهای جدید در حال تولید تغییر دهید. این تضمین می کند که در طول ماه مهاجرت به مقرون به صرفه ترین سطوح قیمت گذاری ماهانه برسید. برای اطلاعات در مورد سطوح قیمت‌گذاری، صفحه قیمت‌گذاری و پرسش‌های متداول قیمت‌گذاری را ببینید.
فعال کردن Places API (جدید)
Places SDK برای Android (Legacy) به سرویس Places API متکی است. برای استفاده از ویژگی‌های Places SDK برای Android (جدید)، ابتدا باید Places API (جدید) را در پروژه Google Cloud خود فعال کنید. برای اطلاعات بیشتر، به تنظیم پروژه Google Cloud خود مراجعه کنید.
سپس باید اطمینان حاصل کنید که Places API (جدید) را به لیست APIهای مجاز در کلید مورد استفاده برنامه خود اضافه کرده اید. برای اطلاعات بیشتر، استفاده از کلیدهای API را ببینید.
مطمئن شوید که سهمیه کافی در Places API دارید (جدید)
مطمئن شوید که سهمیه کافی در Places API (جدید) برای پوشش ترافیک فعلی شما وجود دارد. برای بررسی و مدیریت سهمیه‌ها و محدودیت‌های استفاده، به سهمیه‌ها و هشدارهای سهمیه مراجعه کنید.
به تفاوت توجه کنید:
- سهمیه Places SDK برای Android (Legacy) به سهمیه سرویس Places API متکی است. این مجموع تمام متدهای Places API است.
- سهمیه Places SDK برای Android (جدید) به سهمیه سرویس Places API (جدید) متکی است. برای هر روش API یک سهمیه جداگانه وجود دارد.
بررسی کنید آیا توافقنامه مورد مذاکره شما شامل Places API (جدید) است
اگر توافق نامه ای دارید، بررسی کنید که Places API (جدید) را با قیمت مورد انتظار پوشش می دهد. اگر نه، با مسئول فروش خود در Google یا شریک خود تماس بگیرید تا در مورد نحوه گنجاندن این API صحبت کنید.
تغییرات کلی
برخی از تغییرات کلی که برای چندین API اعمال می شود عبارتند از:
از مدل قیمت گذاری جدید استفاده می کند. برای اطلاعات قیمت برای همه APIها، Places SDK for Android (جدید) را ببینید.
باید با فراخوانی متد
Places.initializeWithNewPlacesApiEnabled()برنامه خود را مقداردهی اولیه کنید. برای اطلاعات بیشتر در مورد انتخاب سرویس Places API، به راه اندازی پروژه Google Cloud خود مراجعه کنید.جزئیات مکان (جدید) ، جستجوی نزدیک (جدید) و جستجوی متن (جدید) نیاز به ماسک‌های فیلد دارند تا مشخص شود کدام قسمت‌ها را می‌خواهید در پاسخ بازگردانید.
کلاس‌های جدیدی برای تعریف درخواست‌ها یا افزودن فیلدهای جدید به پاسخ اضافه شده‌اند.
شی پاسخ
Placeحاوی متدgetReviews()جدید است که لیستی از اشیاءReviewرا برمی گرداند. هنگامی که برنامه شما اطلاعات به دست آمده از شیPlaceرا نمایش می دهد، مانند عکس ها و نظرات، برنامه باید اسناد مورد نیاز را نیز نمایش دهد.برای اطلاعات بیشتر، به اسناد مربوط به اسناد مراجعه کنید.
تغییرات ویژه API
این بخش شامل راهنماهای مهاجرت زیر برای هر API است:
- مهاجرت از جزئیات مکان (قدمتی) به جزئیات مکان (جدید)
- انتقال از عکس مکان (قدیمی) به عکس مکان (جدید)
- انتقال از تکمیل خودکار (قدیمی) به تکمیل خودکار (جدید)
- مهاجرت از مکان فعلی (قدمتی) به جستجوی نزدیک (جدید)