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