Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Retorna a localização atual usando o recurso de geolocalização do dispositivo.
Disponível para
Este método é suportado 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 para chamar quando as informações de geolocalização atuais são retornadas. Um objeto de geolocalização 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 para chamar quando a operação falhar. Um objeto com as seguintes propriedades é passado: - code: O código de erro. Número. - message: Mensagem localizada descrevendo os detalhes do erro. String.Se a definição de localização do utilizador não estiver ativada no seu dispositivo móvel, a mensagem de erro indica o mesmo. Se você estiver usando uma versão anterior do cliente móvel de aplicativos controlados por modelo ou se o recurso de geolocalização não estiver disponível em seu dispositivo móvel, null será passado para o retorno de chamada de erro. |
Valor de retorno
Quando for bem-sucedido, retorna um objeto de geolocalização com os valores especificados anteriormente na função successCallback .
Exceptions
Consulte os códigos de erro do serviço Web
Observações
Para que o método getCurrentPosition funcione, o recurso de geolocalização deve ser habilitado 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 });
}
);