סקירה כללית

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

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

פונקציות של חברי ציבור
(GMSPlaceOpenStatus)	- isOpenAtDate:
	כניסת ברירת המחדל לא זמינה.
(GMSPlaceOpenStatus)	- isOpen
	מחשבת אם המקום פתוח לפי `openingHours`, `UTCOffsetMinutes`, ולפי התאריך והשעה הנוכחיים שהתקבלו מ-`[NSDate date]`.
נכסים
NSString *	name
	שם המקום.
NSString *	placeID
	המזהה של המקום הזה.
ניהול צוותים ב-CLLocation2D	קואורדינטות
	מיקום המקום.
NSString *	phoneNumber
	מספר הטלפון של המקום הזה, בפורמט לחיוג בינלאומי, לדוגמה:
NSString *	formattedAddress
	כתובת המקום כמחרוזת פשוטה.
float	דירוג
	דירוג של חמישה כוכבים למקום הזה על סמך ביקורות של משתמשים.
GMSPlacesPriceLevel	priceLevel
	רמת המחיר עבור המקום הזה, כמספרים שלמים מ-0 עד 4.
NSArray< NSString * > *	סוגים
	הסוגים של מקום זה.
NSURL *	אתר
	אתר של המקום הזה.
NSAttributedString *	שיוכים
	מחרוזת השיוך של ספק הנתונים עבור המקום הזה.
GMSPlaceViewportInfo *	viewportInfo
	אזור התצוגה המומלץ למקום זה.
NSArray< GMSAddressComponent * > *	addressComponents
	מערך של `GMSAddressComponent` אובייקטים שמייצגים את הרכיבים בכתובת של המקום.
GMSPlusCode *	plusCode
	הייצוג של המיקום של המקום הזה באמצעות OLC.
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 *) תאריך

כניסת ברירת המחדל לא זמינה.

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

מיקום המקום.

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

- (NSString*) phoneNumber [read, copy]

מספר הטלפון של המקום הזה, בפורמט לחיוג בינלאומי, כלומר

כולל קידומת המדינה עם הסימן '+'. לדוגמה, מספר הטלפון של Google סידני הוא " +61 2 9374 4000".

- (NSString*) formattedAddress [read, copy]

כתובת המקום כמחרוזת פשוטה.

- (float) rating [read, assign]

דירוג של חמישה כוכבים למקום הזה על סמך ביקורות של משתמשים.

הדירוגים נעים בין 1.0 ל-5.0. 0.0 פירושו שאין לנו דירוג למקום הזה (למשל מפני שלא נתנו מספיק ביקורות על המקום הזה).

- (GMSPlacesPriceLevel) priceLevel [read, assign]

רמת המחיר עבור המקום הזה, כמספרים שלמים מ-0 עד 4.

למשל, ערך של 4 פירושו שהמקום הזה הוא '$$$$' (יקר). המשמעות של הערך 0 היא 'חינם' (למשל מוזיאון שהכניסה אליו בחינם).

- (NSArray<NSString *>*) types [read, copy]

הסוגים של מקום זה.

הסוגים הם NSString. ערכים חוקיים הם כל הסוגים שתועדו בכתובת <https://developers.google.com/places/ios-sdk/supported_types>.

- (NSURL*) אתר [read, copy]

אתר של המקום הזה.

- (NSAttributedString*) Attributions [read, copy]

מחרוזת השיוך של ספק הנתונים עבור המקום הזה.

הערכים האלה מסופקים כ-NSAttributedString, שיכול להכיל היפר-קישורים לאתר של כל ספק.

באופן כללי, חובה להציג אותם למשתמש אם מוצגים נתונים מ-GMSPlace זה, כפי שמתואר בתנאים וההגבלות של Places SDK.

- (GMSPlaceViewportInfo*) viewportInfo [read, assign]

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

ייתכן שהגודל הוא אפס אם גודל המקום אינו ידוע.

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

- (NSArray<GMSAddressComponent *>*) addressComponents [read, copy]

מערך של GMSAddressComponent אובייקטים שמייצגים את הרכיבים בכתובת של המקום.

הרכיבים האלה ניתנים לחילוץ מידע מובנה על כתובת המקום: לדוגמה, מציאת העיר שבה נמצא המקום.

אין להשתמש ברכיבים האלה לעיצוב כתובות. אם צריך כתובת בפורמט המתאים, צריך להשתמש בנכס formattedAddress שמספק כתובת בפורמט מותאם לשוק המקומי.

- (GMSPlusCode*) plusCode [read, assign]

הייצוג של המיקום של המקום הזה באמצעות OLC.

- (GMSOpeningHours*) openingHours [read, assign]

מידע על שעות הפעילות הרגילות של העסק במקום הזה.

כולל סטטוס פתיחה, תקופות וטקסט של ימי חול, אם הם זמינים.

- (GMSOpeningHours*) currentOpeningHours [read, assign]

מחזירה את שעות הפעילות של מקום זה במהלך שבעת הימים הבאים.

פרק הזמן מתחיל בחצות בתאריך הבקשה ומסתיים בשעה 23:59 שישה ימים לאחר מכן.

GMSPlaceSpecialDay ערכים ב-GMSOpeningHours יהיו זמינים רק עבור GMSPlace currentOpeningHours ו-GMSPlace secondaryOpeningHours.

- (NSArray<GMSOpeningHours *>*) secondaryOpeningHours [read, copy]

מחזירה מערך של שעות הפעילות המשניות של המקום במהלך שבעת הימים הבאים.

שעות הפעילות המשניות שונות משעות הפעילות הראשיות של העסק. לדוגמה, מסעדה יכולה להגדיר את שעות הפתיחה או את שעות המשלוח כשעות משניות. בGMSPlaceHoursType מופיעים הסוגים השונים של שעות פעילות משניות.

GMSPlaceSpecialDay ערכים ב-GMSOpeningHours יהיו זמינים רק עבור GMSPlace currentOpeningHours ו-GMSPlace secondaryOpeningHours.