CoreLocation Namespace

Referência

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.

O namespace CoreLocation fornece classes para localização de acompanhamento e monitoramento, regiões (incluindo iBeacons) e geocodificação.

Classes

CLAuthorizationChangedEventArgs	Fornece dados para o evento de AuthorizationChanged .
CLBeacon	Representa um dispositivo de área local que pode ser usado para monitoramento de localização refinado.
CLBeaconRegion	Região CoreLocation determinada por um iBeacon.
CLCircularRegion	Um CLRegion definido por um centro e um raio (em metros).
CLFloor	Informações que descrevem um nível de construção.
CLGeocoder	Fornece suporte para conversão entre um endereço em formato de texto e um local descrito usando latitude e longitude ou para converter de um latitue e longitude em um local amigável (rua, cidade, estado, país).
CLHeading	Dados de título, conforme gerados pelo CLLocationManager.
CLHeadingUpdatedEventArgs	Fornece dados para o evento de UpdatedHeading .
CLLocation	Informações de localização, conforme gerado pela classe CLLocationManager.
CLLocationDistance	Uma classe cujos membros estáticos definem constantes relacionadas à filtragem e à distância máxima.
CLLocationManager	Gerencia a entrega de eventos de localização, região e título para seu aplicativo.
CLLocationManagerDelegate	Os métodos virtuais nessa classe recebem notificações do CLLocationManager.
CLLocationManagerDelegate_Extensions	Métodos de extensão para a ICLLocationManagerDelegate interface para dar suporte a todos os métodos do CLLocationManagerDelegate protocolo.
CLLocationsUpdatedEventArgs	Fornece dados para o evento de LocationsUpdated .
CLLocationUpdatedEventArgs	Fornece dados para o evento de UpdatedLocation .
CLPlacemark	Associa dados como endereço de rua a uma coordenada.
CLRegion	A classe base para regiões geográficas rastreáveis.
CLRegionBeaconsFailedEventArgs	Fornece dados para o evento de RangingBeaconsDidFailForRegion .
CLRegionBeaconsRangedEventArgs	Fornece dados para o evento de DidRangeBeacons .
CLRegionErrorEventArgs	Fornece dados para o evento de MonitoringFailed .
CLRegionEventArgs	Fornece dados para os RegionLefteventos , E:CoreLocation.CLRegionEventArgs.RegionEntered e E:CoreLocation.CLRegionEventArgs.RegionLeft .
CLRegionStateDeterminedEventArgs	Fornece dados para o evento de DidDetermineState .
CLVisit	Relaciona um local e um raio com uma hora de chegada e partida.
CLVisitedEventArgs	Fornece dados para o evento de DidVisit .

Estruturas

CLLocationCoordinate2D

Coordenadas geográficas.

Interfaces

ICLLocationManagerDelegate

Interface que representa os métodos necessários (se houver) do protocolo CLLocationManagerDelegate.

Enumerações

CLActivityType	Uma enumeração cujos valores especificam diferentes tipos de atividade.
CLAuthorizationStatus	Uma enumeração cujos valores especificam o status atual de autorização para usar serviços de localização.
CLDeviceOrientation	Uma enumeração cujos valores representam a orientação física do dispositivo.
CLError	Erros retornados pelo CLLocationManager.
CLProximity	Uma enumeração cujos valores especificam a proximidade física de um iBeacon.
CLRegionState	Uma enumeração cujos valores especificam se o dispositivo está dentro ou fora de uma região ou desconhecido.

Delegados

CLGeocodeCompletionHandler	Um delegado que é o `completionHandler` em chama para GeocodePostalAddressAsync(CNPostalAddress, NSLocale).
CLLocationManagerEventArgs	Argumentos de evento gerados pelo ShouldDisplayHeadingCalibration evento.

Comentários

O namespace Localização Principal gira em torno do rastreamento e monitoramento da localização do usuário, da entrada e saída do dispositivo de regiões (fixas ou baseadas em iBeacon) e da geocodificação entre endereços e locais.

Os casos de uso de geocodificação são centralizados na CLGeocoder classe . A geocodificação é simples:

async void GeocodeToConsoleAsync (string address) {
    var geoCoder = new CLGeocoder();
    var placemarks = await geoCoder.GeocodeAddressAsync(address);
    foreach (var placemark in placemarks) {
	      Console.WriteLine(placemark);
    }

Assim como a geocódigo reverso:

async void ReverseGeocodeToConsoleAsync (CLLocation location) {
    var geoCoder = new CLGeocoder();
    var placemarks = await geoCoder.ReverseGeocodeLocationAsync(location);
    foreach (var placemark in placemarks) {
	      Console.WriteLine(placemark);
    }          
}

Outros casos de uso normalmente começarão com a CLLocationManager classe :

Acompanhamento da localização do dispositivo
Monitoramento de região (cerca geográfica)
iBeacon variando

Esses casos de uso são discutidos na documentação da CLLocationManager classe.

Compartilhar via