حقول بيانات الأماكن (الإصدار القديم)

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

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

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

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

الحقل Places API (الإصدار القديم) Places Library, Maps JavaScript API حزمة تطوير برامج الأماكن لأجهزة Android (الإصدار القديم) حزمة تطوير برامج الأماكن لأجهزة 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.FORMATTED_ADDRESS GMSPlaceFieldFormattedAddress
إطار العرض geometry/viewport geometry.viewport Place.Field.VIEWPORT GMSPlaceFieldViewport
الموقع الجغرافي geometry/location geometry.location Place.Field.LOCATION GMSPlaceFieldCoordinate
رمز icon icon --- ---
معرّف الموارد المنتظم (URI) الأساسي لقناع الرمز icon_mask_base_uri icon_mask_base_uri Place.Field.ICON_MASK_URL GMSPlaceFieldIconImageURL
لون خلفية الرمز icon_background_color icon_background_color Place.Field.ICON_BACKGROUND_COLOR GMSPlaceFieldIconBackgroundColor
الاسم name name Place.Field.DISPLAY_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 vicinity --- ---
مدخل مناسب لأصحاب الكراسي المتحرّكة wheelchair_accessible_entrance --- Place.Field.ACCESSIBILITY_OPTIONS GMSPlaceFieldWheelchairAccessibleEntrance

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

الحقل Places API (الإصدار القديم) Places Library, Maps JavaScript API حزمة تطوير برامج الأماكن لأجهزة Android (الإصدار القديم) حزمة تطوير برامج الأماكن لأجهزة iOS (الإصدار القديم)
رقم الهاتف formatted_phone_number formatted_phone_number --- ---
رقم هاتف دولي international_phone_number international_phone_number Place.Field.INTERNATIONAL_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

حقول بيانات Atmosphere

الحقل Places API (الإصدار القديم) Places Library, Maps JavaScript API حزمة تطوير برامج الأماكن لأجهزة 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 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_COUNT GMSPlaceFieldUserRatingsTotal

Places Library, Maps JavaScript API fields support

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

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

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