نظرة عامة

يمثّل مكانًا فعليًا معيّنًا.

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

وظائف الأعضاء العامة
(GMSPlaceOpenStatus)	- isOpenAtDate:
	لا يتوفّر الإدخال التلقائي.
(GMSPlaceOpenStatus)	- isOpen
	احتساب ما إذا كان المكان مفتوحًا استنادًا إلى `openingHours` و`UTCOffsetMinutes` والتاريخ والوقت الحاليَين اللذين تم الحصول عليهما من `[NSDate date]`.
المواقع
NSString *	name
	تمثّل هذه السمة اسم المكان.
NSString *	placeID
	رقم تعريف المكان لهذا المكان.
CLLocationCoordinate2D	التنسيق
	تمثّل هذه السمة موقع المكان.
NSString *	phoneNumber
	رقم الهاتف لهذا المكان، بالتنسيق الدولي، أي
NSString *	formattedAddress
	عنوان المكان كسلسلة بسيطة.
float	التقييم
	تقييم من خمس نجوم لهذا المكان استنادًا إلى مراجعات المستخدمين
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
	يعرض الملخص التحريري لهذا المكان.
لون واجهة المستخدم *	iconBackgroundColor
	لون خلفية الرمز وفقًا لنوع المكان، لتلوين العرض خلف الرمز.
NSURL *	iconImageURL
	عنوان URL وفقًا لنوع المكان، والذي يمكنك استخدامه لاسترداد NSData لرمز المكان.
GMSBooleanPlaceAttribute	طلب الوجبات لتناولها خارج المطعم
	سمة المكان لتجربة الوجبات الجاهزة
GMSBooleanPlaceAttribute	التسليم
	سمة المكان لخدمات التوصيل.
GMSBooleanPlaceAttribute	dineIn
	سمة المكان لتناول العشاء في التجربة.
GMSBooleanPlaceAttribute	curbsidePickup
	سمة المكان لخدمات الاستلام من السيارة
GMSBooleanPlaceAttribute	قابل للحجز
	سمة المكان التي تشير إلى مكان مشهور لدى السائحين.
GMSBooleanPlaceAttribute	servesBreakfast
	سمة المكان تشير إلى مكان تقديم وجبة الفطور
GMSBooleanPlaceAttribute	servesLunch
	سمة المكان تشير إلى مكان تقديم الغداء
GMSBooleanPlaceAttribute	servesDinner
	سمة المكان التي تشير إلى مكان تقديم العشاء
GMSBooleanPlaceAttribute	servesBeer
	سمة المكان تشير إلى مكان تقديم البيرة.
GMSBooleanPlaceAttribute	servesWine
	سمة المكان التي تشير إلى مكان تقديم النبيذ
GMSBooleanPlaceAttribute	servesBrunch
	سمة المكان التي تشير إلى مكان تقديم وجبة الفطور المتأخر.
GMSBooleanPlaceAttribute	servesVegetarianFood
	سمة المكان التي تشير إلى مكان يقدّم مأكولات نباتية
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*) name [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 *>*) reviews [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*) Attribution [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.