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

می‌توانید با استفاده از شناسه مکان آن و درخواست جزئیات مکان (جدید) جزئیات بیشتری درباره یک مؤسسه یا نقطه مورد علاقه خاص درخواست کنید. جزئیات مکان (جدید) اطلاعات جامع تری را در مورد مکان مشخص شده، مانند آدرس کامل، شماره تلفن، رتبه بندی کاربر و نظرات، برمی گرداند.

راه های زیادی برای دریافت شناسه مکان وجود دارد. می توانید استفاده کنید:

• جستجوی متن (جدید)
• جستجوی نزدیک (جدید)
• تکمیل خودکار (جدید)

درخواست جزئیات مکان (جدید).

می‌توانید جزئیات مکان را با فراخوانی PlacesClient.fetchPlace() و ارسال یک شی FetchPlaceRequest حاوی شناسه مکان و لیست فیلد و همچنین هر پارامتر اختیاری درخواست کنید:

// Define a place ID.
final String placeId = "INSERT_PLACE_ID_HERE";

// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList("INSERT_PLACE_FIELDS_HERE");

// Construct a request object, passing the place ID and field list.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);

// Pass the request object and make the request
Task<FetchPlaceResponse> placeTask = placesClient.fetchPlace(request);

جزئیات مکان (جدید) پاسخ ها

جزئیات مکان (جدید) داده‌ها را به شکل یک شی Place برمی‌گرداند که فقط شامل فیلدهایی است که با استفاده از فهرست فیلد درخواست کرده‌اید. نتایج داده‌های مکان نمی‌توانند خالی باشند، بنابراین فقط نتایج مکان با داده برگردانده می‌شوند (به عنوان مثال، اگر مکان درخواستی عکسی نداشته باشد، قسمت عکس‌ها در نتیجه وجود نخواهد داشت).

برای دسترسی به فیلدهای داده، روش مربوطه را فراخوانی کنید. به عنوان مثال، برای دسترسی به نام مکان، getName() را فراخوانی کنید.

پارامترهای مورد نیاز

پارامترهای مورد نیاز برای FetchPlaceRequest عبارتند از:

• شناسه مکان

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

• لیست زمینه

  هنگامی که درخواست مکانی می کنید، باید مشخص کنید که کدام داده مکان را برگردانید. برای انجام این کار، لیستی از مقادیر Place.Field را ارسال کنید که داده‌های مورد نظر را مشخص می‌کند. هیچ لیست پیش فرضی از فیلدهای برگشتی در پاسخ وجود ندارد.

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

  یک یا چند مورد از فیلدهای زیر را مشخص کنید:

  • فیلدهای زیر SKU فقط شناسه‌های ضروری جزئیات مکان را فعال می‌کنند:

    Place.Field.ID
Place.Field.PHOTO_METADATAS
Place.Field.RESOURCE_NAME
    

  • فیلدهای زیر SKU جزئیات مکان را فعال می کنند:

    Place.Field.ADDRESS_COMPONENTS
ADR_FORMAT_ADDRESS
Place.Field.FORMATTED_ADDRESS *
    * به جای Place.Field.ADDRESS استفاده کنید (منسوخ شده است).
    Place.Field.LOCATION *
    * به جای Place.Field.LAT_LNG (منسوخ شده) استفاده کنید.
    Place.Field.PLUS_CODE
Place.Field.SHORT_FORMATTED_ADDRESS
Place.Field.TYPES
Place.Field.VIEWPORT

  • فیلدهای زیر Place Details Pro SKU را فعال می کنند:

    Place.Field.ACCESSIBILITY_OPTIONS *
    * به جای Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE (منسوخ شده) استفاده کنید.
    Place.Field.BUSINESS_STATUS
Place.Field.DISPLAY_NAME *
    * به جای Place.Field.NAME استفاده کنید که منسوخ شده است.
    Place.Field.GOOGLE_MAPS_URI
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL *
    * به جای Place.Field.ICON_URL استفاده کنید (منسوخ شده).
    Place.Field.PRIMARY_TYPE
Place.Field.PRIMARY_TYPE_DISPLAY_NAME
Place.Field.SUB_DESTINATIONS
Place.Field.UTC_OFFSET

  • فیلدهای زیر SKU شرکت جزئیات مکان را فعال می کنند:

    Place.Field.CURRENT_OPENING_HOURS
Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER *
    * به جای Place.Field.PHONE_NUMBER استفاده کنید که منسوخ شده است.
    Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.OPENING_HOURS
Place.Field.PRICE_LEVEL
Place.Field.RATING
Place.Field.SECONDARY_OPENING_HOURS
Place.Field.USER_RATING_COUNT *
    * به جای Place.Field.USER_RATINGS_TOTAL استفاده کنید که منسوخ شده است.
    Place.Field.WEBSITE_URI

  • فیلدهای زیر SKU Place Details Enterprise Plus را فعال می کنند:

    Place.Field.ALLOWS_DOGS
Place.Field.CURBSIDE_PICKUP
Place.Field.DELIVERY
Place.Field.DINE_IN
Place.Field.EDITORIAL_SUMMARY
Place.Field.EV_CHARGE_OPTIONS
Place.Field.FUEL_OPTIONS
Place.Field.GOOD_FOR_CHILDREN
Place.Field.GOOD_FOR_GROUPS
Place.Field.GOOD_FOR_WATCHING_SPORTS
Place.Field.LIVE_MUSIC
Place.Field.MENU_FOR_CHILDREN
Place.Field.OUTDOOR_SEATING
Place.Field.PARKING_OPTIONS
Place.Field.PAYMENT_OPTIONS
Place.Field.RESERVABLE
Place.Field.RESTROOM
Place.Field.REVIEWS
Place.Field.SERVES_BEER
Place.Field.SERVES_BREAKFAST
Place.Field.SERVES_BRUNCH
Place.Field.SERVES_COCKTAILS
Place.Field.SERVES_COFFEE
Place.Field.SERVES_DESSERT
Place.Field.SERVES_DINNER
Place.Field.SERVES_LUNCH
Place.Field.SERVES_VEGETARIAN_FOOD
Place.Field.SERVES_WINE
Place.Field.TAKEOUT

پارامترهای اختیاری

پارامترهای اختیاری برای FetchPlaceRequest عبارتند از:

• کد منطقه

  کد منطقه ای که برای قالب بندی پاسخ استفاده می شود، به عنوان مقدار کد CLDR دو کاراکتری مشخص شده است. هیچ مقدار پیش فرض وجود ندارد.

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

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

  برای تنظیم پارامتر کد منطقه، هنگام ساخت شی FetchPlaceRequest ، متد setRegionCode() را فراخوانی کنید.

• نشانه جلسه

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

  برای تنظیم پارامتر Session Token، هنگام ساخت شی FetchPlaceRequest ، متد setSessionToken() را فراخوانی کنید.

نمونه جزئیات مکان

مثال زیر فیلدهای ID ، DISPLAY_NAME و FORMATTED_ADDRESS را برای ساختمان Empire State در شهر نیویورک درخواست می‌کند.

// Define a place ID.
final String placeId = "ChIJaXQRs6lZwokRY6EFpJnhNNE";

// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.DISPLAY_NAME, Place.Field.FORMATTED_ADDRESS);

// Construct a request object, passing the place ID and field list.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);

// Pass the request object and make the request
Task<FetchPlaceResponse> placeTask = placesClient.fetchPlace(request);