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