סקירה כללית
מייצג מקום פיזי מסוים.
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 Code. | |
GMSOpeningHours * | openingHours |
המידע הרגיל לגבי שעות הפעילות של העסק במקום הזה. | |
GMSOpeningHours * | currentOpeningHours |
הצגת שעות הפעילות של המקום הזה במהלך שבעת הימים הבאים. | |
NSArray< GMSOpeningHours * > * | secondaryOpeningHours |
מחזירה מערך של שעות הפעילות המשניות של המקום במהלך שבעת הימים הבאים. | |
NSUInteger | userRatingsTotal |
מייצג את מספר הביקורות שמרכיבים את הדירוג של המקום. | |
NSArray< GMSPlacePhotoMetadata * > * | תמונות |
מערך של GMSPlacePhotoMetadata אובייקטים שמייצגים את התמונות של המקום. | |
NSNumber * | UTCOffsetMinutes |
הסטייה לפי שעון UTC (זמן אוניברסלי מתואם) של המקום בדקות. | |
GMSPlacesBusinessStatus (סטטוס העסק ב-GMSPlacesBusinessStatus) | businessStatus |
GMSPlaceBusinessStatus של המקום. | |
NSString * | editorialSummary |
הצגת תקציר העורכים של המקום הזה. | |
UIColor * | 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 *) | date (תאריך) |
אתחול ברירת המחדל אינו זמין.
הפונקציה מחשבת אם מקום פתוח לפי openingHours
, UTCOffsetMinutes
ו-date
.
- פרמטרים:
-
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] |
המזהה של המקום הזה.
- קואורדינטות [read, assign] (CLLocationCoordinate2D) |
מיקום המקום.
המיקום הוא לא בהכרח מרכז המקום, או כל נקודת כניסה או יציאה מסוימת, אלא נקודה כלשהי שנבחרה באופן שרירותי בתוך ההיקף הגיאוגרפי של המקום.
- (NSString*) phoneNumber [read, copy] |
מספר הטלפון של המקום הזה, בפורמט לחיוג בינלאומי, כלומר
כולל קידומת המדינה שמתחילה בסימן '+'. לדוגמה, מספר הטלפון של Google סידני הוא " +61 2 9374 4000".
- (NSString*) formattedAddress [read, copy] |
כתובת המקום כמחרוזת פשוטה.
- (מספר ממשי) rating [read, assign] |
דירוג של חמישה כוכבים למקום הזה מבוסס על ביקורות של משתמשים.
הדירוגים נעים בין 1.0 ל-5.0. 0.0 פירושו שאין לנו דירוג למקום הזה (למשל מפני שאין מספיק משתמשים כתבו על המקום הזה ביקורת).
- (NSArray<GMSPlaceReview *>*) ביקורות [read, copy] |
מערך של GMSPlaceReview
אובייקטים שמייצגים את ביקורות המשתמשים על המקום.
– (GMSPlacesPriceLevel) priceLevel [read, assign] |
רמת המחיר עבור המקום הזה, כמספרים שלמים מ-0 עד 4.
למשל, הערך 4 פירושו שהמקום הזה הוא '$$$$' (יקר). הערך 0 משמעו 'חינם' (למשל מוזיאון שהכניסה אליו היא בחינם).
- (NSArray<NSString *>*) סוגים [read, copy] |
סוגי המקום הזה.
הסוגים הם NSString. הערכים החוקיים הם כל הסוגים שתועדו בכתובת <https://developers.google.com/places/ios-sdk/supported_types>.
- (NSURL*) אתר [read, copy] |
אתר של המקום הזה.
- (NSAttributedString*) ייחוס [read, copy] |
מחרוזת השיוך של ספק הנתונים למקום הזה.
הערכים האלה מסופקים כ-NSAttributedString, שעשוי להכיל היפר-קישורים לאתר של כל ספק.
באופן כללי, צריך להציג אותם למשתמש אם מוצגים נתונים מ-GMSPlace זה, כפי שמתואר בתנאים ובהגבלות של Places SDK.
- (GMSPlaceViewportInfo*) viewportInfo [read, assign] |
- (NSArray<GMSAddressComponent *>*) addressComponents [read, copy] |
מערך של GMSAddressComponent
אובייקטים שמייצגים את הרכיבים בכתובת של המקום.
הרכיבים האלה נועדו לחילוץ מידע מובנה על הכתובת של המקום: לדוגמה, מציאת העיר שבה נמצא מקום מסוים.
אין להשתמש ברכיבים האלה לעיצוב כתובת. אם צריך להזין כתובת בפורמט המתאים, יש להשתמש בנכס formattedAddress
שמספק כתובת בפורמט מותאם לשוק המקומי.
- (GMSPlusCode*) plusCode [read, assign] |
הייצוג של המיקום של המקום הזה באמצעות Plus Code.
- (GMSOpeningHours*) openingHours [read, assign] |
המידע הרגיל לגבי שעות הפעילות של העסק במקום הזה.
כולל סטטוס פתיחה, תקופות וטקסט בימי חול, אם יש כאלה.
– (GMSOpeningHours*) currentOpeningHours [read, assign] |
הצגת שעות הפעילות של המקום הזה במהלך שבעת הימים הבאים.
פרק הזמן מתחיל בחצות בתאריך הבקשה ומסתיים בשעה 23:59 ב-6 הימים הבאים.
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) reservable [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] |
מאפיין המקום שמציין שהמקום נגיש לכיסא גלגלים בכניסה.