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

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

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

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

ملاحظة مهمة: بما أنّه لا يمكن أن تكون نتائج بيانات الأماكن فارغة، يتم عرض نتائج الأماكن التي تتضمّن بيانات فقط. على سبيل المثال، إذا لم يتضمّن المكان المطلوب أي صور، لن يظهر الحقل photos في النتيجة.

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

الحقل	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 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

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