مقدمه
Places API به شما امکان می‌دهد بااستفاده از رشته نوشتاری یا براساس مجاورت، اطلاعات مربوط به انواع مختلف مکان‌ها را جستجو و بازیابی کنید. Places API (Legacy) نسخه قدیمی Places API (New) است.
جدول زیر نسخه‌های متناظر هر دو میانای برنامه‌سازی کاربردی را فهرست می‌کند. از این راهنما برای درک تفاوت‌های کلیدی بین این دو و انتقال به Places API (جدید) استفاده کنید.
| Places API (قدیمی) | Places API (جدید) | یادداشت‌ها |
|---|---|---|
| پیدا کردن جا (قدیمی) | جستجوی نوشتار (جدید) | نسخه جدیدی از Find Place (Legacy) وجود ندارد. «جستجوی نوشتار (جدید)» جایگزین آن شده است. |
| جستجوی اطراف (قدیمی) | جستجوی اطراف (جدید) | همه درخواست‌هایی که از میانای برنامه‌سازی کاربردی قدیمی استفاده می‌کنند و شامل پُرسمان نوشتاری هستند باید از جستجوی نوشتار (جدید) استفاده کنند زیرا «جستجوی اطراف» (جدید) از ورودی نوشتاری پشتیبانی نمی‌کند. |
| جستجوی نوشتار (قدیمی) | جستجوی نوشتار (جدید) | |
| جزئیات جا (قدیمی) | جزئیات جا (جدید) | |
| Place Photos (Legacy) | Place Photos (New) | |
| تکمیل خودکار جا (قدیمی) | تکمیل خودکار (جدید) | |
| تکمیل خودکار پُرسمان (قدیمی) | تکمیل خودکار (جدید) | قابلیت‌هایی به «تکمیل خودکار» (جدید) اضافه شده است. |
انتقال به میاناهای برنامه‌سازی کاربردی جدید
برای انتقال به میاناهای برنامه‌سازی کاربردی جدید، راهنماهای انتقال زیر را ببینید:
- انتقال به «جستجوی اطراف» (جدید)
- انتقال به «جستجوی نوشتار» (جدید)
- انتقال به «جزئیات مکان» (جدید)
- انتقال به «عکس‌های مکان» (جدید)
- انتقال به «تکمیل خودکار» (جدید)
ویژگی‌های کلیدی اضافه‌شده به 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) از داده‌های پاسخ پویا، مثل دردسترس بودن ایستگاه شارژ خودرو برقی یا جدیدترین قیمت‌های سوخت برای پمپ بنزین، پشتیبانی می‌کند. از این فیلدهای پاسخ برای ایجاد تجربه‌های کاربری پویا استفاده کنید.