نظرة عامة

تمثل مكانًا ماديًا معينًا.

يضم الحقل GMSPlace معلومات عن موقع جغرافي فعلي، بما في ذلك اسمه وموقعه الجغرافي وأي معلومات أخرى قد تكون لدينا عنه. هذه الفئة غير قابلة للتغيير.

الوظائف العامة
(GMSPlaceOpenStatus)	- isOpenAtDate:
	الإعداد التلقائي غير متاح.
(GMSPlaceOpenStatus)	- isOpen
	لاحتساب ما إذا كان المكان مفتوحًا استنادًا إلى `openingHours` و`UTCOffsetMinutes` والتاريخ والوقت الحاليين الذي تم الحصول عليهما من `[NSDate date]`.
أماكن إقامة
NSString *	name
	اسم المكان.
NSString *	placeID
	رقم تعريف المكان لهذا المكان.
دالة CLLocationCoordinate2D	الإحداثيات
	الموقع الجغرافي للمكان.
NSString *	phoneNumber
	رقم هاتف هذا المكان بالتنسيق الدولي، أي
NSString *	formattedAddress
	تمثّل هذه السمة عنوان المكان كسلسلة بسيطة.
عدد عائم	التقييم
	تقييم من خمس نجوم لهذا المكان استنادًا إلى مراجعات المستخدمين
NSArray< GMSPlaceReview * > *	المراجعات
	مصفوفة من عناصر `GMSPlaceReview` تمثّل مراجعات المستخدمين للمكان
GMSPlacesPriceLevel	priceLevel
	مستوى سعر هذا المكان، كأعداد صحيحة من 0 إلى 4.
NSArray< NSString * > *	الأنواع
	أنواع هذا المكان.
NSURL *	الموقع الإلكتروني
	الموقع الإلكتروني لهذا المكان
NSAttributedString *	الإحالة
	سلسلة تحديد مصدر مزوِّد البيانات لهذا المكان
GMSPlaceViewportInfo *	viewportInfo
	إطار العرض المقترَح لهذا المكان
NSArray< GMSAddressComponent * > *	addressComponents
	مصفوفة من عناصر `GMSAddressComponent` تمثل المكوّنات في عنوان المكان.
GMSPlusCode *	plusCode
	تمثيل رمز Plus Codes للموقع الجغرافي لهذا المكان
GMSOpeningHours *	openingHours
	معلومات ساعات العمل العادية لهذا المكان.
GMSOpeningHours *	currentOpeningHours
	عرض ساعات العمل لهذا المكان خلال الأيام السبعة المقبلة.
NSArray< GMSOpeningHours * > *	secondaryOpeningHours
	تعرض صفيفًا من ساعات العمل الثانوية لهذا المكان على مدار الأيام السبعة التالية.
NSUInteger	userRatingsTotal
	تمثّل هذه السمة عدد المراجعات التي تشكّل تقييم هذا المكان.
NSArray< GMSPlacePhotoMetadata * > *	صور
	مصفوفة من `GMSPlacePhotoMetadata` عناصر تمثّل صور المكان.
NSNumber *	UTCOffsetMinutes
	معادلة المنطقة الزمنية بالتوقيت العالمي المنسّق (UTC) للمكان بالدقائق
GMSPlacesBusinessStatus	businessStatus
	تمثّل هذه السمة `GMSPlaceBusinessStatus` للمكان.
NSString *	editorialSummary
	تعرض الملخّص التحريري لهذا المكان.
UIColor *	iconBackgroundColor
	لون خلفية الرمز حسب نوع المكان، لتلوين العرض خلف الرمز.
NSURL *	iconImageURL
	عنوان URL وفقًا لنوع المكان، والذي يمكنك استخدامه لاسترداد NSData لرمز المكان.
GMSBooleanPlaceAttribute	تناول الطعام في الخارج
	وضع سمة لتجربة تناول الطعام في الخارج.
GMSBooleanPlaceAttribute	التسليم
	سمة Place لخدمات التسليم
GMSBooleanPlaceAttribute	dineIn
	ضع سمة لتناول الطعام في التجربة.
GMSBooleanPlaceAttribute	curbsidePickup
	وضع "السمة" لخدمات الاستلام من السيارة
