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