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