Geolocator Classe

  • Referência

Definição

Namespace:
Windows.Devices.Geolocation
Editar

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

Aplica-se a

Confira também