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

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

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

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

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

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

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

الحقل	واجهة برمجة تطبيقات الأماكن	مكتبة الأماكن وواجهة برمجة تطبيقات JavaScript للخرائط	حزمة تطوير برامج الأماكن لأجهزة Android	وضع حزمة تطوير البرامج (SDK) لميزة "الأماكن" لنظام التشغيل 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`	`---`	`---`
معرّف الموارد المنتظم (URI) لقاعدة قناع الرموز	`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`

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

الحقل	واجهة برمجة تطبيقات الأماكن	مكتبة الأماكن وواجهة برمجة تطبيقات JavaScript للخرائط	حزمة تطوير برامج الأماكن لأجهزة Android	وضع حزمة تطوير البرامج (SDK) لميزة "الأماكن" لنظام التشغيل 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`

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

الحقل	واجهة برمجة تطبيقات الأماكن	مكتبة الأماكن وواجهة برمجة تطبيقات JavaScript للخرائط	حزمة تطوير برامج الأماكن لأجهزة Android	وضع حزمة تطوير البرامج (SDK) لميزة "الأماكن" لنظام التشغيل 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`	`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

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