إشعار: ستتوفّر قريبًا ميزة جديدة لتصميم الخرائط الأساسية في "منصة خرائط Google". يتضمّن هذا التعديل على تصميم الخريطة لوحة ألوان تلقائية جديدة وعلامات جديدة وتحسينات على تجارب الخريطة وسهولة استخدامها. سيتم تعديل جميع أنماط الخرائط تلقائيًا في آذار (مارس) 2025. لمزيد من المعلومات عن مدى التوفّر وكيفية تفعيل هذا النمط في وقت سابق، يُرجى الاطّلاع على نمط الخريطة الجديد لمنصّة "خرائط Google".

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

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

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

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

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

address_component
adr_address
formatted_phone_number
international_phone_number
opening_hours (لا يتم عرضها في أي عمليات بحث عن أماكن. بالنسبة إلى ميزة "البحث عن الأماكن القريبة" وميزة "البحث النصي"، استخدِم مَعلمة الطلب openNow.)
reviews
takeout
type
url
utc_offset_minutes
vicinity
website

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