يمكنك طلب الحصول على مزيد من التفاصيل حول منشأة أو نقطة باستخدام مكان إثبات الهوية طلب تفاصيل المكان (جديد) إرجاع تفاصيل المكان (جديد) بشكل أكثر شمولاً معلومات عن المكان المشار إليه، مثل العنوان الكامل أو رقم الهاتف ورقمه وتقييم المستخدم والمراجعات.
هناك العديد من الطرق للحصول على رقم تعريف مكان. يمكنك استخدام:
طلبات تفاصيل المكان (جديدة)
يمكنك طلب تفاصيل المكان عن طريق الاتصال
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);