Windows.Devices.Geolocation Namespace
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 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.