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