다음을 통해 공유


Windows.Devices.Geolocation 네임스페이스

현재 위치를 가져오거나 시간이 지남에 따라 디바이스의 위치를 추적하기 위한 API를 제공합니다. 위치 정보는 Wi-Fi 액세스 지점 및 셀 타워와 같은 비콘의 위치를 디바이스의 IP 주소에서 추정하거나 GNSS 또는 GPS 장치와 같은 다른 원본에서 나올 수 있습니다. Windows.Devices.Geolocation API는 사용 가능한 모든 원본에서 가장 적절한 지리적 위치 데이터를 제공합니다.

위치 정보의 정확도는 원본에 따라 달라집니다. 위도 및 경도는 다음 범위 내에서 다를 수 있습니다.

  • GPS : 약 10미터 이내
  • Wi-Fi : 약 30미터에서 500미터 사이
  • 셀 타워 : 약 300미터에서 3,000미터 사이
  • IP 주소: 약 1,000미터에서 5,000미터 사이

GPS는 위도 및 경도 외에도 제목, 속도 및 고도에 대한 정보를 제공합니다. 이 추가 정보는 위치 정보가 다른 원본에서 제공되는 경우 선택 사항입니다.

사용자는 설정 앱의 위치 개인 정보 설정에서 자신의 위치 데이터 개인 정보를 설정합니다. 앱은 다음 경우에만 사용자의 위치에 액세스할 수 있습니다.

  • 이 디바이스의 위치...켜져 있습니다(Windows 10 Mobile 적용할 수 없음)
  • 위치 서비스 설정 위치켜짐 상태임
  • 사용자의 위치를 사용할 수 있는 앱 선택에서 앱이 on 상태임

위치 개인 정보에 대한 자세한 내용은 Windows 개인정보처리방침을 참조하세요.

중요

Windows 10 사용자의 위치에 액세스하기 전에 RequestAccessAsync를 호출합니다. 이때 앱이 포그라운드에 있어야 하고 RequestAccessAsync가 UI 스레드에서 호출되어야 합니다. 사용자가 자신의 위치에 대한 권한을 앱에 부여하기 전에는 앱이 위치 데이터에 액세스할 수 없습니다.

위치 서비스 아키텍처

위치 서비스 아키텍처의 첫 번째 계층은 디바이스의 하드웨어로 구성됩니다. 여기에는 GPS 수신기, Wi-Fi 및 셀룰러 라디오가 포함됩니다. 이들은 모두 다양한 수준의 정확도와 전력 소비를 가진 위치 데이터의 공급자로 작동할 수 있습니다. 하드웨어 위에 네이티브 코드 계층이 있습니다. 이 계층은 위치 데이터의 사용 가능한 원본과 직접 통신하고 데이터의 가용성 및 애플리케이션에서 지정한 성능 요구 사항에 따라 디바이스의 위치를 결정하는 데 사용할 원본을 결정합니다. 네이티브 코드 계층은 인터넷을 통해 Microsoft 호스팅 웹 서비스와 통신하여 데이터베이스에서 위치 관련 정보를 조회합니다. 위치 서비스의 최상위 계층은 Windows SDK에 포함된 DLL을 통해 노출되는 관리되는 인터페이스입니다. 앱은 이 인터페이스를 사용하여 위치 요청을 시작 및 중지하고, 앱에 필요한 정확도 수준을 설정하고, 사용할 수 있게 되면 네이티브 코드 계층에서 위치 데이터를 수신합니다.

클래스

CivicAddress

지원되지 않는 API.

GeoboundingBox

지리적 영역을 정의하는 사각형을 나타냅니다.

Geocircle

중심점과 반경이 있는 지리적 원을 설명합니다.

Geocoordinate

지리적 위치를 식별하기 위한 정보를 포함합니다.

GeocoordinateSatelliteData

Geocoordinate에 대한 추가 정보를 제공합니다. 이 정보는 위성 신호를 사용하여 얻은 예상 위치를 지정하는 데만 적용됩니다.

Geolocator

현재 지리적 위치에 대한 액세스를 제공합니다.

Geopath

정렬된 일련의 지리적 지점을 나타냅니다.

Geopoint

지리적 지점을 설명합니다.

Geoposition

위도 및 경도 데이터 또는 장소 데이터를 포함할 수 있는 위치를 나타냅니다.

Geovisit

방문 관련 상태 변경을 나타냅니다. 이 기능을 사용하는 방법에 대한 자세한 내용은 방문 추적 사용에 대한 지침을 참조하세요.

GeovisitMonitor

앱이 사용 중일 때(백그라운드가 아님) 사용자의 방문 모니터링을 처리합니다.

GeovisitStateChangedEventArgs

VisitStateChanged 이벤트에 대한 정보를 포함합니다.

GeovisitTriggerDetails

방문 관련 백그라운드 작업에 대한 트리거의 세부 정보를 관리합니다.

PositionChangedEventArgs

PositionChanged 이벤트에 대한 데이터를 제공합니다.

StatusChangedEventArgs

StatusChanged 이벤트에 대한 정보를 제공합니다.

VenueData

지리적 위치와 연결된 장소를 나타냅니다.

구조체

BasicGeoposition

지리적 위치를 설명하는 기본 정보입니다.

인터페이스

IGeoshape

지리적 셰이프를 정의하는 인터페이스입니다.

열거형

AltitudeReferenceSystem

지리적 셰이프를 정의하는 데 사용할 고도 참조 시스템을 나타냅니다.

GeolocationAccessStatus

앱에 위치 데이터에 액세스할 수 있는 권한이 있는지를 나타냅니다.

GeoshapeType

지리적 영역의 모양을 나타냅니다.

PositionAccuracy

애플리케이션에서 사용하는 위치 데이터에 대해 요청된 정확도 수준을 나타냅니다.

PositionSource

Geocoordinate를 가져오는 데 사용되는 원본을 나타냅니다.

PositionStatus

Geolocator 개체가 위치 데이터를 제공하는 기능을 나타냅니다.

VisitMonitoringScope

방문 기능에 사용할 위치 모니터링의 의도된 scope 설명하는 값을 포함합니다.

VisitStateChange

방문 관련 상태 변경을 설명하는 값을 포함합니다.

예제

이 네임스페이스의 클래스를 사용하는 샘플 애플리케이션에는 지리적 위치 샘플Geotag 샘플이 포함됩니다.

추가 정보