مرجع سریع کیت توسعه نرم‌افزار مکان‌ها، ویژه Android

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

کیت توسعه نرم‌افزار مکان‌ها، ویژه Android: حقایق کلیدی

  • محصول: کیت توسعه نرم‌افزار مکان‌ها، ویژه Android
  • همچنین با این نام شناخته می‌شود: کیت توسعه نرم‌افزار Places برای Android (جدید)
  • دسته: مکان‌ها
  • پلاتفرم: Android
  • اجرا در: کارخواه (کد برنامه یا مرورگر)
  • مرحله راه‌اندازی: GA
  • چرخه حیات: فعال
  • نمای کلی: نمای کلی کیت توسعه نرم‌افزار مکان‌ها، ویژه Android

کیت توسعه نرم‌افزار مکان‌ها، ویژه Android: زمان استفاده از آن

در موارد زیر از «کیت توسعه نرم‌افزار مکان‌ها، ویژه Android» استفاده کنید:

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

در موارد زیر از «کیت توسعه نرم‌افزار مکان‌ها، ویژه Android» استفاده نکنید:

کیت توسعه نرم‌افزار مکان‌ها، ویژه Android: راه‌اندازی

بسته‌های رسمی کیت توسعه نرم‌افزار Places برای Android:

  • maven: com.google.android.libraries.places:places

کیت توسعه نرم‌افزار مکان‌ها، ویژه Android: اشتباهات رایج

  • مشکل: درخواست‌های «جستجوی اطراف» بدون فهرست فیلد (پوشش فیلد) یا با فهرست فیلد خالی، خطا برمی‌گردانند. اصلاح: حداقل یک Place.Field در فهرست فیلد SearchNearbyRequest ارسال کنید. /maps/documentation/places/android-sdk/nearby-search را ببینید.
  • مشکل: «جزئیات جا» (جدید)، «جستجوی اطراف» (جدید)، و «تکمیل خودکار» (جدید) زمانی‌که کلید میانای برنامه‌سازی کاربردی فاقد Places API (جدید) باشد، یا در کیت توسعه نرم‌افزار نسخه 5.x و قدیمی‌تر زمانی‌که برنامه Places.initialize() را فرامی‌خواند، ناموفق است. نسخه ۶.۰.۲ Places.initialize() را حذف کرد، بنابراین کد فراخوانی آن پس‌از ارتقا کامپایل نمی‌شود. اصلاح: Places API (New)‎ را فعال کنید، آن را به میاناهای برنامه‌سازی کاربردی مجاز کلید میانای برنامه‌سازی کاربردی اضافه کنید، و با Places.initializeWithNewPlacesApiEnabled() مقداردهی اولیه کنید. /maps/documentation/places/android-sdk/legacy/migrate-overview را ببینید.
  • مشکل: Place برگردانده‌شده توسط fetchPlace() فاقد PhotoMetadata است (بنابراین چیزی برای حل کردن وجود ندارد) وقتی فهرست فیلد PHOTO_METADATAS را حذف می‌کند. اصلاح: Place.Field.PHOTO_METADATAS را در فهرست فیلدها بگنجانید. چون fetchResolvedPhotoUri() منسوخ شده است، برای نمایش عکس‌ها از مؤلفه «جزئیات جا» در «کیت میانای کاربر جاها» استفاده کنید. /maps/documentation/places/android-sdk/place-photos را ببینید.
  • مشکل: برنامه‌هایی که جزئیات، عکس‌ها، یا مرورهای مکان را بدون ارجاع‌های برگردانده‌شده به طرف سوم و نویسنده نشان می‌دهند خط‌مشی‌ها را نقض می‌کنند. اصلاح: نمایش ارجاع‌های برگردانده‌شده با اشیای Place، PhotoMetadata، و Review. /maps/documentation/places/android-sdk/policies را ببینید.

