این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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

Places API از دو نسخه API پشتیبانی می کند: Places API APIهای موجود هستند و Places API (جدید) نسخه نسل بعدی APIها هستند.

با انتشار Places API (جدید)، اولین وظیفه شما این است که تصمیم بگیرید از کدام مجموعه API استفاده کنید. این در صورتی صادق است که شما یک مشتری جدید یا یک مشتری موجود هستید که قبلاً از API ها استفاده می کنید. از این راهنما برای درک تفاوت های کلیدی بین دو API استفاده کنید.

لیست API ها

جدول زیر هر دو مجموعه API را فهرست می کند. اگر مشتری فعلی هستید، از این جدول برای تعیین API جدید استفاده کنید که جایگزین API است که در حال حاضر استفاده می کنید.

Places API	Places API (جدید)	توجه داشته باشید
مکان را پیدا کنید	جستجوی متن (جدید)	نسخه جدیدی از Find Place وجود ندارد. جستجوی متن (جدید) جایگزین آن شده است.
جستجوی نزدیک	جستجوی نزدیک (جدید)	همه درخواست‌هایی که از API موجود استفاده می‌کنند و شامل عبارت جستجوی متنی هستند، باید از جستجوی متن (جدید) استفاده کنند زیرا جستجوی نزدیک (جدید) از ورودی متن پشتیبانی نمی‌کند.
جستجوی متن	جستجوی متن (جدید)
جزئیات مکان	جزئیات مکان (جدید)
عکس مکان	عکس مکان (جدید)
محل تکمیل خودکار	تکمیل خودکار (جدید)
پرس و جو تکمیل خودکار	تکمیل خودکار (جدید)	قابلیت های اضافه شده به تکمیل خودکار (جدید)

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

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

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

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

اگر از یک API موجود استفاده می‌کنید و می‌خواهید به API جدید مهاجرت کنید، به راهنمای انتقال زیر برای هر API مراجعه کنید:

ویژگی های کلیدی اضافه شده به Places API (جدید)

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

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

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

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

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

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

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

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

داده‌های پاسخ منسجم برای یک مکان

با API های موجود، API های جزئیات مکان، جستجوی نزدیک و جستجوی متن داده های پاسخ متفاوتی را برای یک مکان برگرداندند. Places API (جدید) پاسخ را استاندارد می کند، بنابراین همه این APIها داده های یکسانی را برای یک مکان برمی گرداند.

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

پاسخ API اکنون می تواند حاوی نوع اصلی مکان باشد. هر مکان می تواند یک مقدار نوع واحد داشته باشد که به عنوان نوع اصلی مکان مشخص شده است، همانطور که در جدول A فهرست شده است.

علاوه بر این، API جدید انواع مکان های نشان داده شده در جدول زیر را اضافه می کند. می توانید از این انواع جدید و انواع موجود در جستجو با جستجوی نزدیک (جدید) و جستجوی متن (جدید) استفاده کنید. انواع جدید همه در جدول 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 API (جدید) از داده‌های پاسخ پویا، مانند در دسترس بودن ایستگاه شارژ EV یا آخرین قیمت سوخت برای پمپ بنزین پشتیبانی می‌کند. از این فیلدهای پاسخ برای ایجاد تجربیات کاربر پویا استفاده کنید.

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

قبل از اینکه بتوانید توسعه برنامه را شروع کنید، باید API خود را انتخاب کنید:

اگر مشتری جدیدی هستید که به تازگی با Places API شروع کرده اید، با API های جدید شروع کنید.
اگر مشتری جدیدی هستید و هنوز جایگزینی برای یک API موجود، مانند Place Autocomplete یا Query Autocomplete وجود ندارد ، می توانید از ترکیبی از API های جدید و موجود استفاده کنید.
اگر مشتری فعلی هستید، می توانید به استفاده از API های موجود ادامه دهید. با این حال، برای استفاده از بهبود عملکرد و بهبود ویژگی‌های Places API (جدید)، می‌توانید به APIهای جدید مهاجرت کنید.
برای اطلاعات بیشتر در مورد مهاجرت، به نمای کلی مهاجرت مراجعه کنید.