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

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

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

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

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

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