حقول بيانات المكان

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

تحدد حقول بيانات المكان أنواع بيانات المكان المراد عرضها عند طلب تفاصيل المكان. تسرد هذه الصفحة جميع حقول بيانات الأماكن، وتوضح كيفية دعمها لكل واجهة برمجة تطبيقات/حزمة تطوير برامج (SDK) (يختلف دعم حقول الأماكن حسب النظام الأساسي و/أو الميزة).

لمزيد من المعلومات عن كيفية فوترة طلبات تفاصيل المكان، يمكنك الاطّلاع على الاستخدام والفوترة.

يسرد الجدول التالي جميع قيم حقول بيانات الأماكن المدعومة حسب فئة التسعير والنظام الأساسي.

ملاحظة مهمة: بسبب عدم إمكانية أن تكون نتائج بيانات الأماكن فارغة، يتم عرض نتائج الأماكن التي تحتوي على بيانات فقط. على سبيل المثال، إذا لم يكن المكان المطلوب يحتوي على صور، لن يكون الحقل photos متاحًا في النتيجة.

البيانات الأساسية

الحقل	واجهة برمجة تطبيقات الأماكن	مكتبة الأماكن، وواجهة برمجة تطبيقات JavaScript للخرائط	وضع حزمة تطوير البرامج (SDK) لنظام التشغيل Android	وضع حزمة تطوير البرامج (SDK) لنظام التشغيل iOS
عناصر العنوان	`address_components`	`address_components`	`Place.Field.ADDRESS_COMPONENTS`	`GMSPlaceFieldAddressComponents`
العنوان	`adr_address`	`adr_address`	`---`	`---`
حالة النشاط التجاري	`business_status`	`business_status`	`Place.Field.BUSINESS_STATUS`	`GMSPlaceFieldBusinessStatus`
العنوان المنسَّق	`formatted_address`	`formatted_address`	`Place.Field.ADDRESS`	`GMSPlaceFieldFormattedAddress`
إطار العرض	`geometry/viewport`	`geometry.viewport`	`Place.Field.VIEWPORT`	`GMSPlaceFieldViewport`
الموقع الجغرافي	`geometry/location`	`geometry.location`	`Place.Field.LAT_LNG`	`GMSPlaceFieldCoordinate`
الرمز	`icon`	`icon`	`---`	`---`
معرّف الموارد المنتظم (URI) لقاعدة قناع الرمز	`icon_mask_base_uri`	`icon_mask_base_uri`	`Place.Field.ICON_URL`	`GMSPlaceFieldIconImageURL`
لون خلفية الرمز	`icon_background_color`	`icon_background_color`	`Place.Field.ICON_BACKGROUND_COLOR`	`GMSPlaceFieldIconBackgroundColor`
الاسم	`name`	`name`	`Place.Field.NAME`	`GMSPlaceFieldName`
مغلق نهائيًا (متوقّف نهائيًا)	`permanently_closed`	`permanently_closed`	`---`	`---`
صورة	`photos`	`photos`	`Place.Field.PHOTO_METADATAS`	`GMSPlaceFieldPhotos`
معرّف المكان	`place_id`	`place_id`	`Place.Field.ID`	`GMSPlaceFieldPlaceID`
رمز Plus Codes	`plus_code`	`plus_code`	`Place.Field.PLUS_CODE`	`GMSPlaceFieldPlusCode`
Type	`type`	`type`	`Place.Field.TYPES`	`GMSPlaceFieldTypes`
عنوان URL	`url`	`url`	`---`	`---`
معادلة التوقيت العالمي المتفق عليه	`utc_offset`	`utc_offset_minutes`	`Place.Field.UTC_OFFSET`	`GMSPlaceFieldUTCOffsetMinutes`
منطقة مجاورة	`vicinity`	`vicinity`	`---`	`---`
دخول صالح للكراسي المتحرّكة	`wheelchair_accessible_entrance`	`---`	`Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE`	`GMSPlaceFieldWheelchairAccessibleEntrance`

حقول بيانات جهة الاتصال

