نمای کلی انتقال

«کیت توسعه نرم‌افزار مکان‌ها، ویژه iOS (جدید)» عملکرد بهبودیافته و مدل قیمت‌گذاری جدیدی ارائه می‌دهد، که به‌روزرسانی برنامه‌هایی را که از «کیت توسعه نرم‌افزار مکان‌ها، ویژه iOS (قدیمی)» استفاده می‌کنند ارزشمند می‌کند. برای جزئیات بیشتر درباره مقایسه ویژگی‌ها، انتخاب کیت توسعه نرم‌افزار را ببینید.

از این راهنما برای درک تفاوت‌های کلیدی در Places SDK برای iOS (جدید) در مقایسه با Places SDK برای iOS (قدیمی) و همچنین نحوه مدیریت تغییرات ضروری استفاده کنید.

روال‌های مطلوب صورت‌حساب برای انتقال

این راهنمایی زمانی کاربرد دارد که استفاده شما از API به‌اندازه‌ای بالا باشد که به سطح دوم قیمت‌گذاری منتقل شوید. هنگام انتقال به نسخه جدیدتر API، صورت‌حساب SKU دیگری نیز برایتان صادر می‌شود. برای جلوگیری از افزایش هزینه‌ها در ماه انتقال، توصیه می‌کنیم تا حد امکان در ابتدای ماه به «میاناهای برنامه‌سازی کاربردی» جدید در مرحله تولید تغییر دهید. این کار تضمین می‌کند که در ماه انتقال به مقرون‌به‌صرفه‌ترین سطوح قیمت‌گذاری ماهانه دست یابید. برای اطلاعات درباره سطوح قیمت‌گذاری، صفحه قیمت‌گذاری و پرسشگان قیمت‌گذاری را ببینید.

خطا: kGMSPlacesRateLimitExceeded

Places API (جدید)

«کیت توسعه نرم‌افزار مکان‌ها، ویژه iOS» به سرویس Places API متکی است. برای استفاده از ویژگی‌های Places SDK for iOS (جدید)، ابتدا باید Places API (جدید) را در پروژه Google Cloud خود فعال کنید. برای اطلاعات بیشتر، به راه‌اندازی پروژه Google Cloud مراجعه کنید.

سپس باید تأیید کنید که کیت توسعه نرم‌افزار «مکان‌ها برای iOS (جدید)» را به فهرست میاناهای برنامه‌سازی کاربردی مجاز در کلید مورداستفاده برنامه‌تان اضافه کرده‌اید. برای کسب اطلاعات بیشتر، استفاده از کلیدهای میانای برنامه‌سازی کاربردی را ببینید.

مطمئن شوید که در Places API (جدید) سهمیه کافی دارید

مطمئن شوید که در «کیت توسعه نرم‌افزار مکان‌ها برای iOS (جدید)» سهمیه کافی برای پوشش دادن ترافیک فعلی‌تان در «کیت توسعه نرم‌افزار مکان‌ها برای iOS (قدیمی)» وجود دارد. برای بررسی و مدیریت سهمیه‌ها و حدود استفاده، به سهمیه‌ها و هشدارهای سهمیه مراجعه کنید. تفاوت‌های بین دو API را درنظر بگیرید:

  • سهمیه Places SDK for iOS (Legacy) به سهمیه سرویس Places API (Legacy) وابسته است. این مقدار مجموع همه روش‌های Places API است.
  • سهمیه Places SDK for iOS (New) به سهمیه سرویس Places API (New) وابسته است. برای هر روش API سهمیه جداگانه‌ای وجود دارد.

بررسی کنید که آیا قرارداد مذاکره‌شده شما شامل Places API (جدید) می‌شود یا نه

اگر قرارداد مذاکره‌شده‌ای دارید، بررسی کنید که Places API (جدید) را با قیمت‌گذاری موردانتظار پوشش دهد. اگر نه، با مخاطب «فروش» خود در Google یا شریکتان تماس بگیرید تا درباره نحوه افزودن این API صحبت کنید.

تغییرات کلی

برخی‌از تغییرات کلی که برای چندین API اعمال می‌شود عبارت‌اند از:

  • از مدل قیمت‌گذاری جدیدی استفاده می‌کند. برای اطلاعات قیمت‌گذاری همه میاناهای برنامه‌سازی کاربردی، به قیمت‌گذاری برای Places SDK for iOS (New) مراجعه کنید.

  • جزئیات مکان (جدید)، جستجوی اطراف (جدید)، و جستجوی نوشتاری (جدید) به ماسک‌های فیلد نیاز دارند تا مشخص شود کدام فیلدها را می‌خواهید در پاسخ برگردانید.

  • GMSPlacesClient شامل روش‌های جدیدی برای فراخوانی این «میاناهای برنامه‌سازی کاربردی» جدید است.

  • کلاس‌های جدیدی برای تعریف درخواست هریک از میاناهای برنامه‌سازی کاربردی جدید اضافه شده است.

  • نمونه GMSPlace پاسخ حاوی reviews دارایی جدید از نوع GMSPlaceReview است. وقتی برنامه‌تان اطلاعاتی را که از نمونه GMSPlace به‌دست آورده است نمایش می‌دهد، مثل عکس‌ها و مرورها، برنامه باید اسناد موردنیاز را نیز نمایش دهد.

    برای اطلاعات بیشتر، به مستندات مربوط به اسناد مراجعه کنید.

تغییرات ویژه میانای برنامه‌سازی کاربردی

این بخش شامل راهنمای انتقال زیر برای هر «میانای برنامه‌سازی کاربردی» است: