סקירה כללית
שירותים שמאפשרים שליטה בגישה מהנייד ל-SDK של ניווט במפות Google ל-iOS.
פונקציות סטטיות של חברים ציבוריים | |
(BOOL) | + areTermsAndConditionsAccepted |
מציין אם המשתמש הביע הסכמה לתנאים ולהגבלות. | |
(void) | + showTermsAndConditionsDialogIfNeededWithTitle:companyName:UIParams:callback: |
מציג תיבת דו-שיח מודאלית אם המשתמש באפליקציה עדיין לא הביע הסכמה לתנאים ולהגבלות של ה-SDK לניווט. | |
(void) | + showTermsAndConditionsDialogIfNeededWithTitle:companyName:callback: |
הצגת תיבת הדו-שיח 'תנאים והגבלות' באמצעות העיצוב והסגנון שמוגדרים כברירת מחדל. | |
(void) | + showTermsAndConditionsDialogIfNeededWithCompanyName:callback: |
הצגת תיבת הדו-שיח 'תנאים והגבלות' עם הכותרת והמראה המוגדרים כברירת מחדל. | |
(void) | + resetTermsAndConditionsAccepted |
איפוס התנאים וההגבלות למצב שלא אושרו. | |
(void) | + setAbnormalCurrencyReportingEnabled: |
מאפשר דיווח על סגירה חריגת של SDK, כמו קריסות של האפליקציה בזמן שה-SDK עדיין פועל. | |
(nullable GMSNavigationSession *) | + createNavigationSession |
יוצר סשן ניווט חדש שאינו משויך לתצוגת מפה. | |
(NSString *) | + openSourceLicenseInfo |
מחזירה את פרטי רישיון התוכנה של הקוד הפתוח עבור Google Navigation SDK עבור iOS. | |
(NSString *) | + navSDKVersion |
מחזירה את הגרסה עבור הגרסה הזו של Navigation SDK עבור iOS. | |
נכסים | |
בול (BOOL) | shouldOnlyShowDriverAwarenesssDisclaimer |
ההערה מציינת אם showTermsAndConditionsDialogIfNeededWithCompanyName:callback: צריך להציג רק את כתב הוויתור של מוּדעוּת הנהג. | |
פונקציות קשורות | |
(חשוב לזכור שאלה לא פונקציות חבר). | |
typedef void(^ | GMSTermsResponseCallback )(תנאי BOOL אושרו) |
מופעלת כשהמשתמש מאשר או דוחה את התנאים וההגבלות. |
תיעוד לגבי פונקציות חברים
+ (BOOL) areTermsAndConditionsAccepted |
מציין אם המשתמש הביע הסכמה לתנאים ולהגבלות.
אם המדיניות הזו מוגדרת כ-False, השירותים משביתים את הגישה לממשקי הניווט.
+ (ביטול) showTermsAndConditionsDialogIf NeededWithTitle: | (nullable NSString *) | שם הפריט | |
שם החברה: | (NSString *) | companyName | |
UIParams: | (nullable GMSNavigationTermsDialogUIParams *) | UIParams | |
קריאה חוזרת (callback): | (GMSTermsResponseCallback) | התקשרות חזרה | |
מציג תיבת דו-שיח מודאלית אם המשתמש באפליקציה עדיין לא הביע הסכמה לתנאים ולהגבלות של ה-SDK לניווט.
הקריאה החוזרת תישלח בתור הראשי עם תגובת המשתמש.
אם המשתמש כבר הביע הסכמה לתנאים ולהגבלות, לא תופיע תיבת דו-שיח, והקריאה החוזרת תכיל את הערך termsAccepted
= YES
.
מגדירים את הפרמטר companyName
לחברה שלכם. שם החברה מופיע בטקסט התנאים וההגבלות. הטקסט מסביר למשתמשי האפליקציה שייתכן שנתוני המיקום ישותפו עם החברה כדי לשפר את התפעול.
כדאי להפעיל את השיטה הזו מה-thread הראשי. לשיחות מרובות ללא המתנה לתשובה אין השפעה.
- פרמטרים:
-
שם פריט כותרת של תיבת הדו-שיח. אם הערך של title
הוא אפס, תיבת הדו-שיח תשתמש בכותרת ברירת המחדל.
- הערה:
- בכותרות בהתאמה אישית, מבצע הקריאה החוזרת לשיטה הזו צריך לבצע התאמה של הפרמטר הזה לשוק המקומי. כותרת ברירת המחדל מותאמת לשוק המקומי על ידי השירותים באופן אוטומטי.
- פרמטרים:
-
companyName שם החברה שמפיצה את האפליקציה ובהסכם עם Google לשיתוף נתוני המיקום. UIParams פרמטרים שמגדירים את העיצוב והסגנון של תיבת הדו-שיח. אם הערך הוא nil, תיבת הדו-שיח תשתמש במראה ובסגנון המוגדרים כברירת מחדל. קריאה חוזרת (callback) החסימה נשלחה בתור הראשי עם תגובת המשתמש.
+ (ביטול) showTermsAndConditionsDialogIf NeededWithTitle: | (nullable NSString *) | שם הפריט | |
שם החברה: | (NSString *) | companyName | |
קריאה חוזרת (callback): | (GMSTermsResponseCallback) | התקשרות חזרה | |
הצגת תיבת הדו-שיח 'תנאים והגבלות' באמצעות העיצוב והסגנון שמוגדרים כברירת מחדל.
לפרטים, כולל תיאור של הפרמטרים , companyName
ו-callback
, אפשר להיכנס לקטע +showTermsAndConditionsDialogIf NeededWithTitle:companyName:UIParams:callback:.
+ (ביטול) showTermsAndConditionsDialogIf NeededWithCompanyName: | (NSString *) | companyName | |
קריאה חוזרת (callback): | (GMSTermsResponseCallback) | התקשרות חזרה | |
הצגת תיבת הדו-שיח 'תנאים והגבלות' עם הכותרת והמראה המוגדרים כברירת מחדל.
לפרטים, כולל תיאור של הפרמטרים companyName
ו-callback
, אפשר לקרוא את הקטע +showTermsAndConditionsDialogIf NeededWithTitle:companyName:UIParams:callback:.
+ (void) resetTermsAndConditionsAccepted |
איפוס התנאים וההגבלות למצב שלא אושרו.
אחרי הפעלת השיטה הזו, areTermsAndConditionsAccepted
יחזיר את הערך 'לא' ו-showTermsAndConditionsDialogIfNeededWithCompanyName:callback:
יציג את תיבת הדו-שיח של התנאים וההגבלות. המאפיין navigationEnabled
של כל מופעים קיימים של GMSMapView יאופס לערך NO.
+ (ריק) setAbnormalFinishReportingEnabled: | (BOOL) | abnormalTerminationReportingEnabled |
מאפשר דיווח על סגירה חריגת של SDK, כמו קריסות של האפליקציה בזמן שה-SDK עדיין פועל.
כך Google יכולה לשפר את יציבות ה-SDK במקרים הרלוונטיים. ברירת המחדל היא YES
וצריך לעדכן את הערך לפני אתחול מופע השירותים.
צריך להגדיר את המאפיין הזה מה-thread הראשי.
+ (פונקציית GMSNavigationSession * עם ערך null) createNavigationSession |
יוצר סשן ניווט חדש שאינו משויך לתצוגת מפה.
פעולה זו מקצה ומחזירה סשן ניווט חדש. ניתן להגדיר ציוני דרך ואפשרויות בסשן, ומאזינים עשויים להתווסף אליו.
אם התנאים וההגבלות עדיין לא אושרו, השיטה הזו תחזיר אפס. זו הסיבה היחידה שבגללה לא יוחזר אפס מהשיטה הזו.
ניתן לשייך את הסשן הזה למפה באמצעות שיטת GMSMapView
-enableNavigationWithSession
: סשנים הם אובייקטים שצורכים זיכרון, נתונים וסוללה מאותה הסיבה, אם האפליקציה שלכם יוצרת ממשק משתמש לניווט לאחר יצירת סשן ניווט, יש להקפיד להתחיל את ממשק הניווט עם סשן הניווט הקיים במקום ליצור ממשק חדש.
משך החיים של סשן הניווט כפוף לסמנטיקה הרגילה של מטרה-C. לכן, מבצע הקריאה החוזרת לתרחיש הזה אמור לשמור הפניה לסשן.
+ (NSString *) openSourceLicenseInfo |
מחזירה את פרטי רישיון התוכנה של הקוד הפתוח עבור Google Navigation SDK עבור iOS.
המידע הזה חייב להיות זמין באפליקציה שלכם.
+ (NSString *) navSDKVersion |
מחזירה את הגרסה עבור הגרסה הזו של Navigation SDK עבור iOS.
תיעוד של חברים ופונקציות קשורות
- (typedef void(^ GMSTermsResponseCallback)(תנאי BOOL accepted)) [related] |
מופעלת כשהמשתמש מאשר או דוחה את התנאים וההגבלות.
מסמכי תיעוד לגבי הנכס
- (BOOL) shouldOnlyShowDriverAwarenesssDisclaimer [read, write, assign] |
ההערה מציינת אם showTermsAndConditionsDialogIfNeededWithCompanyName:callback:
צריך להציג רק את כתב הוויתור של מוּדעוּת הנהג.
ברירת המחדל היא NO
, וכתב הוויתור מוצג בנוסף לתנאים ולשירותים המוגדרים כברירת מחדל שמסופקים עם ה-API של הניווט. צריך להגדיר את הערך YES
כדי לציין שצריך להציג רק את כתב הוויתור לגבי מוּדעוּת הנהג.
אם הפרויקט צריך להציג את תיבת הדו-שיח 'תנאים והגבלות', להגדרת המשתנה הזה כ-YES
אין השפעה. בנוסף, שיטת getter תמיד מחזירה את הערך NO
.
צריך להגדיר את המאפיין הזה או לקרוא אותו מה-thread הראשי.