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