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

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

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

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

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

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

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

إتاحة حقول Places API

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

  • address_component
  • adr_address
  • curbside_pickup
  • current_opening_hours
  • delivery
  • dine_in
  • editorial_summary
  • formatted_phone_number
  • international_phone_number
  • opening_hours.periods
  • opening_hours.special_days
  • opening_hours.type
  • opening_hours.weekday_text
  • reservable
  • secondary_opening_hours
  • reviews
  • serves_beer
  • serves_breakfast
  • serves_brunch
  • serves_dinner
  • serves_lunch
  • serves_vegetarian_food
  • serves_wine
  • takeout
  • type
  • url
  • user_ratings_total
  • utc_offset_minutes
  • vicinity
  • website
  • wheelchair_accessible_entrance

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