Geolocator Classe

Definição

Namespace:

Windows.Devices.Geolocation

Fornece acesso à localização geográfica atual.

public ref class Geolocator sealed

/// [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.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

Object Platform::Object IInspectable Geolocator

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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, 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.
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.
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.

Confira também

• Obter a localização atual
• exemplo de geolocalização
• Amostra de geotag (Windows 10)