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 گنجانده شده است.
| تایپ کنید | |||
|---|---|---|---|
| رستوران_آمریکایی | تخفیف_فروشگاه | بستنی فروشی | ساندویچ_فروشی |
| مرکز_تفریح | سگ_پارک | رستوران هندی | محدوده مدرسه |
| رشته_ ورزشی | ایستگاه_شارژ_خودرو_برقی | اندونزی_رستوران | رستوران غذاهای دریایی |
| فروشگاه_قطعات_خودرو | رویداد_محل برگزاری | رستوران ایتالیایی | پیست اسکی |
| سالن های ضیافت | طولانی_ اقامت_هتل | رستوران ژاپنی | رستوران_اسپانیایی |
| باربیکیو_رستوران | مزرعه | رستوران_کوری | فروشگاه_کالاهای_ورزشی |
| آرایشگاه | مزرعه | رستوران_لبنانی | باشگاه ورزشی |
| تخت_و_صبحانه | رستوران فست فود | مارینا | مجموعه ورزشی |
| رستوران_برزیلی | ترمینال کشتی | بازار | استیک_خانه |
| صبحانه_رستوران | مرکز تناسب اندام | آزمایشگاه_پزشکی | سوشی_رستوران |
| برانچ_رستوران | رستوران فرانسوی | مدیترانه_رستوران | استخر |
| ایستگاه اتوبوس | هدیه_فروشی | رستوران مکزیکی | خیاط |
| کمپینگ_کابین | زمین_گلف | رستوران_خاورمیانه | ارائه دهنده خدمات_ مخابراتی |
| فروشگاه_موبایل | یونانی_رستوران | متل | تای_رستوران |
| آژانس_مراقبت_کودک | فروشگاه بقالی | پارک ملی | transit_depot |
| رستوران چینی | مهمان خانه | پارک_و_سواری | کامیون_ایست |
| کافی شاپ | سالن آرایش | تئاتر_هنرهای_نمایش | رستوران_تورکی |
| مرکز ارتباطات | همبرگر_رستوران | پیتزا_رستوران | رستوران_وگان |
| مشاور | هلی فرودگاه | زمین بازی | رستوران_گیاهی |
| مرکز کنوانسیون | منطقه پیاده روی | پیش دبستانی | رستوران_ویتنامی |
| کلبه | نشانه_ تاریخی | اتاق_مهمان_خصوصی | بازدید کننده_مرکز |
| پیک_خدمات | خانه_بهبود_فروشگاه | رامن_رستوران | محل برگزاری عروسی |
| مرکز فرهنگی | خوابگاه | 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های جدید مهاجرت کنید.
برای اطلاعات بیشتر در مورد مهاجرت، به نمای کلی مهاجرت مراجعه کنید.