کیت توسعه نرم‌افزار مکان‌ها، ویژه Android: ویژگی‌های قدیمی و منسوخ‌شده

  • ویژگی‌های «کیت توسعه نرم‌افزار مکان‌ها» برای Android (قدیمی) / Places API (قدیمی) (تکمیل خودکار، مکان فعلی، جزئیات مکان، عکس‌های مکان قدیمی): قدیمی از ۲۰۲۵/۰۳/۰۱. جایگزین: ویژگی‌های «کیت توسعه نرم‌افزار مکان‌ها، ویژه Android» (جدید) که توسط Places API (جدید) پشتیبانی می‌شود و با Places.initializeWithNewPlacesApiEnabled() مقداردهی اولیه شده است. نشانه: از اکتبر ۲۰۲۶، پروژه‌های جدید Cloud نمی‌توانند Places API (Legacy)‎ را فعال کنند (پروژه‌های موجود همچنان پشتیبانی می‌شوند). کیت توسعه نرم‌افزار نسخه ۶.۰.۲ روش‌های قدیمی را که فقط در نسخه ۵.x و نسخه‌های قدیمی‌تر وجود دارند برداشته است. راهنمای انتقال را ببینید.
  • Places.initialize(): از ۲۰۲۶/۰۹/۳۰ از رده خارج شده است. جایگزین: Places.initializeWithNewPlacesApiEnabled(). نشانه: روش از کیت توسعه نرم‌افزار در نسخه ۶.۰.۲ حذف شده است؛ کدی که آن را فراخوانی می‌کند دیگر کامپایل نمی‌شود. راهنمای انتقال را ببینید.
  • PlacesClient.findCurrentPlace() و awaitFindCurrentPlace() (مکان فعلی، قدیمی): از رده خارج شده از ۲۰۲۶/۰۹/۳۰. جایگزین: PlacesClient.searchNearby() (جستجوی اطراف (جدید)). نشانه: کلاس‌های Methods و FindCurrentPlaceRequest/FindCurrentPlaceResponse در نسخه ۶.۰.۲ برداشته شده‌اند. راهنمای انتقال را ببینید.
  • ‫PlacesClient.fetchPhoto() و awaitFetchPhoto(): از ۲۰۲۶/۰۹/۳۰ از رده خارج شده است. جایگزین: مؤلفه «جزئیات جا» در کیت میانای کاربر «جاها» (PlacesClient.fetchResolvedPhotoUri() منسوخ شده است). نشانه: کلاس‌های Methods و FetchPhotoRequest/FetchPhotoResponse در نسخه ۶.۰.۲ برداشته شده‌اند. راهنمای انتقال را ببینید.
  • ابزاره تکمیل خودکار Places API (قدیمی) (Autocomplete، AutocompleteSupportFragment، AutocompleteActivityMode): از ۲۰۲۶/۰۹/۳۰ از رده خارج شده است. جایگزین: ابزاره «تکمیل خودکار جا (جدید)» (PlaceAutocomplete) یا PlacesClient.findAutocompletePredictions(). نشانه: کلاس‌ها از کیت توسعه نرم‌افزار در نسخه ۶.۰.۲ برداشته شده‌اند. راهنمای انتقال را ببینید.
  • کتابخانه سازگاری «مکان‌ها» (com.google.android.libraries.places:places-compat): منسوخ‌شده از ۲۰۲۲/۰۳/۳۱. جایگزین: کیت توسعه نرم‌افزار مکان‌ها، ویژه Android (com.google.android.libraries.places:places). نشانه: در نسخه ۲.۶.۰ متوقف شده است؛ ویژگی‌های جدید یا رفع اشکال ندارد.
  • کلاس AutocompleteFragment: از کار افتاده از ۲۰۲۵-۰۹-۲۵. جایگزین: ابزاره «تکمیل خودکار جا (جدید)» (PlaceAutocomplete). نشانه: کلاس در نسخه ۵.۰.۰ از کیت توسعه نرم‌افزار برداشته شده است (AutocompleteSupportFragment نیز در نسخه ۶.۰.۲ برداشته شده است).

کارهایی که می‌توانید با «کیت توسعه نرم‌افزار مکان‌ها» برای Android انجام دهید

برای هر تکلیف، راهنماهای پیوندشده در زیر را ببینید یا محصولات را در کاوشگر قابلیت‌ها با یکدیگر مقایسه کنید.

کیت توسعه نرم‌افزار مکان‌ها، ویژه Android: هوش مصنوعی زایا

کیت توسعه نرم‌افزار مکان‌ها، ویژه Android: مکان‌ها

