مقدمه
«میانای برنامه‌سازی کاربردی مکان‌ها» به شما امکان می‌دهد بااستفاده از رشته نوشتاری یا براساس مجاورت، انواع مختلف مکان را جستجو کنید و اطلاعات آن‌ها را بازیابی کنید. Places API (قدیمی) نسخه قدیمی Places API (جدید) است.
جدول زیر نسخه‌های متناظر هر دو میانای برنامه‌سازی کاربردی را فهرست می‌کند. از این راهنما برای درک تفاوت‌های کلیدی بین این دو و انتقال به Places API (جدید) استفاده کنید.
| Places API (قدیمی) | Places API (جدید) | یادداشت‌ها |
|---|---|---|
| یافتن مکان (قدیمی) | جستجوی نوشتاری (جدید) | نسخه جدیدی از «یافتن مکان» (قدیمی) وجود ندارد. «جستجوی نوشتاری» (جدید) جایگزین آن شده است. |
| جستجوی اطراف (قدیمی) | جستجوی اطراف (جدید) | همه درخواست‌هایی که از «میانای برنامه‌سازی کاربردی» قدیمی استفاده می‌کنند و شامل پُرسمان نوشتاری هستند باید از جستجوی نوشتاری (جدید) استفاده کنند زیرا «جستجوی اطراف» (جدید) از ورودی نوشتاری پشتیبانی نمی‌کند. |
| جستجوی نوشتاری (قدیمی) | جستجوی نوشتاری (جدید) | |
| جزئیات مکان (قدیمی) | جزئیات جا (جدید) | |
| Place Photos (قدیمی) | Place Photos (New) | |
| تکمیل خودکار جا (قدیمی) | تکمیل خودکار (جدید) | |
| تکمیل خودکار پُرسمان (قدیمی) | تکمیل خودکار (جدید) | قابلیت‌هایی به «تکمیل خودکار (جدید)» اضافه شد. |
انتقال به میاناهای برنامه‌سازی کاربردی جدید
برای انتقال به میانای برنامه‌سازی کاربردی جدید، راهنماهای انتقال زیر را ببینید:
- انتقال به «جستجوی اطراف» (جدید)
- انتقال به «جستجوی نوشتاری» (جدید)
- انتقال به «جزئیات مکان» (جدید)
- انتقال به «عکس‌های مکان» (جدید)
- انتقال به «تکمیل خودکار» (جدید)
ویژگی‌های کلیدی به «میانای برنامه‌سازی کاربردی مکان‌ها» (جدید) اضافه شد
این بخش ویژگی‌های کلیدی اضافه‌شده به «میانای برنامه‌سازی کاربردی مکان‌ها (جدید)» را پوشش می‌دهد.
در پلاتفرم استاندارد Google Cloud پیاده‌سازی شده است
Places API (جدید) در زیرساخت سرویس در Google Cloud پیاده‌سازی شده است. این پیاده‌سازی پلاتفرمی امن‌تر و مورداعتمادتر با گزینه‌های امنیتی بهبودیافته مثل OAuth را به‌همراه دارد. این طراحی استاندارد «میانای برنامه‌سازی کاربردی» سطحی از یکپارچگی را در سراسر «میاناهای برنامه‌سازی کاربردی» ایجاد می‌کند که کارایی توسعه با Places API (جدید) را بهبود می‌بخشد.
عملکرد بهبودیافته
«میانای برنامه‌سازی کاربردی مکان‌ها» (جدید) عملکرد بهبودیافته‌ای ارائه می‌دهد و جایگزین کردن برنامه‌هایی که از «میانای برنامه‌سازی کاربردی مکان‌ها» کنونی استفاده می‌کنند را ارزشمند می‌کند.
قیمت‌گذاری ساده
قیمت‌گذاری با Places API (جدید) ساده شده است تا فقط برای داده‌هایی که استفاده می‌کنید هزینه بپردازید. قیمت‌گذاری ساده بااستفاده از پوشش فیلد پیاده‌سازی می‌شود.
با «جزئیات مکان» (جدید)، «جستجوی اطراف» (جدید)، و «جستجوی نوشتاری» (جدید)، از پوشش فیلد برای کنترل فهرست فیلدهایی که در پاسخ برگردانده می‌شود استفاده می‌کنید. سپس فقط هزینه داده‌های درخواست‌شده از شما کسر می‌شود. استفاده از پوشش فیلد یک روش طراحی خوب برای اطمینان از این است که داده‌های غیرضروری درخواست نمی‌کنید، که به جلوگیری از زمان پردازش غیرضروری و هزینه‌های صورت‌حساب کمک می‌کند.
داده‌های پاسخ یکپارچه برای مکان
با «میاناهای برنامه‌سازی کاربردی قدیمی»، میاناهای برنامه‌سازی کاربردی «جزئیات مکان (قدیمی)»، «جستجوی اطراف (قدیمی)»، و «جستجوی نوشتاری (قدیمی)» داده‌های پاسخ متفاوتی برای مکان برمی‌گرداندند. Places API (New) پاسخ را استاندارد می‌کند تا این میاناهای برنامه‌سازی کاربردی همگی داده‌های یکسانی را برای مکان برگردانند.
انواع مکان گسترش‌یافته
پاسخ «میانای برنامه‌سازی کاربردی» اکنون می‌تواند حاوی نوع اصلی مکان باشد. هر مکان می‌تواند یک مقدار نوع داشته باشد که به‌عنوان نوع اصلی مکان مشخص می‌شود، همان‌طور که در جدول A فهرست شده است.
میانای برنامه کاربردی جدید همچنین شامل چندین نوع جدید است. می‌توانید از این انواع جدید و انواع موجود در جستجو با «جستجوی اطراف» (جدید) و «جستجوی نوشتاری» (جدید) استفاده کنید. انواع جدید در جدول A گنجانده شده است.
داده‌های مکان پویا
«میانای برنامه‌سازی کاربردی مکان‌ها» (جدید) از داده‌های پاسخ پویا، مثل دردسترس بودن ایستگاه شارژ خودرو برقی یا جدیدترین قیمت سوخت در پمپ بنزین، پشتیبانی می‌کند. از این فیلدهای پاسخ برای ایجاد تجربه‌های کاربری پویا استفاده کنید.