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

اختيار النظام الأساسي: 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

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