Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Retorna o local atual usando a funcionalidade de localização geográfica do dispositivo.
Disponível para
Esse método tem suporte apenas para os clientes móveis.
Sintaxe
Xrm.Device.getCurrentPosition().then(successCallback, errorCallback)
Parâmetros
| Nome do parâmetro | Tipo | Obrigatório | Description |
|---|---|---|---|
successCallback |
Função | Yes | Uma função a ser chamada quando as informações de localização geográfica atuais são retornadas. Um objeto de localização geográfica com os seguintes valores é passado para a função.: - coords: contém um conjunto de coordenadas geográficas, juntamente com a precisão associada e um conjunto de outros valores opcionais, como altitude e velocidade. - timestamp: representa a hora em que o objeto foi adquirido e é representado como DOMTimeStamp. |
errorCallback |
Função | Yes | Uma função a ser chamada quando a operação falhar. Um objeto com as seguintes propriedades é passado: - code: o código de erro. Número. - message: mensagem localizada que descreve os detalhes do erro. Cadeia de caracteres.Se a configuração de localização do usuário não estiver habilitada em seu dispositivo móvel, a mensagem de erro indicará o mesmo. Se você estiver usando uma versão anterior do cliente móvel de aplicativos controlados por modelo ou se a funcionalidade de localização geográfica não estiver disponível em seu dispositivo móvel, nulo será passado para o retorno de chamada de erro. |
Valor de retorno
Com êxito, retorna um objeto de localização geográfica com os valores especificados anteriormente na função successCallback .
Exceptions
Ver códigos de erro do serviço Web
Observações
Para que o método getCurrentPosition funcione, a capacidade de localização geográfica deve ser habilitada em seu dispositivo móvel e os clientes móveis de aplicativos controlados por modelo devem ter permissões para acessar o local do dispositivo, que não está habilitado por padrão.
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 });
}
);