Σημείωση
Η πρόσβαση σε αυτή τη σελίδα απαιτεί εξουσιοδότηση. Μπορείτε να δοκιμάσετε να συνδεθείτε ή να αλλάξετε καταλόγους.
Η πρόσβαση σε αυτή τη σελίδα απαιτεί εξουσιοδότηση. Μπορείτε να δοκιμάσετε να αλλάξετε καταλόγους.
Επιστρέφει την τρέχουσα θέση χρησιμοποιώντας τη δυνατότητα γεωεντοπισμού της συσκευής.
Διαθέσιμο για
Αυτή η μέθοδος υποστηρίζεται μόνο για τα προγράμματα-πελάτες για κινητές συσκευές.
Σύνταξη
Xrm.Device.getCurrentPosition().then(successCallback, errorCallback)
Παραμέτρους
| Όνομα παραμέτρου | Δακτυλογραφώ | Απαιτούμενο | Περιγραφή |
|---|---|---|---|
successCallback |
Function | Ναι | Μια συνάρτηση που καλείται όταν επιστρέφονται οι τρέχουσες πληροφορίες γεωεντοπισμού. Ένα αντικείμενο γεωεντοπισμού με τις ακόλουθες τιμές μεταβιβάζεται στη συνάρτηση.: - coords: Περιέχει ένα σύνολο γεωγραφικών συντεταγμένων μαζί με τη σχετική ακρίβεια και ένα σύνολο άλλων προαιρετικών τιμών, όπως το υψόμετρο και η ταχύτητα. - timestamp: Αντιπροσωπεύει την ώρα που αποκτήθηκε το αντικείμενο και αναπαρίσταται ως DOMTimeStamp. |
errorCallback |
Function | Ναι | Μια λειτουργία για κλήση όταν αποτύχει η λειτουργία. Διαβιβάζεται ένα αντικείμενο με τις ακόλουθες ιδιότητες: - code: Ο κωδικός σφάλματος. Αριθμός. - message: Μεταφρασμένο μήνυμα που περιγράφει τις λεπτομέρειες του σφάλματος. Σειρά.Εάν η ρύθμιση θέσης χρήστη δεν είναι ενεργοποιημένη στην κινητή συσκευή σας, το μήνυμα σφάλματος υποδεικνύει το ίδιο. Εάν χρησιμοποιείτε μια παλαιότερη έκδοση του προγράμματος-πελάτη εφαρμογών βάσει μοντέλου για κινητές συσκευές ή εάν η δυνατότητα γεωεντοπισμού δεν είναι διαθέσιμη στην κινητή συσκευή σας, η τιμή null μεταβιβάζεται στην επιστροφή κλήσης σφάλματος. |
Τιμή επιστροφής
Κατά την επιτυχία, επιστρέφει ένα αντικείμενο γεωεντοπισμού με τις τιμές που καθορίστηκαν νωρίτερα στη συνάρτηση successCallback .
Εξαιρέσεις
Ανατρέξτε στο θέμα Κωδικοί σφαλμάτων υπηρεσίας Web
Παρατηρήσεις
Για να λειτουργήσει η μέθοδος 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 });
}
);