تفاصيل المكان (جديد)

يمكنك طلب مزيد من التفاصيل عن مكان أو نقطة ملفتة للانتباه معيّنة باستخدام معرّف المكان وتقديم طلب بشأن ملف تفاصيل المكان (جديد). تعرِض ميزة "تفاصيل المكان" (جديد) معلومات أكثر شمولاً عن المكان المحدَّد، مثل العنوان الكامل ورقم الهاتف والتقييمات والمراجعات التي كتبها المستخدمون.

هناك العديد من الطرق للحصول على رقم تعريف مكان. يمكنك استخدام:

• البحث النصي (جديد)
• بحث في الجوار (ميزة جديدة)
• الإكمال التلقائي (ميزة جديدة)

طلبات "تفاصيل المكان" (جديد)

يمكنك طلب تفاصيل عن المكان من خلال استدعاء 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.DISPLAY_NAME، Place.Field.ID، Place.Field.PHOTO_METADATAS، Place.Field.RESOURCE_NAME
    

  • تؤدي الحقول التالية إلى تنشيط رمز التخزين التعريفي لـ "تفاصيل المكان (الموقع الجغرافي فقط)":

    Place.Field.ADDRESS_COMPONENTS ADR_FORMAT_ADDRESS Place.Field.FORMATTED_ADDRESS Place.Field.LOCATION Place.Field.PLUS_CODE Place.Field.SHORT_FORMATTED_ADDRESS Place.Field.TYPES Place.Field.VIEWPORT
    

  • تؤدي الحقول التالية إلى تنشيط رمز التخزين التعريفي لـ "تفاصيل المكان (أساسية)":

    Place.Field.ACCESSIBILITY_OPTIONS Place.Field.BUSINESS_STATUS Place.Field.GOOGLE_MAPS_URI Place.Field.ICON_BACKGROUND_COLOR Place.Field.ICON_MASK_URL Place.Field.PRIMARY_TYPE Place.Field.PRIMARY_TYPE_DISPLAY_NAME Place.Field.SUB_DESTINATIONS Place.Field.UTC_OFFSET
    

  • تؤدي الحقول التالية إلى تنشيط رمز التخزين التعريفي لـ "تفاصيل المكان (متقدّمة)":

    Place.Field.CURRENT_OPENING_HOURS، Place.Field.CURRENT_SECONDARY_OPENING_HOURS Place.Field.INTERNATIONAL_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.WEBSITE_URI
    

  • تؤدي الحقول التالية إلى تنشيط رمز التخزين التعريفي لتفاصيل المكان (المفضّل):

    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" (من الناحية الفنية لجهة المملكة المتحدة لبريطانيا العظمى وأيرلندا الشمالية). يمكن أن تؤثّر المَعلمة في النتائج استنادًا إلى القانون الساري.

  لضبط مَعلمة رمز المنطقة، استخدِم الطريقة setRegionCode() عند إنشاء العنصر FetchPlaceRequest.

• الرمز المميّز للجلسة

  علامات الجلسات هي سلاسل ينشئها المستخدمون وتتتبّع طلبات الإكمال التلقائي (جديد) على أنّها "جلسات". تستخدِم ميزة "الإكمال التلقائي (جديد)" الرموز المميّزة للجلسات بهدف تجميع مراحل طلب البحث واختيار مكان البحث في عملية بحث الإكمال التلقائي للمستخدِم في جلسة منفصلة لأغراض الفوترة. يتمّ تمرير الرموز المميّزة للجلسات إلى طلبات بيانات تفاصيل الأماكن (جديد) التي تلي طلبات بيانات الإكمال التلقائي (جديد). لمزيد من المعلومات، يُرجى الاطّلاع على رموز الجلسات.

  لضبط مَعلمة رمز الجلسة، استخدِم الطريقة setSessionToken() عند إنشاء عنصر FetchPlaceRequest.

مثال على تفاصيل المكان

يطلب المثال التالي حقول 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);