getCurrentPosition (חומר עזר עבור API של לקוח)

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

זמין עבור

שיטה זו נתמכת רק עבור לקוחות ניידים.

תחביר

Xrm.Device.getCurrentPosition().then(successCallback, errorCallback)

Parameters

שם פרמטר	Type	נדרש	Description
successCallback	פונקציה	‏‏כן‬	פונקציה להתקשרות כאשר מוחזר מידע המיקום הגיאוגרפי הנוכחי. אובייקט מיקום גיאוגרפי עם הערכים הבאים מועבר לפונקציה.: - coords: מכיל ערכה של קואורדינטות גיאוגרפיות יחד עם דיוק משויך וערכה של ערכים אופציונליים אחרים, כגון גובה ומהירות. - timestamp: מייצג את הזמן שבו האובייקט נרכש והוא מיוצג כ- DOMTimeStamp.
errorCallback	פונקציה	‏‏כן‬	פונקציה שיש לקרוא לה כאשר הפעולה נכשלת. אובייקט עם המאפיינים הבאים מועבר: - code: קוד השגיאה. מספר. - message: הודעה המותאמת לשפות אחרות המתארת את פרטי השגיאה. מחרוזת. אם הגדרת מיקום המשתמש אינה זמינה במכשיר הנייד שלך, הודעת השגיאה מציינת זאת. אם אתה משתמש בגירסה קודמת של לקוח מכשירים ניידים המבוססים על אפליקציות מונחות דגמים או אם יכולת זיהוי מיקום גיאוגרפי אינה זמינה במכשיר הנייד שלך, Null מועבר לחזרה חזרה של השגיאה.

ערך החזרה

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

Exceptions

ראה קודי שגיאה של שירות אינטרנט

הערות

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

דוגמה

Xrm.Device.getCurrentPosition().then(
    function success(location) {
        Xrm.Navigation.openAlertDialog({
            text: "Latitude: " + location.coords.latitude +
            ", Longitude: " + location.coords.longitude
        });
    },
    function (error) {
        Xrm.Navigation.openAlertDialog({ text: error.message });
    }
);

מאמרים קשורים

Xrm.Device