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

اختيار النظام الأساسي: Android iOS JavaScript Web Service

مطوّرو المنطقة الاقتصادية الأوروبية (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 ، لا يتضمّن سوى الحقول التي طلبتموها باستخدام قائمة الحقول. لا يمكن أن تكون نتائج بيانات المكان فارغة، لذا لا يتم عرض سوى نتائج الأماكن التي تتضمّن بيانات (على سبيل المثال، إذا لم يكن للمكان المطلوب أي صور، لن يظهر حقل الصور في النتيجة).

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

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

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

  • رقم تعريف المكان

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

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

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

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

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

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

      Place.Field.ID
      Place.Field.PHOTO_METADATAS
      Place.Field.RESOURCE_NAME

      للاطّلاع على قائمة كاملة بالحقول ورموز التخزين التعريفية المرتبطة بها، يُرجى الاطّلاع على مقالة حقول بيانات المكان (جديد).

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

      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

      للاطّلاع على قائمة كاملة بالحقول ورموز التخزين التعريفية المرتبطة بها، يُرجى الاطّلاع على مقالة حقول بيانات المكان (جديد).

    • تؤدي الحقول التالية إلى تفعيل رمز التخزين التعريفي "تفاصيل المكان 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

      للاطّلاع على قائمة كاملة بالحقول ورموز التخزين التعريفية المرتبطة بها، يُرجى الاطّلاع على مقالة حقول بيانات المكان (جديد).

    • تؤدي الحقول التالية إلى تفعيل رمز التخزين التعريفي "تفاصيل المكان Enterprise":

      Place.Field.CURRENT_OPENING_HOURS
      Place.Field.CURRENT_SECONDARY_OPENING_HOURS
      Place.Field.INTERNATIONAL_PHONE_NUMBER*
          * استخدِموا هذا الحقل بدلاً من Place.Field.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.USER_RATINGS_TOTAL (الذي تم إيقافه).
      Place.Field.WEBSITE_URI

      للاطّلاع على قائمة كاملة بالحقول ورموز التخزين التعريفية المرتبطة بها، يُرجى الاطّلاع على مقالة حقول بيانات المكان (جديد).

    • تؤدي الحقول التالية إلى تفعيل رمز التخزين التعريفي "تفاصيل المكان 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

      للاطّلاع على قائمة كاملة بالحقول ورموز التخزين التعريفية المرتبطة بها، يُرجى الاطّلاع على مقالة حقول بيانات المكان (جديد).

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

المَعلمات الاختيارية لـ 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);