کیت توسعه نرم‌افزار مکان‌ها، ویژه Android: کیت میانای کاربر «جاها»

  • سبک CSS را بر عنصر میانای کاربر داده‌های مکان اعمال کنید. توجه: ویژگی‌های سفارشی CSS برای عناصر «کیت میانای کاربر جاها» در Maps JavaScript API اعمال می‌شود؛ «کیت توسعه نرم‌افزار جاها» برای Android و «کیت توسعه نرم‌افزار جاها» برای iOS نماهای «کیت میانای کاربر جاها» را به‌صورت برنامه‌نویسی‌شده بااستفاده از مشخصه‌های طرح‌واره و سبک، سبک‌بندی می‌کنند. الزامات رعایت مقررات منطقه اقتصادی اروپا: برای نمایش داده‌های مکان روی نقشه در منطقه اقتصادی اروپا (EEA)، سرویس‌های وب Places API را از سرور زیرینه فراخوانی نکنید. از مؤلفه‌های «کیت میانای کاربر جاها» سمت کارخواه در پلاتفرم هدف (Maps JavaScript API در وب، Places SDK for Android در Android، یا Places SDK for iOS در iOS) استفاده کنید. پرسشگان و شرایط کامل: https://developers.google.com/maps/comms/eea/faq
  • با ابزار سفارشی‌سازی عنصر میانای کاربر، پیکربندی‌ها و سبک عنصر میانای کاربر داده‌های مکان را سفارشی‌سازی کنید. توجه: الزامات رعایت مقررات منطقه اقتصادی اروپا: برای نمایش داده‌های مکان روی نقشه در منطقه اقتصادی اروپا (EEA)، وب‌سرویس‌های Places API را از سرور زیرینه فراخوانی نکنید. از مؤلفه‌های «کیت میانای کاربر جاها» سمت کارخواه در پلاتفرم هدف (Maps JavaScript API در وب، Places SDK for Android در Android، یا Places SDK for iOS در iOS) استفاده کنید. پرسشگان و شرایط کامل: https://developers.google.com/maps/comms/eea/faq
  • عنصر میانای کاربری را که اطلاعات مربوط به مکان خاصی را نمایش می‌دهد به صفحه وب یا برنامه تلفن همراه اضافه کنید. توجه: الزامات رعایت مقررات منطقه اقتصادی اروپا: برای نشان دادن داده‌های مکان روی نقشه در منطقه اقتصادی اروپا (EEA)، وب‌سرویس‌های Places API را از سرور زیرینه فراخوانی نکنید. از مؤلفه‌های «کیت میانای کاربر جاها» سمت کارخواه در پلاتفرم هدف (Maps JavaScript API در وب، Places SDK for Android در Android، یا Places SDK for iOS در iOS) استفاده کنید. پرسشگان و شرایط کامل: https://developers.google.com/maps/comms/eea/faq
  • عنصر میانای کاربری را که فهرستی از مکان‌ها را براساس رشته پُرسمان نمایش می‌دهد به صفحه وب اضافه کنید. توجه: هم در صفحه‌های وب (میانای برنامه‌سازی کاربردی جاوا اسکریپت Maps) و هم در برنامه‌های تلفن همراه (کیت توسعه نرم‌افزار Places برای Android و کیت توسعه نرم‌افزار Places برای iOS) پشتیبانی می‌شود. الزامات رعایت مقررات منطقه اقتصادی اروپا: برای نمایش داده‌های مکان روی نقشه در منطقه اقتصادی اروپا (EEA)، سرویس‌های وب Places API را از سرور زیرینه فراخوانی نکنید. از مؤلفه‌های «کیت میانای کاربر جاها» سمت کارخواه در پلاتفرم هدف (Maps JavaScript API در وب، Places SDK for Android در Android، یا Places SDK for iOS در iOS) استفاده کنید. پرسشگان و شرایط کامل: https://developers.google.com/maps/comms/eea/faq
  • عنصر میانای کاربری را که فهرستی از مکان‌های نزدیک به یک مکان خاص را نمایش می‌دهد به صفحه وب اضافه کنید. توجه: هم در صفحه‌های وب (میانای برنامه‌سازی کاربردی جاوا اسکریپت Maps) و هم در برنامه‌های تلفن همراه (کیت توسعه نرم‌افزار Places برای Android و کیت توسعه نرم‌افزار Places برای iOS) پشتیبانی می‌شود. الزامات رعایت مقررات منطقه اقتصادی اروپا: برای نمایش داده‌های مکان روی نقشه در منطقه اقتصادی اروپا (EEA)، سرویس‌های وب Places API را از سرور زیرینه فراخوانی نکنید. از مؤلفه‌های «کیت میانای کاربر جاها» سمت کارخواه در پلاتفرم هدف (Maps JavaScript API در وب، Places SDK for Android در Android، یا Places SDK for iOS در iOS) استفاده کنید. پرسشگان و شرایط کامل: https://developers.google.com/maps/comms/eea/faq
  • افزودن عنصر میانای کاربر تکمیل خودکار پایه به صفحه وب یا برنامه‌ای که شناسه‌های «مکان Google» را براساس رشته پُرسمان برمی‌گرداند. توجه: الزامات رعایت مقررات منطقه اقتصادی اروپا: برای نمایش داده‌های مکان روی نقشه در منطقه اقتصادی اروپا (EEA)، وب‌سرویس‌های Places API را از سرور زیرینه فراخوانی نکنید. از مؤلفه‌های «کیت میانای کاربر جاها» سمت کارخواه در پلاتفرم هدف (Maps JavaScript API در وب، Places SDK for Android در Android، یا Places SDK for iOS در iOS) استفاده کنید. پرسشگان و شرایط کامل: https://developers.google.com/maps/comms/eea/faq