Compartilhar via


Windows.Devices.Geolocation Namespace

Fornece APIs para obter o local atual ou acompanhar a localização do dispositivo ao longo do tempo. As informações de localização podem vir da estimativa de uma posição de sinalizadores como Wi-Fi pontos de acesso e torres de célula, do endereço IP do dispositivo, ou podem vir de outras fontes, como um dispositivo GNSS ou GPS. A API Windows.Devices.Geolocation fornece os dados de geolocalização mais apropriados de todas as fontes disponíveis.

A precisão das informações de localização depende da origem. A latitude e a longitude podem variar dentro dos seguintes intervalos:

  • GPS: dentro de aproximadamente 10 metros
  • Wi-Fi: entre aproximadamente 30 metros e 500 metros
  • Torres de célula: entre aproximadamente 300 metros e 3.000 metros
  • Endereço IP: entre aproximadamente 1.000 metros e 5.000 metros

Além de latitude e longitude, o GPS também fornece informações sobre título, velocidade e altitude. Essas informações adicionais são opcionais quando as informações de localização vêm de outras fontes.

O usuário define a privacidade de seus dados de localização com as configurações de privacidade de localização no aplicativo Configurações. Seu aplicativo só pode acessar a localização do usuário quando:

  • Local para este dispositivo... está ativado (não aplicável a Windows 10 Mobile)
  • A configuração de serviços de localização, Localização, está ativada
  • Em Escolher aplicativos que podem usar sua localização, seu aplicativo está definido como ativado

Para obter mais informações sobre privacidade de local, consulte a Política de Privacidade do Windows.

Importante

A partir do Windows 10, chame RequestAccessAsync antes de acessar a localização do usuário. Nesse momento, seu aplicativo deve estar em primeiro plano e RequestAccessAsync deve ser chamado do thread da interface do usuário. Até que o usuário conceda permissão para a localização a seu aplicativo, o aplicativo não pode acessar os dados de localização.

Arquitetura de serviços de localização

A primeira camada da arquitetura de serviços de localização consiste em hardware no dispositivo. Isso inclui o receptor GPS, o Wi-Fi e o rádio celular. Todos eles podem funcionar como provedores de dados de localização com diferentes níveis de precisão e consumo de energia. Na parte superior do hardware está a camada de código nativa. Essa camada se comunica diretamente com as fontes de dados de localização disponíveis e decide quais fontes usar para determinar a localização do dispositivo com base na disponibilidade dos dados e nos requisitos de desempenho especificados pelo aplicativo. A camada de código nativo também se comunica pela Internet com um serviço Web hospedado pela Microsoft para pesquisar informações relacionadas à localização de um banco de dados. A camada superior do serviço de localização é a interface gerenciada, exposta por meio de uma DLL incluída no SDK do Windows. Um aplicativo usa essa interface para iniciar e parar solicitações de localização, para definir o nível de precisão exigido pelo aplicativo e para receber dados de localização da camada de código nativa à medida que ele se torna disponível.

Classes

CivicAddress

API sem suporte.

GeoboundingBox

Representa um retângulo que define uma área geográfica.

Geocircle

Descreve um círculo geográfico com um ponto central e um raio.

Geocoordinate

Contém as informações para identificar uma localização geográfica.

GeocoordinateSatelliteData

Fornece informações adicionais sobre um Geocoordinate. Essas informações só são aplicáveis às estimativas de posição obtidas usando sinais de satélite.

Geolocator

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

Geopath

Representa uma série ordenada de pontos geográficos.

Geopoint

Descreve um ponto geográfico.

Geoposition

Representa um local que pode conter dados de latitude e longitude ou dados de local.

Geovisit

Representa uma alteração de estado relacionada à visita. Consulte Diretrizes para usar o acompanhamento de Visitas para obter informações sobre como usar esse recurso.

GeovisitMonitor

Manipula o monitoramento das Visitas de um usuário quando o aplicativo está em uso (não em segundo plano).

GeovisitStateChangedEventArgs

Contém informações sobre um evento VisitStateChanged .

GeovisitTriggerDetails

Gerencia os detalhes de um gatilho para uma tarefa em segundo plano relacionada a Visitas.

PositionChangedEventArgs

Fornece dados para o evento PositionChanged .

StatusChangedEventArgs

Fornece informações para o evento StatusChanged .

VenueData

Representa o local associado a uma localização geográfica.

Estruturas

BasicGeoposition

As informações básicas para descrever uma posição geográfica.

Interfaces

IGeoshape

Interface para definir uma forma geográfica.

Enumerações

AltitudeReferenceSystem

Indica o sistema de referência de altitude a ser usado na definição de uma forma geográfica.

GeolocationAccessStatus

Indica se seu aplicativo tem permissão para acessar dados de localização.

GeoshapeType

Indica a forma de uma região geográfica.

PositionAccuracy

Indica o nível de precisão solicitado para os dados de localização que o aplicativo usa.

PositionSource

Indica a origem usada para obter um Geocoordinate.

PositionStatus

Indica a capacidade do objeto Geolocator de fornecer dados de localização.

VisitMonitoringScope

Contém valores que descrevem o escopo pretendido do monitoramento de localização para uso com o recurso Visitas.

VisitStateChange

Contém valores que descrevem uma alteração de estado relacionada à visita.

Exemplos

Os aplicativos de exemplo que usam classes desse namespace incluem o exemplo de Geolocalização e o exemplo de Geotag.

Confira também