GMSBooleanPlaceAttribute	قابلة للحجز
	سمة المكان التي تشير إلى مكان يقصده السياح.
GMSBooleanPlaceAttribute	servesBreakfast
	سمة "بلاس" التي تشير إلى مكان يقدّم وجبة الفطور
GMSBooleanPlaceAttribute	servesLunch
	سمة "بلاس" التي تشير إلى مكان يقدّم وجبة الغداء
GMSBooleanPlaceAttribute	servesDinner
	سمة المكان التي تشير إلى مكان يقدم العشاء
GMSBooleanPlaceAttribute	servesBeer
	سمة المكان التي تشير إلى مكان يقدم البيرة
GMSBooleanPlaceAttribute	servesWine
	سمة المكان التي تشير إلى مكان يقدم النبيذ.
GMSBooleanPlaceAttribute	servesBrunch
	سمة Place تشير إلى مكان يقدم وجبات الإفطار المتأخر
GMSBooleanPlaceAttribute	servesVegetarianFood
	تشير سمة "Place Attribute" (سمة المكان) إلى أنّ المكان يقدّم الطعام النباتي.
GMSBooleanPlaceAttribute	wheelchairAccessibleEntrance
	سمة المكان التي تشير إلى إمكانية وصول الكراسي المتحركة عند المدخل

المستندات الخاصة بوظائف الأعضاء

- (GMSPlaceOpenStatus) isOpenAtDate: (NSDate *) تاريخ

الإعداد التلقائي غير متاح.

لاحتساب ما إذا كان المكان مفتوحًا استنادًا إلى openingHours وUTCOffsetMinutes وdate.

المَعلمات:

التاريخ يشير ذلك المصطلح إلى نقطة زمنية مرجعية تُستخدَم لتحديد ما إذا كان المكان مفتوحًا.

المرتجعات:: GMSPlaceOpenStatusOpen إذا كان المكان مفتوحًا، وGMSPlaceOpenStatusClosed إذا كان المكان مغلقًا، وGMSPlaceOpenStatusUnknown إذا كانت الحالة "مفتوح" غير معروفة

ملاحظة:: تم إيقاف هذا نهائيًا. تم إيقاف هذه الطريقة نهائيًا لصالح GMSPlacesClient::isOpenAtDate:place:date:callback</ code> and will be removed in a future release.

- (GMSPlaceOpenStatus) isOpen (حالة الفتح)

لاحتساب ما إذا كان المكان مفتوحًا استنادًا إلى openingHours وUTCOffsetMinutes والتاريخ والوقت الحاليين الذي تم الحصول عليهما من [NSDate date].

المرتجعات:: GMSPlaceOpenStatusOpen إذا كان المكان مفتوحًا، وGMSPlaceOpenStatusClosed إذا كان المكان مغلقًا، وGMSPlaceOpenStatusUnknown إذا كانت الحالة "مفتوح" غير معروفة

ملاحظة:: تم إيقاف هذا نهائيًا. تم إيقاف هذه الطريقة نهائيًا لصالح GMSPlacesClient::isOpen:place:callback وستتم إزالتها في إصدار مستقبلي.

وثائق العقارات

- (NSString*) الاسم [read, copy]

اسم المكان.

- (NSString*) placeID [read, copy]

رقم تعريف المكان لهذا المكان.

- (CLLocationCoordinate2D) إحداثيًا [read, assign]

الموقع الجغرافي للمكان.

الموقع ليس بالضرورة مركز المكان، أو أي نقطة دخول أو خروج معينة، ولكن نقطة يتم اختيارها عشوائيًا داخل النطاق الجغرافي للمكان.

- (NSString*) phoneNumber [read, copy]

رقم هاتف هذا المكان بالتنسيق الدولي، أي

بما في ذلك رمز البلد الذي يبدأ بـ "+". على سبيل المثال، رقم هاتف Google سيدني هو " +61 2 9374 4000".

- (NSString*) formattedAddress [read, copy]

تمثّل هذه السمة عنوان المكان كسلسلة بسيطة.

- (التقييم العائم) [read, assign]

تقييم من خمس نجوم لهذا المكان استنادًا إلى مراجعات المستخدمين

