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