جزئیات جا (جدید)

پلاتفرم را انتخاب کنید: Android iOS JavaScript سرویس وب

توسعه‌دهندگان منطقه اقتصادی اروپا (EEA)

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

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

درخواست‌های «جزئیات جا (جدید)»

می‌توانید جزئیات مکان را با فراخوانی 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 را ارسال کنید که داده‌های موردنظر برای برگرداندن را مشخص می‌کند. هیچ فهرست پیش‌فرضی از فیلدهای برگردانده‌شده در پاسخ وجود ندارد.

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

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

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

      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

      برای مشاهده فهرست کامل فیلدها و SKUهای مرتبط با آن‌ها، به فیلدهای داده مکان (جدید) مراجعه کنید.

    • فیلدهای زیر باعث فعال شدن شناسه محصول Place Details Pro می‌شوند:

      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*
          * Use instead of Place.Field.PHONE_NUMBER, which is deprecated.
      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

      برای مشاهده فهرست کامل فیلدها و SKUهای مرتبط با آن‌ها، به فیلدهای داده مکان (جدید) مراجعه کنید.

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

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

  • کد منطقه

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

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

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

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

  • کد جلسه

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

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

نمونه «جزئیات جا»

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

// 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);