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

اختيار النظام الأساسي: Android iOS JavaScript خدمة الويب

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

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

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

يمكنك طلب تفاصيل عن المكان من خلال استدعاء 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:

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

في ما يلي المَعلمات الاختيارية لسمة FetchPlaceRequest:

  • رمز المنطقة

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

    إذا كان اسم البلد في حقل Place.Field.FORMATTED_ADDRESS في الاستجابة يتطابق مع regionCode، يتم حذف رمز البلد من Place.Field.FORMATTED_ADDRESS.

    تتطابق معظم رموز CLDR مع رموز ISO 3166-1، باستثناء بعض الاستثناءات البارزة. على سبيل المثال، رمز المستوى الأعلى للمنطقة الجغرافية للمملكة المتحدة هو "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);