위치 태그 위젯
위치 태그에는 다음 세 가지 모드가 있습니다.
• 스텔스 추적 - 화면에 시각 표현 없이 계속해서(아래 설명 참조) 위치를 가져옵니다.
• 제어 추적 - 계속해서(아래 참고 참조) 위치를 가져올 수 있지만 이 기능을 켜거나 끄는 시각적 컨트롤을 포함합니다. 기본적으로 이 컨트롤이 보이면 추적이 비활성 상태입니다. 사용자가 추적을 시작하려면 이 컨트롤을 켜야 합니다.
• 정적 그랩 - 매쉬업이 초기화되면 위치를 한 번만 가져오고 전체 매쉬업이 다시 로드되지 않으면 다시 가져오지 않습니다. 이 모드에서는 화면에 시각 표현이 없습니다.
 |
"계속해서"는 장치에 의해 결정됩니다. 예를 들어, 움직이지 않는 노트북이 사용자의 위치를 추적할 속도는 핸드헬드 GPS 사용 스마트폰보다 훨씬 느립니다.
|
|
|
스타일 및 공통 위젯 속성은 아래 표에 포함되어 있지 않습니다.
|
|
속성 이름
|
설명
|
기본 유형
|
기본값
|
바인딩 가능 여부 (Y/N)
|
로컬리제이션 가능 여부 (Y/N)
|
|---|---|---|---|---|---|
|
TrackLocation
|
위젯은 사용자 위치의 이동을 추적합니다. ShowControls가 없으면 위젯은 매쉬업이 작동하는 동안 계속해서 추적합니다. 컨트롤을 표시하면 추적을 켜고 끌 수 있습니다. 여기에 바인딩하면 다른 위젯에 위치 추적을 알립니다.
|
BOOLEAN
|
해당 없음
|
Y
|
N
|
|
EnableHighAccuracy
|
스마트폰과 같은 장치는 해당 GPS 기능을 사용할 수 있습니다. 고정밀도를 사용하면 네트워크 기능 이상의 GPS 기능을 사용할 수 있습니다. 고정밀도를 사용하면 성능에 영향을 줄 수 있으며 이러한 사용은 장치 권한에 의해 제어되기도 합니다.
|
BOOLEAN
|
True
|
Y
|
N
|
|
MinimumUpdateFrequency
|
위젯 간 위치 값 업데이트 최소 시도 시간(초)입니다.
|
NUMBER
|
5
|
N
|
N
|
|
Timeout
|
위젯에서 위치를 기다리는 시간(초)입니다.
|
NUMBER
|
T
|
T
|
|
|
MaximumCacheAge
|
캐시된 위치가 유지되는 시간(초)입니다. MaximumCacheAge 내 후속 위치 호출은 캐시된 위치 값을 반환합니다.
|
NUMBER
|
0
|
N
|
N
|
|
CurrentLocation
|
현재 위치 - WGS84의 경도, 위도, 고도 및 단위입니다.
|
LOCATION
|
해당 없음
|
Y
|
N
|
|
DateTime
|
현재 위치가 감지되었거나 오류가 반환된 날짜 및 시간입니다.
|
DATETIME
|
해당 없음
|
Y
|
N
|
|
ShowDataLoading
|
로드하는 동안 데이터를 표시합니다.
|
BOOLEAN
|
True
|
N
|
N
|
|
Heading
|
현재 위치가 감지되었을 때 나침반 방향(진북에서 시계 방향의 각도)입니다. TrackLocation이 true일 때만 적용됩니다.
|
NUMBER
|
해당 없음
|
Y
|
N
|
|
Speed
|
현재 위치가 감지되었을 때 이동 중인 속도(m/s)입니다. TrackLocation이 true일 때만 적용됩니다.
|
NUMBER
|
해당 없음
|
Y
|
N
|
|
ShowControls
|
위치를 추적할 경우 런타임 컨트롤을 표시하여 추적을 시작하거나 중지할 수 있습니다.
|
BOOLEAN
|
False
|
N
|
N
|
|
LocationAccuracy
|
위치의 정밀도(미터로 측정)입니다.
|
NUMBER
|
해당 없음
|
Y
|
N
|
|
ErrorMessage
|
위치를 가져오지 못할 경우 반환되는 오류 메시지입니다.
|
STRING
|
해당 없음
|
Y
|
N
|
|
ErrorCode
|
위치를 가져오지 못할 경우 반환되는 오류 코드입니다.
|
NUMBER
|
해당 없음
|
Y
|
N
|
|
ShowDataLoading
|
로딩 중인 데이터를 표시할 수 있습니다.
|
BOOLEAN
|
True
|
N
|
N
|
|
Changed
|
이벤트입니다. 위치를 성공적으로 가져오면 Changed 이벤트가 트리거됩니다. 이 이벤트는 업데이트된 CurrentLocation을 기록하는 AddStreamEntry와 같은 서비스를 실행하는 데 사용될 수 있습니다.
|
해당 없음
|
해당 없음
|
Y
|
N
|
|
Visible
|
위젯이 런타임에 표시됩니까?
|
BOOLEAN
|
True
|
N
|
N
|
예외
위치 태그가 위치를 가져오지 못하면 오류가 throw됩니다. 위치 실패는 Changed 이벤트를 트리거하지 않습니다. 오류는 다음 두 바인딩 가능 부분으로 나눠집니다.
• ErrorCode - 숫자 0 - 3입니다.
• ErrorMessage - 다음 방식으로 ErrorCode에 해당합니다.
◦ 'Permission denied' == 1: 일반적으로 최종 사용자가 자신의 위치를 공유하지 않도록 선택하면 반환됩니다.
◦ 'Position unavailable' == 2: 일종의 네트워크 실패입니다.
◦ 'Timeout' == 3: 네트워크를 통한 위치 획득은 Timeout 속성을 통해 지정된 시간(초) 내에서 발생하지 않습니다.
◦ 'Unknown error' == 0
ErrorMessage 및 ErrorCode 이외에 DateTime 속성이 오류 발생 시 시간으로 업데이트됩니다.
 |
위치 태그가 TrackLocation으로 구성되고 ShowControls가 켜져 있는 경우 UI에 예외 컨트롤이 표시됩니다. 이 컨트롤을 클릭하여 위치를 다시 시도하고 가져옵니다.
|