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

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

شماره‌های نسخه SDK

شماره نسخه SDK که در وابستگی‌های بسته خود مشخص می‌کنید تعیین می‌کند که آیا برنامه شما به ویژگی‌هایی که در نسخه خاصی اضافه شده‌اند دسترسی دارد یا خیر. برای مثال، تکمیل خودکار (جدید) فقط در SDK نسخه 9.0.0 یا بالاتر موجود است.

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

نسخه‌های API Places برای Places SDK برای iOS

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

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

برای انتخاب ویژگی‌های SDK در برنامه‌تان، موارد زیر را انجام دهید:

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

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

ویژگی های SDK در هر نسخه موجود است

جدول زیر نشان می دهد که کدام نسخه SDK و API برای هر ویژگی SDK مورد نیاز است:

Places SDK برای iOS (جدید) حداقل نسخه SDK مکان‌های SDK برای iOS حداقل نسخه SDK
جزئیات مکان (جدید) 9.0.0 جزئیات مکان 3.0.0
عکس مکان (جدید) 9.0.0 عکس مکان 3.0.0
جستجوی متن (جدید) 8.5.0
جستجوی نزدیک (جدید) 9.0.0
تکمیل خودکار (جدید) 9.0.0 تکمیل خودکار 3.0.0
مکان فعلی 3.0.0

ملاحظات برای انتخاب نسخه هایی که باید فعال شوند

  • اگر مشتری جدیدی هستید که به تازگی با Places SDK برای iOS شروع کرده اید، با Places API (جدید) و SDK جدید شروع کنید.
  • اگر مشتری فعلی هستید، می توانید به استفاده از SDK موجود ادامه دهید. با این حال، برای استفاده از بهبود عملکرد و بهبود ویژگی‌های Places SDK برای iOS (جدید)، باید Places API (جدید) را فعال کنید و از SDK جدید استفاده کنید. هنگام انتقال به SDK جدید، نیازی به مهاجرت نیست، فقط مراحل را در انتخاب نسخه SDK و خدمات API خود دنبال کنید.
  • Places API (جدید) برخی از ویژگی‌های موجود مانند Current Place ، GMSPlace.isOpen و GMSPlace.isOpenAtDate را فعال نمی‌کند.

استفاده از Places Swift SDK برای iOS (پیش نمایش)

برای استفاده از Places Swift SDK برای iOS (پیش نمایش) مراحل زیر لازم است:

  1. Places API (جدید) را فعال کنید.
  2. Places Swift SDK برای iOS (پیش نمایش) را به وابستگی های خود اضافه کنید.
  3. کلاینت Places را با PlacesClient راه اندازی کنید.

برای کسب اطلاعات بیشتر درباره Places Swift SDK برای iOS (پیش‌نمایش)، نمای کلی یا راهنمای انتقال را مرور کنید.

به API های جدید مهاجرت کنید

اگر از یک API موجود استفاده می‌کنید و می‌خواهید به 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 است:

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

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

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

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

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

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

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

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

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality
،

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

شماره‌های نسخه SDK

شماره نسخه SDK که در وابستگی‌های بسته خود مشخص می‌کنید تعیین می‌کند که آیا برنامه شما به ویژگی‌هایی که در نسخه خاصی اضافه شده‌اند دسترسی دارد یا خیر. برای مثال، تکمیل خودکار (جدید) فقط در SDK نسخه 9.0.0 یا بالاتر موجود است.

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

نسخه‌های API Places برای Places SDK برای iOS

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

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

برای انتخاب ویژگی‌های SDK در برنامه‌تان، موارد زیر را انجام دهید:

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

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

ویژگی های SDK در هر نسخه موجود است

جدول زیر نشان می دهد که کدام نسخه SDK و API برای هر ویژگی SDK مورد نیاز است:

Places SDK برای iOS (جدید) حداقل نسخه SDK مکان‌های SDK برای iOS حداقل نسخه SDK
جزئیات مکان (جدید) 9.0.0 جزئیات مکان 3.0.0
عکس مکان (جدید) 9.0.0 عکس مکان 3.0.0
جستجوی متن (جدید) 8.5.0
جستجوی نزدیک (جدید) 9.0.0
تکمیل خودکار (جدید) 9.0.0 تکمیل خودکار 3.0.0
مکان فعلی 3.0.0

ملاحظات برای انتخاب نسخه هایی که باید فعال شوند

  • اگر مشتری جدیدی هستید که به تازگی با Places SDK برای iOS شروع کرده اید، با Places API (جدید) و SDK جدید شروع کنید.
  • اگر مشتری فعلی هستید، می توانید به استفاده از SDK موجود ادامه دهید. با این حال، برای استفاده از بهبود عملکرد و بهبود ویژگی‌های Places SDK برای iOS (جدید)، باید Places API (جدید) را فعال کنید و از SDK جدید استفاده کنید. هنگام انتقال به SDK جدید، نیازی به مهاجرت نیست، فقط مراحل را در انتخاب نسخه SDK و خدمات API خود دنبال کنید.
  • Places API (جدید) برخی از ویژگی‌های موجود مانند Current Place ، GMSPlace.isOpen و GMSPlace.isOpenAtDate را فعال نمی‌کند.

استفاده از Places Swift SDK برای iOS (پیش نمایش)

برای استفاده از Places Swift SDK برای iOS (پیش نمایش) مراحل زیر لازم است:

  1. Places API (جدید) را فعال کنید.
  2. Places Swift SDK برای iOS (پیش نمایش) را به وابستگی های خود اضافه کنید.
  3. کلاینت Places را با PlacesClient راه اندازی کنید.

برای کسب اطلاعات بیشتر درباره Places Swift SDK برای iOS (پیش‌نمایش)، نمای کلی یا راهنمای انتقال را مرور کنید.

به API های جدید مهاجرت کنید

اگر از یک API موجود استفاده می‌کنید و می‌خواهید به 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 است:

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

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

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

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

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

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

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

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

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality