Geolocator Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece acesso à localização geográfica atual.
public ref class Geolocator sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Geolocator final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class Geolocator final
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class Geolocator
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class Geolocator
function Geolocator()
Public NotInheritable Class Geolocator
- Herança
- Atributos
Requisitos do Windows
Família de dispositivos |
Windows 10 (introduzida na 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (introduzida na v1.0)
|
Funcionalidades do aplicativo |
location
ID_CAP_LOCATION [Windows Phone]
|
Exemplos
Este exemplo mostra como usar a classe Geolocator para recuperar a localização do dispositivo. Para saber mais, consulte Obter a localização atual.
using Windows.Devices.Geolocation;
...
var accessStatus = await Geolocator.RequestAccessAsync();
switch (accessStatus)
{
case GeolocationAccessStatus.Allowed:
// notify user: Waiting for update
// If DesiredAccuracy or DesiredAccuracyInMeters are not set (or value is 0), DesiredAccuracy.Default is used.
Geolocator geolocator = new Geolocator { DesiredAccuracyInMeters = _desireAccuracyInMetersValue };
// Subscribe to StatusChanged event to get updates of location status changes
_geolocator.StatusChanged += OnStatusChanged;
// Carry out the operation
Geoposition pos = await geolocator.GetGeopositionAsync();
UpdateLocationData(pos);
// notify user: Location updated
break;
case GeolocationAccessStatus.Denied:
// notify user: Access to location is denied
break;
case GeolocationAccessStatus.Unspecified:
// notify user: Unspecified error
break;
}
Comentários
Histórico de versão
Versão do Windows | Versão do SDK | Valor adicionado |
---|---|---|
1607 | 14393 | AllowFallbackToConsentlessPositions |
1607 | 14393 | DefaultGeoposition |
1607 | 14393 | IsDefaultGeopositionRecommended |
Construtores
Geolocator() |
Inicializa um novo objeto Geolocator . |
Propriedades
DefaultGeoposition |
Obtém o local inserido manualmente no sistema pelo usuário, a ser utilizado se não houver opções melhores. |
DesiredAccuracy |
O nível de precisão no qual o Geolocator fornece atualizações de localização. |
DesiredAccuracyInMeters |
Obtém ou define a precisão desejada em medidores para os dados retornados do serviço de localização. |
IsDefaultGeopositionRecommended |
Indica se o usuário deve ser solicitado a definir um local padrão manualmente. |
LocationStatus |
O status que indica a capacidade do Geolocalizador de fornecer atualizações de localização. |
MovementThreshold |
A distância de movimento, em metros, em relação à coordenada do último evento PositionChanged , que é necessária para que o Geolocator gere um evento PositionChanged . |
ReportInterval |
O intervalo de tempo mínimo solicitado entre atualizações de localização, em milissegundos. Se o aplicativo exigir atualizações com pouca frequência, defina esse valor para que os serviços de localização possam economizar energia calculando a localização somente quando necessário. |
Métodos
AllowFallbackToConsentlessPositions() |
Define o Geolocalizador para usar a localização grosseira como uma opção de fallback (consulte Comentários). |
GetGeopositionAsync() |
Inicia uma operação assíncrona para recuperar o local atual do dispositivo. |
GetGeopositionAsync(TimeSpan, TimeSpan) |
Inicia uma operação assíncrona para recuperar o local atual do dispositivo. |
GetGeopositionHistoryAsync(DateTime) |
Inicia uma operação assíncrona para recuperar o histórico de localização do dispositivo. Observação Essa API não está disponível para todos os aplicativos do Windows. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime. |
GetGeopositionHistoryAsync(DateTime, TimeSpan) |
Inicia uma operação assíncrona para recuperar o histórico de localização do dispositivo. Observação Essa API não está disponível para todos os aplicativos do Windows. A menos que sua conta de desenvolvedor seja provisionada especialmente pela Microsoft, as chamadas para essas APIs falharão em runtime. |
RequestAccessAsync() |
Observação Algumas informações relacionam-se ao produto de pré-lançamento, o qual poderá ser substancialmente modificado antes do lançamento comercial. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas. Importante Essa API será afetada pelas próximas alterações no comportamento do sistema operacional, previstas para o outono de 2024. Para obter mais informações, consulte Alterações no comportamento da API para Wi-Fi acesso e localização. Solicita permissão para acessar dados de localização. |
Eventos
PositionChanged |
Gerado quando o local é atualizado. |
StatusChanged |
Gerado quando a capacidade do Geolocator de fornecer a localização atualizada é alterada. |