Aracılığıyla paylaş


getCurrentPosition (İstemci API başvurusu)

Cihaz coğrafi konumu özelliğini kullanarak geçerli konumu döndürür.

Için kullanılabilir

Bu yöntem yalnızca mobil istemciler için desteklenir.

Sözdizimi

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

Parametreler

Parametre Adı Türü Gerekli Description
successCallback İşlev Yes Geçerli coğrafi konum bilgileri döndürülürken çağrılacak bir işlev. İşleve aşağıdaki değerlere sahip bir coğrafi konum nesnesi geçirilir.:
- coords: Bir coğrafi koordinat kümesinin yanı sıra ilişkili doğruluk ile yükseklik ve hız gibi isteğe bağlı bir dizi başka değer içerir.
- timestamp: Nesnenin alındığı ve DOMTimeStamp olarak temsil edildiği zamanı temsil eder.
errorCallback İşlev Yes İşlem başarısız olduğunda çağrılacak bir işlev. Aşağıdaki özelliklere sahip bir nesne geçirilir:
- code: Hata kodu. Numara.
- message: Hata ayrıntılarını açıklayan yerelleştirilmiş ileti. String.

Mobil cihazınızda kullanıcı konumu ayarı etkin değilse, hata iletisi de aynı şeyi gösterir. Model temelli uygulamalar mobil istemcisinin önceki bir sürümünü kullanıyorsanız veya mobil cihazınızda coğrafi konum özelliği yoksa, geri çağırma hatasına null geçirilir.

Dönüş Değeri

Başarılı olduğunda, successCallback işlevinde daha önce belirtilen değerleri içeren bir coğrafi konum nesnesi döndürür.

Exceptions

Bkz . Web hizmeti hata kodları

Açıklamalar

getCurrentPosition yönteminin çalışması için mobil cihazınızda coğrafi konum özelliğinin etkinleştirilmesi ve model temelli uygulamaların mobil istemcilerinin cihaz konumuna erişme izinleri olmalıdır ve bu özellik varsayılan olarak etkin değildir.

Example

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