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

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

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

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

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

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

الحقل واجهة برمجة تطبيقات الأماكن مكتبة الأماكن، وواجهة برمجة تطبيقات 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 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

إتاحة حقول واجهة برمجة تطبيقات JavaScript للخرائط و"مكتبة الأماكن"

تطلب كلٌّ من العثور على المكان والبحث المجاور والبحث النصي عرض مجموعة فرعية من الحقول التي يتم عرضها بواسطة طلبات تفاصيل المكان. ولا تؤدي هذه الطرق إلى إرجاع الحقول التالية:

  • address_component
  • adr_address
  • formatted_phone_number
  • international_phone_number
  • opening_hours (لا يتم عرضها لأي عملية بحث عن الأماكن. بالنسبة إلى البحث عن المواقع القريبة والبحث النصي، يمكنك استخدام معلمة الطلب openNow).
  • reviews
  • takeout
  • type
  • url
  • utc_offset_minutes
  • vicinity
  • website

لإرجاع حقل واحد أو أكثر من حقول البيانات هذه لأحد الأماكن، يمكنك تقديم طلب تفاصيل المكان، وتمرير رقم تعريف مكان، وتحديد الحقول المطلوب عرضها.