کیت توسعه نرمافزار Places به شما امکان میدهد اطلاعات مربوط به انواع مختلف مکانها را با استفاده از یک رشته متنی یا بر اساس نزدیکی آنها جستجو و بازیابی کنید. کیت توسعه نرمافزار Places نسخه قدیمی کیت توسعه نرمافزار Places (جدید) است.
از این راهنما برای درک تفاوتهای کلیدی بین نسخههای Places SDK و مهاجرت به Places SDK (جدید) استفاده کنید.
ویژگیهای SDK موجود در هر نسخه
جدول زیر نسخههای SDK و API مورد نیاز برای هر ویژگی SDK را نشان میدهد:
| ویژگی | API را روی کلید 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 Photo (جدید) کلاس
AuthorAttributionsرا به کلاسPhotoMetadataاضافه میکند.AuthorAttributionsشاملListاز اشیاءAuthorAttributionاست.
پاسخ جدید URI به عکسهای مکان اضافه شد (جدید)
اکنون میتوانید از Place Photo (جدید) برای برگرداندن یک URI به یک تصویر بیتمپ استفاده کنید. قبلاً فقط میتوانستید خود تصویر بیتمپ را برگردانید.
قیمتگذاری سادهشده
قیمتگذاری با Places SDK برای اندروید (جدید) ساده شده است، به طوری که شما فقط برای دادههایی که استفاده میکنید هزینه پرداخت میکنید. قیمتگذاری سادهشده با استفاده از لیستهای فیلد، که به آنها ماسکهای فیلد نیز گفته میشود، پیادهسازی شده است.
با استفاده از «جزئیات مکان» و «جستجوی متن»، شما از فهرست فیلدها برای کنترل فهرست فیلدهایی که باید در پاسخ برگردانده شوند، استفاده میکنید. سپس فقط برای دادههای درخواستی، هزینه دریافت میکنید. استفاده از فهرست فیلدها یک روش طراحی خوب برای اطمینان از عدم درخواست دادههای غیرضروری است که به جلوگیری از زمان پردازش غیرضروری و هزینههای صدور صورتحساب کمک میکند.
برای اطلاعات دقیق قیمتگذاری برای هر دو SDK، به بخش «استفاده و صورتحساب» مراجعه کنید.
انواع مکانهای گسترشیافته
SDK جدید شامل انواع مکان جدیدی است که به عنوان بخشی از پاسخ Place Details و Text Search بازگردانده میشوند. همچنین میتوانید از این انواع جدید و انواع موجود در جستجوی Text Search استفاده کنید. انواع جدید در جدول A گنجانده شدهاند.