סקירה כללית
מייצג מקום פיזי מסוים.
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.
הפונקציה מחשבת אם מקום פתוח על סמך 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] |
- (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
.
– (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) ייצוא נתונים [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] |
מאפיין מקום שמציין שהמקום נגיש לכיסא גלגלים בכניסה.