نمای کلی کیت توسعه نرم‌افزار مکان‌ها برای Android (قدیمی)

این محصول در وضعیت قدیمی است. از اکتبر ۲۰۲۶، Places API (قدیمی) دیگر نمی‌تواند برای پروژه‌های جدید Google Cloud فعال شود. پروژه‌های موجود همچنان کاملاً پشتیبانی می‌شوند. برای ویژگی‌های جدید و عملکرد بهبودیافته، به Places API (جدید) نقل مکان کنید.

از این راهنما برای درک تفاوت‌های کلیدی بین نسخه‌های Places SDK و انتقال به Places SDK برای Android (جدید) استفاده کنید.

ویژگی‌های کیت توسعه نرم‌افزار دردسترس در هر نسخه

جدول زیر نشان می‌دهد که کدام نسخه‌های کیت توسعه نرم‌افزار و میانای برنامه‌سازی کاربردی برای هر ویژگی کیت توسعه نرم‌افزار لازم است:

ویژگی	نسخه Places API	روش راه‌اندازی	حداقل نسخه SDK
تکمیل خودکار (جدید)	Places API (جدید)	initializeWithNewPlacesApiEnabled()	3.5.0
جزئیات جا (جدید)	Places API (جدید)	initializeWithNewPlacesApiEnabled()	3.3.0
جستجوی اطراف (جدید)	Places API (جدید)	initializeWithNewPlacesApiEnabled()	3.5.0
Place Photos (New)	Places API (جدید)	initializeWithNewPlacesApiEnabled()	3.4.0
جستجوی نوشتار (جدید)	Places API (جدید)	initializeWithNewPlacesApiEnabled()	3.3.0
تکمیل خودکار جا	Places API (قدیمی)	initialize() (منسوخ‌شده)
مکان فعلی	Places API (قدیمی)	initialize() (منسوخ‌شده)
جزئیات جا	Places API (قدیمی)	initialize() (منسوخ‌شده)
عکس‌های مکان	Places API (قدیمی)	initialize() (منسوخ‌شده)

منسوخ‌شده: روش Places.initialize منسوخ شده است. درعوض از Places.initializeWithNewPlacesApiEnabled() استفاده کنید. توجه داشته باشید که برای استفاده از Places.initializeWithNewPlacesApiEnabled()، باید Places API (جدید) را در کلید میانای برنامه‌سازی کاربردی خود در کنسول Google Cloud فعال کنید.

انتقال به میاناهای برنامه‌سازی کاربردی جدید

برای انتقال به میاناهای برنامه‌سازی کاربردی جدید، راهنماهای انتقال زیر را ببینید:

• انتقال به «جزئیات مکان» (جدید)
• انتقال به «عکس‌های مکان» (جدید)
• انتقال به «تکمیل خودکار» (جدید)

بهبودهای کیت توسعه نرم‌افزار Places برای Android (جدید)

این بخش ویژگی‌های کلیدی اضافه‌شده به «کیت توسعه نرم‌افزار مکان‌ها» برای Android (جدید) را پوشش می‌دهد.

پیاده‌سازی‌شده در پلاتفرم استاندارد Google Cloud

«کیت توسعه نرم‌افزار مکان‌ها، ویژه Android» (جدید) در زیرساخت سرویس در Google Cloud پیاده‌سازی شده است. این پیاده‌سازی پلاتفرمی ایمن‌تر و قابل‌اعتمادتر را به‌ارمغان می‌آورد. این طراحی استاندارد سطحی از سازگاری را در کیت‌های توسعه نرم‌افزار ایجاد می‌کند که کارایی توسعه با «کیت توسعه نرم‌افزار مکان‌ها، ویژه Android» (جدید) را بهبود می‌بخشد.

عملکرد بهبودیافته

«کیت توسعه نرم‌افزار مکان‌ها، ویژه Android» (جدید) عملکرد بهبودیافته‌ای ارائه می‌دهد که ارزش جایگزینی برنامه‌هایی را که از کیت توسعه نرم‌افزار موجود استفاده می‌کنند دارد.

ویژگی‌های جدید

«کیت توسعه نرم‌افزار مکان‌ها، ویژه Android» (جدید) شامل جدیدترین نسخه‌های همه ویژگی‌های کیت توسعه نرم‌افزار است:

• تکمیل خودکار (جدید)
• جزئیات جا (جدید)
• جستجوی اطراف (جدید)
• Place Photos (New)
• جستجوی نوشتار (جدید)

جستجوی نوشتار (جدید)

جستجوی نوشتار (جدید) اطلاعاتی درباره مجموعه‌ای از مکان‌ها براساس یک رشته برمی‌گرداند — برای مثال «پیتزا در نیویورک» یا «کفش‌فروشی‌های نزدیک اتاوا» یا «خیابان اصلی ۱۲۳». سرویس با فهرستی از مکان‌های منطبق با رشته نوشتاری و هرگونه سوگیری مکانی که تنظیم شده است پاسخ می‌دهد.

داده‌های پاسخ جدید به «جزئیات مکان» (جدید) و «عکس‌های مکان» (جدید) اضافه شد

• جزئیات مکان (جدید) اکنون شامل کلاس جدید مرور در شیء پاسخ Place است. کلاس مکان حاوی روش جدید getReviews() برای پشتیبانی از این فیلد است. getReviews() را فراخوانی کنید تا حداکثر پنج مرور برای یک مکان برگردانده شود.

• عکس‌های مکان (جدید) AuthorAttributions را به کلاس PhotoMetadata اضافه می‌کند. AuthorAttributions حاوی List از AuthorAttribution شیء است.

پاسخ URI جدیدی به «عکس‌های مکان» (جدید) اضافه شد

اکنون می‌توانید از Place Photos (New) برای برگرداندن URI به نقشه بیتی تصویر استفاده کنید. پیش‌ازاین، فقط می‌توانستید خود نقشه بیتی تصویر را برگردانید.

قیمت‌گذاری ساده‌شده

قیمت‌گذاری با «کیت توسعه نرم‌افزار مکان‌ها، ویژه Android» (جدید) ساده شده است تا فقط برای داده‌هایی که استفاده می‌کنید هزینه پرداخت کنید. قیمت‌گذاری ساده‌شده بااستفاده از فهرست‌های فیلد پیاده‌سازی می‌شود، که به آن ماسک فیلد نیز می‌گویند.

با «جزئیات جا» (جدید) و «جستجوی نوشتار» (جدید)، از فهرست‌های فیلد برای کنترل فهرست فیلدهایی که باید در پاسخ برگردانده شوند استفاده می‌کنید. سپس فقط برای داده‌های درخواست‌شده صورت‌حساب دریافت می‌کنید. استفاده از فهرست فیلدها روش طراحی خوبی است تا مطمئن شوید داده‌های غیرضروری درخواست نمی‌کنید، که این کار به جلوگیری از زمان پردازش غیرضروری و هزینه‌های صورت‌حساب کمک می‌کند.

برای اطلاعات بیشتر درباره قیمت‌گذاری، به استفاده و صدور صورت‌حساب مراجعه کنید.

انواع مکان گسترش‌یافته

کیت توسعه نرم‌افزار جدید شامل انواع مکان جدید است که به‌عنوان بخشی از پاسخ «جزئیات مکان» (جدید) و «جستجوی نوشتار» (جدید) برگردانده می‌شود. همچنین می‌توانید از این انواع جدید و انواع موجود در جستجو با «جستجوی نوشتار (جدید)» استفاده کنید. انواع جدید در جدول A گنجانده شده است.