نظرة عامة
يمثّل مكانًا فعليًا معيّنًا.
تجمع علامة 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.
.
احتساب ما إذا كان المكان مفتوحًا استنادًا إلى 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] |
- (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
.
- (NSUInteger) userRatingsTotal [read, assign] |
تمثّل هذه السمة عدد المراجعات التي تشكّل تقييم هذا المكان.
- (NSArray<GMSPlacePhotoMetadata *>*) photos [read, copy] |
مصفوفة من عناصر GMSPlacePhotoMetadata
تمثل صور المكان.
- (NSNumber*) UTCOffsetMinutes [read, assign] |
معادلة التوقيت العالمي المنسَّق (UTC) للمكان بالدقائق
- (GMSPlacesBusinessStatus) businessStatus [read, assign] |
تمثّل هذه السمة GMSPlaceBusinessStatus
للمكان.
- (NSString*) editorialSummary [read, copy] |
يعرض الملخص التحريري لهذا المكان.
- (UIColor*) iconBackgroundColor [read, assign] |
لون خلفية الرمز وفقًا لنوع المكان، لتلوين العرض خلف الرمز.
- (NSURL*) iconImageURL [read, assign] |
عنوان URL وفقًا لنوع المكان، والذي يمكنك استخدامه لاسترداد NSData لرمز المكان.
ملاحظات: رابط عنوان URL لا تنتهي صلاحيته وقد تختلف نسبة العرض إلى الارتفاع لحجم الصورة حسب النوع.
- (GMSBooleanPlaceAttribute) takeout [read, assign] |
سمة المكان لتجربة الوجبات الجاهزة
- تسليم (GMSBooleanPlaceAttribute) [read, assign] |
سمة المكان لخدمات التوصيل.
- (GMSBooleanPlaceAttribute) dineIn [read, assign] |
سمة المكان لتناول العشاء في التجربة.
- (GMSBooleanPlaceAttribute) curbsidePickup [read, assign] |
سمة المكان لخدمات الاستلام من السيارة
- (GMSBooleanPlaceAttribute) قابلة للحجز [read, assign] |
سمة المكان التي تشير إلى مكان مشهور لدى السائحين.
- (GMSBooleanPlaceAttribute) servesBreakfast [read, assign] |
سمة المكان تشير إلى مكان تقديم وجبة الفطور
- (GMSBooleanPlaceAttribute) servesLunch [read, assign] |
سمة المكان تشير إلى مكان تقديم الغداء
- (GMSBooleanPlaceAttribute) servesDinner [read, assign] |
سمة المكان التي تشير إلى مكان تقديم العشاء
- (GMSBooleanPlaceAttribute) servesBeer [read, assign] |
سمة المكان تشير إلى مكان تقديم البيرة.
- (GMSBooleanPlaceAttribute) servesWine [read, assign] |
سمة المكان التي تشير إلى مكان تقديم النبيذ
- (GMSBooleanPlaceAttribute) servesBrunch [read, assign] |
سمة المكان التي تشير إلى مكان تقديم وجبة الفطور المتأخر.
- (GMSBooleanPlaceAttribute) servesVegetarianFood [read, assign] |
سمة المكان التي تشير إلى مكان يقدّم مأكولات نباتية
- (GMSBooleanPlaceAttribute) wheelchairAccessibleEntrance [read, assign] |
سمة المكان التي تشير إلى مكان يمكن الوصول إليه باستخدام الكراسي المتحرّكة عند المدخل.