إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
إرجاع الموقع الحالي باستخدام إمكانية تحديد الموقع الجغرافي للجهاز.
متوفر ل
يتم دعم هذا الأسلوب فقط لعملاء الأجهزة المحمولة.
بناء الجملة
Xrm.Device.getCurrentPosition().then(successCallback, errorCallback)
المعلمات
| اسم المعلمة | نوع | مطلوبة | الوصف |
|---|---|---|---|
successCallback |
الوظيفة | نعم | دالة لاستدعاء عند إرجاع معلومات الموقع الجغرافي الحالية. يتم تمرير كائن تحديد الموقع الجغرافي بالقيم التالية إلى الدالة .: - coords: يحتوي على مجموعة من الإحداثيات الجغرافية جنبا إلى جنب مع الدقة المرتبطة ومجموعة من القيم الاختيارية الأخرى مثل الارتفاع والسرعة. - timestamp: يمثل الوقت الذي تم فيه الحصول على الكائن ويتم تمثيله ك DOMTimeStamp. |
errorCallback |
الوظيفة | نعم | وظيفة للاتصال عند فشل العملية. يتم تمرير كائن بالخصائص التالية: - code: رمز الخطأ. الرقم. - message: رسالة مترجمة تصف تفاصيل الخطأ. السلسلة.إذا لم يتم تمكين إعداد موقع المستخدم على جهازك المحمول، فستشير رسالة الخطأ إلى نفس الشيء. إذا كنت تستخدم إصدارا سابقا من عميل الأجهزة المحمولة للتطبيقات المستندة إلى النموذج أو إذا لم تتوفر إمكانية تحديد الموقع الجغرافي على جهازك المحمول، يتم تمرير القيمة الخالية إلى رد اتصال الخطأ. |
قيمة الإرجاع
عند النجاح، ترجع كائن تحديد الموقع الجغرافي بالقيم المحددة سابقا في الدالة successCallback .
الاستثناءات
راجع رموز خطأ خدمة ويب
ملاحظات
لكي يعمل أسلوب 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 });
}
);