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

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

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

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

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

الحقل Places API (الإصدار القديم) Places Library، واجهة برمجة التطبيقات JavaScript لتطبيق "خرائط Google" حزمة تطوير برامج "الأماكن" لأجهزة 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.ADDRESS GMSPlaceFieldFormattedAddress
إطار العرض geometry/viewport geometry.viewport Place.Field.VIEWPORT GMSPlaceFieldViewport
الموقع الجغرافي geometry/location geometry.location Place.Field.LAT_LNG GMSPlaceFieldCoordinate
الرمز icon icon --- ---
معرّف الموارد المنتظم الأساسي لقناع الرمز 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

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

الحقل Places API (الإصدار القديم) Places Library، واجهة برمجة التطبيقات JavaScript لتطبيق "خرائط Google" حزمة تطوير برامج "الأماكن" لأجهزة 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 --- Place.Field.CURRENT_OPENING_HOURS GMSPlaceFieldCurrentOpeningHours
ساعات العمل الثانوية secondary_opening_hours --- Place.Field.SECONDARY_OPENING_HOURS GMSPlaceFieldSecondaryOpeningHours
الموقع الإلكتروني website website Place.Field.WEBSITE_URI GMSPlaceFieldWebsite

حقول بيانات "الجوّ"

الحقل Places API (الإصدار القديم) Places Library، واجهة برمجة التطبيقات JavaScript لتطبيق "خرائط Google" حزمة تطوير برامج "الأماكن" لأجهزة Android (الإصدار القديم) حزمة تطوير برامج "الأماكن" لأجهزة 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_TOTAL GMSPlaceFieldUserRatingsTotal

إتاحة حقول Places Library وMaps JavaScript API

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

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

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