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های جدید مهاجرت کنید.
برای اطلاعات بیشتر در مورد مهاجرت، به نمای کلی مهاجرت مراجعه کنید.