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

اختيار النظام الأساسي: Android iOS JavaScript خدمة الويب

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

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

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

ملاحظة مهمة: بما أنّه لا يمكن أن تكون نتائج بيانات الأماكن فارغة، لا يتم عرض سوى نتائج الأماكن التي تحتوي على بيانات. على سبيل المثال، إذا كان مكان العميل المطلوب لا يتضمّن أي صور، لن يظهر الحقل 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

إتاحة حقول واجهة برمجة التطبيقات للأماكن

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

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

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