סקירה כללית

מייצג מקום פיזי מסוים.

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.

- (GMSPlaceOpenStatus) isOpen

מחשבת אם המקום פתוח לפי 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]

אזור התצוגה המומלץ למקום זה.

אם גודל המקום לא ידוע, המספר יכול להיות אפס.

פעולה זו מחזירה אזור תצוגה בגודל שמתאים להצגת מקום זה. לדוגמה, לאובייקט GMSPlace שמייצג חנות יכול להיות אזור תצוגה קטן יחסית, ולאובייקט GMSPlace שמייצג מדינה יכול להיות אזור תצוגה גדול מאוד.

- (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.