इसके माध्यम से साझा किया गया


getCurrentPosition (क्लाइंट एपीआई संदर्भ)

डिवाइस जियोलोकेशन क्षमता का उपयोग करके वर्तमान स्थान लौटाता है।

के लिए उपलब्ध है

यह विधि केवल मोबाइल ग्राहकों के लिए समर्थित है।

सिंटैक्स

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 });
    }
);

एक्सआरएम.डिवाइस