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

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

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

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

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

يمكنك طلب تفاصيل المكان عن طريق الاتصال 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);

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

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

للوصول إلى حقول البيانات، يمكنك طلب . على سبيل المثال، للوصول إلى اسم المكان، اتصل بالرقم getName().

المعلمات المطلوبة

المعلمات المطلوبة FetchPlaceRequest هي:

• معرّف المكان

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

• قائمة الحقول

  عندما تطلب مكانًا، يجب تحديد بيانات المكان التي تريد عرضها. إلى إجراء ذلك، مرِّر قائمة من قيم Place.Field لتحديد البيانات المراد إرجاعها. لا توجد قائمة افتراضية من الحقول بإرجاعها في الرد.

  تعتبر قوائم الحقول ممارسة جيدة في التصميم لضمان عدم طلب البيانات غير الضرورية، مما يساعد على تجنب وقت المعالجة غير الضروري رسوم الفوترة.تعتبر هذه القائمة أحد العوامل المهمة لأنها تؤثر في تكلفة كل طلب. لمزيد من المعلومات، يُرجى مراجعة الاستخدام والفوترة.

  حدِّد حقلاً واحدًا أو أكثر من الحقول التالية:

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

    Place.Field.ID, Place.Field.NAME, Place.Field.PHOTO_METADATAS

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

    Place.Field.ADDRESS_COMPONENTS, Place.Field.ADDRESS, Place.Field.LAT_LNG, Place.Field.PLUS_CODE, Place.Field.TYPES, Place.Field.VIEWPORT

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

    Place.Field.BUSINESS_STATUS, Place.Field.ICON_BACKGROUND_COLOR, Place.Field.ICON_URL, Place.Field.UTC_OFFSET, Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE

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

    Place.Field.CURRENT_OPENING_HOURS, Place.Field.SECONDARY_OPENING_HOURS, Place.Field.PHONE_NUMBER, Place.Field.PRICE_LEVEL, Place.Field.RATING, Place.Field.OPENING_HOURS, Place.Field.USER_RATINGS_TOTAL, Place.Field.WEBSITE_URI

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

    Place.Field.CURBSIDE_PICKUP, Place.Field.DELIVERY, Place.Field.DINE_IN, Place.Field.EDITORIAL_SUMMARY, Place.Field.RESERVABLE, Place.Field.REVIEWS, Place.Field.SERVES_BEER, Place.Field.SERVES_BREAKFAST, Place.Field.SERVES_BRUNCH, Place.Field.SERVES_DINNER, Place.Field.SERVES_LUNCH, Place.Field.SERVES_VEGETARIAN_FOOD, Place.Field.SERVES_WINE, Place.Field.TAKEOUT

المعلمات الاختيارية

المعلمات الاختيارية FetchPlaceRequest هي:

• رمز المنطقة

  رمز المنطقة المستخدَم لتنسيق الردّ، والذي يتم تحديده على أنّه رمز CLDR مؤلف من حرفين. لا يوجد قيمة افتراضية.

  إذا تطابق اسم البلد في الحقل Place.Field.ADDRESS في الردّ مع regionCode، تم حذف رمز البلد من Place.Field.ADDRESS.

  وتكون معظم رموز CLDR متطابقة مع رموز ISO 3166-1، مع بعض الاستثناءات الملحوظة. على سبيل المثال، نطاق المستوى الأعلى الذي يتم ترميزه حسب البلد (ccTLD) في المملكة المتحدة هو "uk" (co.uk.)، لكنّ رمزها وفقًا لمعيار ISO 3166-1 هو gb. (من الناحية الفنية بالنسبة كيان "المملكة المتحدة لبريطانيا العظمى وأيرلندا الشمالية"). ويمكن أن تؤثّر المَعلمة في النتائج استنادًا إلى القانون الساري.

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

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

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

  لضبط مَعلمة الرمز المميّز للجلسة، يمكنك طلب الطريقة setSessionToken() عند إنشاء كائن FetchPlaceRequest.

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

يطلب المثال التالي الحقول ID وNAME و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.NAME, Place.Field.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);