از این راهنما برای درک تفاوتهای کلیدی بین نسخههای Places SDK و مهاجرت به Places SDK برای اندروید (جدید) استفاده کنید.
ویژگیهای SDK موجود در هر نسخه
جدول زیر نسخههای SDK و API مورد نیاز برای هر ویژگی SDK را نشان میدهد:
| ویژگی | نسخه API مکانها | روش مقداردهی اولیه | حداقل نسخه SDK |
|---|---|---|---|
| تکمیل خودکار (جدید) | API مکانها (جدید) | initializeWithNewPlacesApiEnabled() | ۳.۵.۰ |
| جزئیات مکان (جدید) | API مکانها (جدید) | initializeWithNewPlacesApiEnabled() | ۳.۳.۰ |
| جستجوی نزدیک (جدید) | API مکانها (جدید) | initializeWithNewPlacesApiEnabled() | ۳.۵.۰ |
| عکسهای مکان (جدید) | API مکانها (جدید) | initializeWithNewPlacesApiEnabled() | ۳.۴.۰ |
| جستجوی متن (جدید) | API مکانها (جدید) | initializeWithNewPlacesApiEnabled() | ۳.۳.۰ |
| تکمیل خودکار را قرار دهید | API مکانها (قدیمی) | initialize() (منسوخ شده) | |
| مکان فعلی | API مکانها (قدیمی) | initialize() (منسوخ شده) | |
| جزئیات مکان | API مکانها (قدیمی) | initialize() (منسوخ شده) | |
| عکسهای مکان | API مکانها (قدیمی) | initialize() (منسوخ شده) |
مهاجرت به API های جدید
برای مهاجرت به API های جدید، به راهنماهای مهاجرت زیر مراجعه کنید:
پیشرفتها در Places SDK برای اندروید (جدید)
این بخش ویژگیهای کلیدی اضافه شده به Places SDK برای اندروید (جدید) را پوشش میدهد.
پیادهسازی شده بر روی پلتفرم استاندارد گوگل کلود
کیت توسعه نرمافزار Places برای اندروید (جدید) بر روی زیرساخت سرویس در Google Cloud پیادهسازی شده است. این پیادهسازی، پلتفرمی امنتر و قابل اعتمادتر را به ارمغان میآورد. این طراحی استاندارد، سطحی از سازگاری را در بین کیتهای توسعه نرمافزار (SDK) ایجاد میکند که کارایی توسعه با کیت توسعه نرمافزار Places برای اندروید (جدید) را بهبود میبخشد.
عملکرد بهبود یافته
کیت توسعه نرمافزار Places برای اندروید (جدید) عملکرد بهبود یافتهای را ارائه میدهد و جایگزینی برنامههایی که از کیت توسعه نرمافزار موجود استفاده میکنند را ارزشمند میکند.
ویژگیهای جدید
کیت توسعه نرمافزار Places برای اندروید (جدید) شامل آخرین نسخههای تمام ویژگیهای کیت توسعه نرمافزار است:
جستجوی متن (جدید)
جستجوی متن (جدید) اطلاعاتی درباره مجموعهای از مکانها بر اساس یک رشته برمیگرداند - برای مثال «پیتزا در نیویورک» یا «کفشفروشیهای نزدیک اتاوا» یا «خیابان اصلی ۱۲۳». این سرویس با فهرستی از مکانهایی که با رشته متن مطابقت دارند و هرگونه سوگیری مکانی که تنظیم شده است، پاسخ میدهد.
دادههای پاسخ جدید به جزئیات مکان (جدید) و عکسهای مکان (جدید) اضافه شد
جزئیات مکان (جدید) اکنون شامل کلاس جدید Review در شیء
Placeپاسخ است. کلاس Place شامل متد جدیدgetReviews()برای پشتیبانی از این فیلد است. برای بازگرداندن حداکثر پنج نقد برای یک مکانgetReviews()را فراخوانی کنید.Place Photos (جدید) کلاس
AuthorAttributionsرا به کلاسPhotoMetadataاضافه میکند.AuthorAttributionsشاملListاز اشیاءAuthorAttributionاست.
پاسخ جدید URI به عکسهای مکان اضافه شد (جدید)
اکنون میتوانید از Place Photos (جدید) برای برگرداندن یک URI به یک تصویر بیتمپ استفاده کنید. قبلاً فقط میتوانستید خود تصویر بیتمپ را برگردانید.
قیمتگذاری سادهشده
قیمتگذاری با Places SDK برای اندروید (جدید) ساده شده است، به طوری که شما فقط برای دادههایی که استفاده میکنید هزینه پرداخت میکنید. قیمتگذاری سادهشده با استفاده از لیستهای فیلد، که به آنها ماسکهای فیلد نیز گفته میشود، پیادهسازی شده است.
با استفاده از Place Details (جدید) و Text Search (جدید)، شما از لیست فیلدها برای کنترل لیست فیلدهایی که باید در پاسخ برگردانده شوند استفاده میکنید. سپس فقط برای دادههای درخواستی هزینه دریافت میکنید. استفاده از لیست فیلدها یک روش طراحی خوب برای اطمینان از عدم درخواست دادههای غیرضروری است که به جلوگیری از زمان پردازش غیرضروری و هزینههای صورتحساب کمک میکند.
برای اطلاعات بیشتر در مورد قیمتگذاری، به بخش «استفاده و صورتحساب» مراجعه کنید.
انواع مکانهای گسترشیافته
SDK جدید شامل انواع مکان جدیدی است که به عنوان بخشی از پاسخهای Place Details (New) و Text Search (New) بازگردانده میشوند. همچنین میتوانید از این انواع جدید و انواع موجود در جستجوی Text Search (New) استفاده کنید. انواع جدید در جدول A گنجانده شدهاند.