بررسی اجمالی مهاجرت

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

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

بهترین شیوه‌های صدور صورتحساب برای مهاجرت

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

خطا: kGMSPlacesRateLimitExceeded

API مکان‌ها (جدید)

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

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

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

مطمئن شوید که سهمیه کافی در Places SDK برای iOS (جدید) برای پوشش ترافیک فعلی شما در Places SDK برای iOS وجود دارد. برای بررسی و مدیریت سهمیه‌ها و محدودیت‌های استفاده خود، به بخش سهمیه‌ها و هشدارهای سهمیه مراجعه کنید. به تفاوت‌های بین دو API توجه کنید:

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

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

اگر توافق‌نامه‌ی مذاکره‌شده‌ای دارید، بررسی کنید که آیا شامل Places API (جدید) به همراه قیمت مورد انتظار می‌شود یا خیر. در غیر این صورت، با مسئول فروش خود در گوگل یا شریکتان تماس بگیرید تا در مورد نحوه‌ی گنجاندن این API صحبت کنید.

تغییرات کلی

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

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

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

  • GMSPlacesClient شامل متدهای جدیدی برای فراخوانی این APIهای جدید است.

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

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

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

تغییرات خاص API

این بخش شامل راهنماهای مهاجرت زیر برای هر API است: