نسخه SDK خود را انتخاب کنید

Places SDK برای iOS نسخه 8.5.0 از دو نسخه SDK پشتیبانی می کند: Places SDK برای iOS ، مکان های SDK موجود برای iOS (جدید) نسخه نسل بعدی SDK است.

توجه: همه ویژگی‌های جدید موجود در این نسخه بخشی از Places SDK برای iOS (جدید) هستند و در Places SDK برای iOS در دسترس نیستند.

با انتشار Places SDK برای iOS نسخه 8.5.0، اولین وظیفه شما این است که تصمیم بگیرید از کدام SDK استفاده کنید. اگر شما یک مشتری جدید یا مشتری فعلی هستید که قبلاً از SDK استفاده می‌کنید، این درست است. از این راهنما برای درک تفاوت های کلیدی بین دو SDK استفاده کنید.

نحوه انتخاب نسخه SDK

Places SDK برای iOS به سرویس Places API متکی است. قبل از اینکه بتوانید از Places SDK برای iOS استفاده کنید، باید سرویس Places API را در پروژه Google Cloud خود فعال کنید.

نسخه سرویس Places API که فعال می کنید، نسخه SDK مورد استفاده برنامه شما را کنترل می کند:

• Places API : Places SDK موجود برای iOS را فعال می کند. اگر فقط Places API برای پروژه مرتبط با کلید API استفاده شده برای برنامه شما فعال باشد، برنامه شما به ویژگی های جدید اضافه شده در Places SDK برای iOS نسخه 8.5.0 و جدیدتر دسترسی نخواهد داشت.

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

• هر دو : همه ویژگی‌ها را برای Places SDK برای iOS (جدید) و Places SDK برای iOS فعال می‌کند.

برای اطلاعات بیشتر در مورد انتخاب سرویس Places API، به راه اندازی پروژه Google Cloud خود مراجعه کنید.

کدام SDK را انتخاب می کنید؟

برای کمک به تصمیم گیری برای انتخاب نسخه:

1. اگر مشتری جدیدی هستید که به تازگی با Places SDK برای iOS شروع کرده اید، با هر دو API Places (جدید) و Places API شروع کنید تا به همه ویژگی ها دسترسی داشته باشید.

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

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

ویژگی‌های کلیدی اضافه شده به Places SDK برای iOS (جدید)

این بخش ویژگی های کلیدی اضافه شده به Places SDK برای iOS (جدید) را پوشش می دهد.

بر روی پلت فرم استاندارد Google Cloud پیاده سازی شده است

Places SDK برای iOS (جدید) در زیرساخت خدمات در Google Cloud پیاده سازی شده است. این پیاده سازی یک پلت فرم امن تر و قابل اعتمادتر را به ارمغان می آورد. این طراحی استاندارد سطحی از سازگاری را در بین SDK ها به ارمغان می آورد که کارایی توسعه را با Places SDK برای iOS (جدید) بهبود می بخشد.

عملکرد بهبود یافته است

Places SDK برای iOS (جدید) عملکرد بهبود یافته ای را ارائه می دهد و جایگزینی برنامه هایی که از SDK موجود استفاده می کنند ارزشمند است.

سرویس جستجوی متن جدید

جستجوی متن اطلاعات مجموعه‌ای از مکان‌ها را بر اساس یک رشته برمی‌گرداند - برای مثال «پیتزا در نیویورک» یا «فروشگاه‌های کفش در نزدیکی اتاوا» یا «خیابان اصلی ۱۲۳». این سرویس با فهرستی از مکان‌های منطبق با رشته متن و هرگونه سوگیری مکان تنظیم شده پاسخ می‌دهد.

قیمت گذاری ساده شده

قیمت گذاری با Places SDK برای iOS (جدید) ساده شده است به طوری که شما فقط برای داده هایی که استفاده می کنید پرداخت می کنید. قیمت گذاری ساده شده با استفاده از لیست های فیلد، که به آن ماسک های میدان نیز می گویند، اجرا می شود.

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

برای اطلاعات دقیق قیمت گذاری برای هر دو SDK، استفاده و صورتحساب را ببینید.

توجه: مدل قیمت گذاری جدید فقط برای جستجوی متن اعمال می شود. قیمت تکمیل خودکار مکان، جزئیات مکان و مکان فعلی برای هر دو SDK یکسان است.

انواع مکان های گسترده

SDK جدید انواع مکان های نشان داده شده در جدول زیر را اضافه می کند. این انواع به عنوان بخشی از پاسخ جزئیات مکان و جستجوی متن برگردانده می شوند. همچنین می توانید از این انواع جدید و انواع موجود در جستجو با جستجوی متن استفاده کنید. انواع جدید در جدول A آمده است.

تایپ کنید
رستوران_آمریکایی	تخفیف_فروشگاه	بستنی فروشی	ساندویچ_فروشی
مرکز_تفریح	سگ_پارک	رستوران هندی	محدوده مدرسه
رشته_ ورزشی	ایستگاه_شارژ_خودرو_برقی	اندونزی_رستوران	رستوران غذاهای دریایی
فروشگاه_قطعات_خودرو	رویداد_محل برگزاری	رستوران ایتالیایی	پیست اسکی
سالن های ضیافت	طولانی_ اقامت_هتل	رستوران ژاپنی	رستوران_اسپانیایی
باربیکیو_رستوران	مزرعه	رستوران_کوری	فروشگاه_کالاهای_ورزشی
آرایشگاه	مزرعه	رستوران_لبنانی	باشگاه ورزشی
تخت_و_صبحانه	رستوران فست فود	مارینا	مجموعه ورزشی
رستوران_برزیلی	ترمینال_فری	بازار	استیک_خانه
صبحانه_رستوران	مرکز تناسب اندام	آزمایشگاه_پزشکی	سوشی_رستوران
برانچ_رستوران	رستوران فرانسوی	رستوران_مدیترانه ای	استخر
ایستگاه اتوبوس	هدیه_فروشگاه	رستوران مکزیکی	خیاط
کمپینگ_کابین	زمین_گلف	رستوران_خاورمیانه	ارائه دهنده خدمات_ مخابراتی
فروشگاه_موبایل	یونانی_رستوران	متل	تای_رستوران
آژانس_مراقبت_کودک	فروشگاه بقالی	پارک ملی	transit_depot
رستوران چینی	مهمان خانه	پارک_و_سواری	کامیون_ایست
کافی شاپ	سالن آرایش	تئاتر_هنرهای_نمایش	رستوران_تورکی
مرکز ارتباطات	همبرگر_رستوران	پیتزا_رستوران	رستوران_وگان
مشاور	هلی فرودگاه	زمین بازی	رستوران_گیاهی
مرکز کنوانسیون	منطقه پیاده روی	پیش دبستانی	رستوران_ویتنامی
کلبه	نشانه_ تاریخی	اتاق_مهمان_خصوصی	بازدید کننده_مرکز
پیک_خدمات	خانه_بهبود_فروشگاه	رامن_رستوران	محل برگزاری عروسی
مرکز فرهنگی	خوابگاه	resort_hotel	عمده فروش
کلینیک دندانپزشکی	هتل	استراحت_توقف

همراه با این انواع جدید، Places API (جدید) انواع زیر را از جدول B از جدول A منتقل کرد. یعنی اکنون می توانید از این انواع به عنوان بخشی از جستجو استفاده کنید:

• country
• administrative_area_level_1
• administrative_area_level_2
• postal_code
• locality