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

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

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

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

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

خطا: kGMSPlacesRateLimitExceeded

Places API (جدید)

Places SDK برای 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 (جدید) را با قیمت مورد انتظار پوشش می دهد. اگر نه، با مخاطب فروش خود در Google یا شریک خود تماس بگیرید تا در مورد نحوه گنجاندن این API صحبت کنید.

تغییرات کلی

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

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

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

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

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

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

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

تغییرات ویژه API

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