تتراوح التقييمات بين 1.0 و5.0. تعني القيمة 0.0 أنّه ليس لدينا أي تقييم لهذا المكان (على سبيل المثال، بسبب عدم مراجعة عدد كافٍ من المستخدمين لهذا المكان).

- (NSArray<GMSPlaceReview *>*) مراجعات [read, copy]

مصفوفة من عناصر GMSPlaceReview تمثّل مراجعات المستخدمين للمكان

- (GMSPlacesPriceLevel) priceLevel [read, assign]

مستوى سعر هذا المكان، كأعداد صحيحة من 0 إلى 4.

مثلاً: تعني القيمة 4 أنّ هذا المكان هو "$$$$". (باهظ الثمن). وتعني القيمة 0 أنّه متاح مجانًا (مثل متحف يمكن الدخول إليه مجانًا).

- (NSArray<NSString *>*) types [read, copy]

أنواع هذا المكان.

والأنواع هي NSStrings، والقيم الصالحة هي أي أنواع موثّقة على <https://developers.google.com/places/ios-sdk/supported_types>.

- (NSURL*) الموقع الإلكتروني [read, copy]

الموقع الإلكتروني لهذا المكان

- (NSAttributedString*) إحالات [read, copy]

سلسلة تحديد مصدر مزوِّد البيانات لهذا المكان

تتوفر هذه السلسلة على شكل NSAttributedString والتي قد تحتوي على روابط تشعّبية تؤدي إلى الموقع الإلكتروني لكل موفّر.

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

- (GMSPlaceViewportInfo*) viewportInfo [read, assign]

إطار العرض المقترَح لهذا المكان

قد تكون القيمة فارغة إذا لم يكن حجم المكان معروفًا.

ويؤدي هذا إلى إرجاع إطار عرض بحجم مناسب لعرض هذا المكان. على سبيل المثال، قد يكون لكائن GMSPlace الذي يمثّل متجرًا بإطار عرض صغير نسبيًا، بينما قد يكون للكائن GMSPlace الذي يمثّل بلدًا إطار عرض كبيرًا جدًا.

- (NSArray<GMSAddressComponent *>*) addressComponents [read, copy]

مصفوفة من عناصر GMSAddressComponent تمثل المكوّنات في عنوان المكان.

يتم تقديم هذه المكوّنات بغرض استخراج المعلومات المنظّمة حول عنوان المكان: على سبيل المثال، العثور على المدينة التي يقع فيها المكان.

يجب عدم استخدام هذه المكوّنات لتنسيق العنوان. في حال كان العنوان منسَّقًا، استخدِم السمة formattedAddress التي توفّر عنوانًا بتنسيق مترجم.

- (GMSPlusCode*) plusCode [read, assign]

تمثيل رمز Plus Codes للموقع الجغرافي لهذا المكان

- (GMSOpeningHours*) openingHours [read, assign]

معلومات ساعات العمل العادية لهذا المكان.

ويتضمّن ذلك حالة "مفتوح" وفترات ونصوص أيام الأسبوع عند توفّرها.

- (GMSOpeningHours*) currentOpeningHours [read, assign]

عرض ساعات العمل لهذا المكان خلال الأيام السبعة المقبلة.

تبدأ الفترة الزمنية في منتصف الليل من تاريخ الطلب وتنتهي في الساعة 11:59 مساءً بعد ستة أيام.

لن يتوفر GMSPlaceSpecialDay إدخال على GMSOpeningHours إلا لـ GMSPlace currentOpeningHours وGMSPlace secondaryOpeningHours.

- (NSArray<GMSOpeningHours *>*) secondaryOpeningHours [read, copy]

تعرض صفيفًا من ساعات العمل الثانوية لهذا المكان على مدار الأيام السبعة التالية.

تختلف ساعات العمل الثانوية عن ساعات العمل الرئيسية للنشاط التجاري. على سبيل المثال، يمكن أن يحدد مطعم ساعات العمل في السيارة أو ساعات التسليم كساعات ثانوية. يمكنك الانتقال إلى GMSPlaceHoursType للاطّلاع على الأنواع المختلفة من الساعات الثانوية.

لن يتوفر GMSPlaceSpecialDay إدخال على GMSOpeningHours إلا لـ GMSPlace currentOpeningHours وGMSPlace secondaryOpeningHours.