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

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

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

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

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

الحقل 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 --- ---
معرّف الموارد المنتظم الأساسي لقناع الرمز 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

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

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

حقول Places Library وMaps JavaScript API

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

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

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