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

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

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

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

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

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

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

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