Places API (جدید) عملکرد بهبود یافته و یک مدل قیمت گذاری جدید را ارائه می دهد و به روز رسانی برنامه هایی که از Places API استفاده می کنند ارزشمند است. برای جزئیات بیشتر در مورد مقایسه ویژگی‌ها، به انتخاب API خود مراجعه کنید.
از این راهنما برای درک تفاوت های کلیدی Places API (جدید) در مقایسه با Places 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 است: