סקירה כללית

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

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

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

פרמטרים:

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

החזרות:: 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]

מזהה המקום של המקום הזה.

- (CLLocationCoordinate2D) קואורדינטה [read, assign]

מיקום המקום.

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

- (NSString*) phoneNumber [read, copy]

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

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

- (NSString*) formattedAddress [read, copy]

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

- דירוג (מספר ממשי (float)) [read, assign]

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

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

- (NSArray<GMSPlaceReview *>*) ביקורות [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*) שיוכים [read, copy]

מחרוזת השיוך (Attribution) של ספק הנתונים למקום הזה.

הנתונים האלה מסופקים בתור 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 במשך שישה ימים.

GMSPlaceSpecialDay רשומות ב-GMSOpeningHours יופיעו רק ב-GMSPlace currentOpeningHours וב-GMSPlace secondaryOpeningHours.

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

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

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

GMSPlaceSpecialDay רשומות ב-GMSOpeningHours יופיעו רק ב-GMSPlace currentOpeningHours וב-GMSPlace secondaryOpeningHours.