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