الحقل	واجهة برمجة تطبيقات الأماكن	مكتبة الأماكن، وواجهة برمجة تطبيقات JavaScript للخرائط	وضع حزمة تطوير البرامج (SDK) لنظام التشغيل Android	وضع حزمة تطوير البرامج (SDK) لنظام التشغيل iOS
رقم الهاتف	`formatted_phone_number`	`formatted_phone_number`	`---`	`---`
رقم الهاتف الدولي	`international_phone_number`	`international_phone_number`	`Place.Field.PHONE_NUMBER`	`GMSPlaceFieldPhoneNumber`
ساعات العمل	`opening_hours`	`opening_hours`	`Place.Field.OPENING_HOURS`	`GMSPlaceFieldOpeningHours`
ساعات العمل الحالية	`current_opening_hours`	`---`	`Place.Field.CURRENT_OPENING_HOURS`	`GMSPlaceFieldCurrentOpeningHours`
ساعات العمل الثانوية	`secondary_opening_hours`	`---`	`Place.Field.SECONDARY_OPENING_HOURS`	`GMSPlaceFieldSecondaryOpeningHours`
الموقع الإلكتروني	`website`	`website`	`Place.Field.WEBSITE_URI`	`GMSPlaceFieldWebsite`

حقول بيانات الغلاف الجوي

الحقل	واجهة برمجة تطبيقات الأماكن	مكتبة الأماكن، وواجهة برمجة تطبيقات JavaScript للخرائط	وضع حزمة تطوير البرامج (SDK) لنظام التشغيل Android	وضع حزمة تطوير البرامج (SDK) لنظام التشغيل iOS
خدمة الإيصال إلى السيارة	`curbside_pickup`	`---`	`Place.Field.CURBSIDE_PICKUP`	`GMSPlaceFieldCurbsidePickup`
خدمة توصيل	`delivery`	`---`	`Place.Field.DELIVERY`	`GMSPlaceFieldDelivery`
الجلوس في المطعم	`dine_in`	`---`	`Place.Field.DINE_IN`	`GMSPlaceFieldDineIn`
الملخص التحريري	`editorial_summary`	`---`	`Place.Field.EDITORIAL_SUMMARY`	`GMSPlaceFieldEditorialSummary`
مستوى السعر	`price_level`	`price_level`	`Place.Field.PRICE_LEVEL`	`GMSPlaceFieldPriceLevel`
Rating	`rating`	`rating`	`Place.Field.RATING`	`GMSPlaceFieldRating`
قابلة للحجز	`reservable`	`---`	`Place.Field.RESERVABLE`	`GMSPlaceFieldReservable`
المراجعات	`reviews`	`reviews`	`Place.Field.REVIEWS`	`---`
يقدم البيرة	`serves_beer`	`---`	`Place.Field.SERVES_BEER`	`GMSPlaceFieldServesBeer`
يقدم وجبات الإفطار	`serves_breakfast`	`---`	`Place.Field.SERVES_BREAKFAST`	`GMSPlaceFieldServesBreakfast`
يقدم وجبات الفطور المتأخر	`serves_brunch`	`---`	`Place.Field.SERVES_BRUNCH`	`GMSPlaceFieldServesBrunch`
يقدم وجبات العشاء	`serves_dinner`	`---`	`Place.Field.SERVES_DINNER`	`GMSPlaceFieldServesDinner`
يقدم وجبات الغداء	`serves_lunch`	`---`	`Place.Field.SERVES_LUNCH`	`GMSPlaceFieldServesLunch`
يقدّم مأكولات نباتية	`serves_vegetarian_food`	`---`	`Place.Field.SERVES_VEGETARIAN_FOOD`	`GMSPlaceFieldServesVegetarianFood`
يقدم النبيذ	`serves_wine`	`---`	`Place.Field.SERVES_WINE`	`GMSPlaceFieldServesWine`
طعام سفري	`takeout`	`---`	`Place.Field.TAKEOUT`	`GMSPlaceFieldTakeout`
إجمالي تقييمات المستخدمين	`user_ratings_total`	`user_ratings_total`	`Place.Field.USER_RATINGS_TOTAL`	`GMSPlaceFieldUserRatingsTotal`

دعم حقول حزمة تطوير برامج الأماكن لأجهزة iOS

بالإضافة إلى الحقول المذكورة أعلاه، تتضمّن حزمة تطوير البرامج "SDK" الخاصة بالأماكن لنظام التشغيل iOS نوع بيانات GMSPlaceFieldAll، والذي يؤثر في عرض جميع حقول البيانات المتاحة.

لا يتوافق findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: مع الحقول التالية:

GMSPlaceFieldTakeout
GMSPlaceFieldDelivery
GMSPlaceFieldDineIn
GMSPlaceFieldCurbsidePickup
GMSPlaceFieldAddressComponents
GMSPlaceFieldOpeningHours
GMSPlaceFieldPhoneNumber
GMSPlaceFieldWebsite
GMSPlaceFieldUtcOffsetMinutes