مهاجرت به جزئیات مکان (جدید)

Places SDK برای Android از جزئیات مکان موجود پشتیبانی می کند. اگر با Places SDK موجود برای Android آشنا هستید، نسخه جدید Place Details تغییرات زیر را اعمال می کند:

  • از مدل قیمت گذاری جدید استفاده می کند. برای اطلاعات قیمت برای همه APIها، Places SDK for Android (جدید) را ببینید.

  • باید با فراخوانی متد Places.initializeWithNewPlacesApiEnabled() برنامه خود را مقداردهی اولیه کنید. برای اطلاعات بیشتر در مورد انتخاب سرویس Places API، به راه اندازی پروژه Google Cloud خود مراجعه کنید.

  • پوشاندن میدان مورد نیاز است. شما باید مشخص کنید که کدام فیلدها را می خواهید در پاسخ بازگردانید. هیچ لیست پیش فرضی از فیلدهای برگشتی وجود ندارد. اگر این لیست را حذف کنید، متدها با خطا مواجه می شوند.

بخش های بعدی تغییرات اضافی را توضیح می دهند.

دسترسی به انواع مکان های جدید

هر مکان می تواند یک یا چند مقدار نوع مرتبط با خود داشته باشد. Places SDK برای اندروید نسخه 3.3.0 و نسخه های جدیدتر مقادیر زیادی از نوع جدید را اضافه می کند. برای فهرست کامل، به انواع مکان های گسترده مراجعه کنید.

متد Place.getPlaceTypes() مقادیر نوع را به عنوان لیستی از مقادیر رشته برمی گرداند. مقادیر برگردانده شده به نسخه Places SDK برای Android شما بستگی دارد:

  • Places SDK برای Android (جدید) : رشته های تعریف شده توسط جدول A و جدول B نشان داده شده در انواع مکان (جدید) را برمی گرداند، از جمله تمام انواع مکان های اضافه شده در نسخه 3.3.0.

  • Places SDK برای Android : فهرست های تعریف شده توسط Place.Types را برمی گرداند که شامل انواع جدید اضافه شده در نسخه 3.3.0 و جدیدتر نمی شود.

به نظرات مکان دسترسی داشته باشید

Places SDK for Android (جدید) کلاس Review را اضافه می کند که شامل بررسی یک مکان است. شیء Place می تواند حداکثر پنج نظر داشته باشد.

کلاس Review همچنین می تواند شامل یک منبع و یک منبع نویسنده باشد. اگر نظر را در برنامه خود نمایش دهید، باید هر گونه انتساب یا منبع نویسنده را نیز نمایش دهید. برای اطلاعات بیشتر، به نمایش مرور مراجعه کنید.

برای اطلاعات بیشتر، به اسناد مربوط به اسناد مراجعه کنید.

به کد زبان نام مکان دسترسی پیدا کنید

متد Place.getName() یک رشته متنی حاوی نام مکان را برمی گرداند. برای پر کردن شی Place با نام مکان، باید Place.Field.DISPLAY_NAME را در لیست فیلد درخواست جزئیات مکان قرار دهید.

شی Place اکنون حاوی کد زبان رشته نام است. برای پر کردن شیء Place با کد زبان، باید:

  1. Place.Field.DISPLAY_NAME را در لیست فیلد درخواست قرار دهید. این مقدار پاسخ را به گونه ای پیکربندی می کند که نام مکان و کد زبان را در شیء Place شامل شود.

  2. PlacesClient.fetchPlace() را فراخوانی کنید. PlacesClient.findCurrentPlace() از فیلد کد زبان پشتیبانی نمی کند.

  3. از متد Place.getNameLanguageCode() برای دسترسی به فیلد کد زبان در شیء Place استفاده کنید.

کد منطقه را تنظیم کنید

Places SDK for Android (جدید) پارامتر درخواست کد منطقه را به جزئیات مکان اضافه می کند. کد منطقه برای قالب بندی پاسخ استفاده می شود که به عنوان مقدار کد CLDR دو کاراکتری مشخص شده است. این پارامتر همچنین می تواند یک اثر سوگیری در نتایج جستجو داشته باشد. هیچ مقدار پیش فرض وجود ندارد. برای تنظیم کد منطقه باید SDK جدید را فعال کنید.

اگر نام کشور فیلد آدرس در پاسخ با کد منطقه مطابقت داشته باشد، کد کشور از آدرس حذف می شود.

اکثر کدهای CLDR با کدهای ISO 3166-1 یکسان هستند، با برخی استثناهای قابل توجه. برای مثال، ccTLD بریتانیا "uk" (.co.uk) است در حالی که کد ISO 3166-1 آن "gb" است (از لحاظ فنی برای نهاد "پادشاهی متحده بریتانیای کبیر و ایرلند شمالی"). این پارامتر می تواند بر نتایج بر اساس قانون قابل اجرا تأثیر بگذارد.

درخواست نمونه

برای مثال کامل، جزئیات مکان (جدید) را ببینید.