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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
اختيار نظام أساسي: Android iOS JavaScript خدمة الويب

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

لمزيد من المعلومات حول كيفية إصدار فواتير لطلبات "تفاصيل المكان"، راجع الاستخدام والفوترة.

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

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

الحقل واجهة برمجة تطبيقات الأماكن مكتبة الأماكن، واجهة برمجة تطبيقات JavaScript للخرائط تطبيق الأماكن على الأجهزة التي تعمل بنظام التشغيل Android تطبيق الأماكن على الأجهزة التي تعمل بنظام التشغيل iOS
مكوّن العنوان address_component address_component 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 لـ Mask Base 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 --- --- GMSPlaceFieldWheelchairAccessibleEntrance

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

الحقل واجهة برمجة تطبيقات الأماكن مكتبة الأماكن، واجهة برمجة تطبيقات JavaScript للخرائط تطبيق الأماكن على الأجهزة التي تعمل بنظام التشغيل Android تطبيق الأماكن على الأجهزة التي تعمل بنظام التشغيل 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 --- --- ---
ساعات العمل الثانوية secondary_opening_hours --- --- ---
الموقع الإلكتروني website website Place.Field.WEBSITE_URI GMSPlaceFieldWebsite

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

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

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

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

  • 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

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