چرا باید به Places API (جدید) منتقل شوید؟

Places API (New) درمقایسه با Places API (Legacy) عملکرد بهبودیافته و قابلیت‌های بیشتری ارائه می‌دهد. از این راهنما برای درک تفاوت‌های کلیدی بین دو نسخه Places API و همچنین نحوه مدیریت تغییرات لازم استفاده کنید. برای جزئیات بیشتر درباره سایر ویژگی‌های Places API (جدید)، نمای کلی محصول را ببینید.

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

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

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

Places API (New) در زیرساخت سرویس پیاده‌سازی شده است

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

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

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

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

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

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

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

با میاناهای برنامه‌سازی کاربردی قدیمی، میاناهای برنامه‌سازی کاربردی «جزئیات جا» (قدیمی)، «جستجوی اطراف» (قدیمی)، و «جستجوی نوشتار» (قدیمی) داده‌های پاسخ متفاوتی را برای یک مکان برمی‌گرداندند. Places API (New) پاسخ را استاندارد می‌کند تا این میاناهای برنامه‌سازی کاربردی همگی داده‌های یکسانی را برای یک مکان برگردانند.

انواع مکان گسترش‌یافته

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

‫API جدید همچنین شامل چندین نوع جدید است. می‌توانید از این انواع جدید و انواع موجود در جستجو با «جستجوی اطراف» (جدید) و «جستجوی نوشتار» (جدید) استفاده کنید. همه انواع جدید در جدول A گنجانده شده‌اند.

داده‌های مکان پویا

Places API (New) از داده‌های پاسخ پویا، مثل دردسترس بودن ایستگاه شارژ خودرو برقی یا جدیدترین قیمت‌های سوخت برای پمپ بنزین، پشتیبانی می‌کند. از این فیلدهای پاسخ برای ایجاد تجربه‌های کاربری پویا استفاده کنید.