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

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

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

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

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

خطا: kGMSPlacesRateLimitExceeded

فعال کردن Places SDK برای iOS (جدید)

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

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

تغییرات کلی

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

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

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

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

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

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

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

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

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