نظرة عامة

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

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

وظائف الأعضاء العامين
(GMSPlaceOpenStatus)	- isOpenAtDate:
	الإعداد التلقائي غير متاح.
(GMSPlaceOpenStatus)	- isOpen
	يتم احتساب ما إذا كان المكان مفتوحًا استنادًا إلى `openingHours` و`UTCOffsetMinutes` والتاريخ والوقت الحاليَين اللذين تم الحصول عليهما من `[NSDate date]`.
المواقع
NSString *	name
	اسم المكان.
NSString *	placeID
	رقم تعريف المكان لهذا المكان.
CLLocationCoordinate2D	الإحداثيات
	موقع المكان.
NSString *	phoneNumber
	رقم هاتف هذا المكان، بالتنسيق الدولي، أي
NSString *	formattedAddress
	عنوان المكان كسلسلة بسيطة.
float	التقييم
	تقييم من خمس نجوم لهذا المكان استنادً إلى مراجعات المستخدمين
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
	معادلة التوقيت العالمي المنسَّق للمكان بالدقائق
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*) الاسم [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 أنه لا يتوفر لدينا تقييم لهذا المكان (على سبيل المثال، نظرًا لعدم وجود عدد كافٍ من المستخدمين اكتب مراجعة لهذا المكان).

- (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 هذا، كما هو موضّح في بنود خدمة حزمة تطوير البرامج للأماكن.

- (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 فقط.