개요

모바일 기기의 위치정보를 제공합니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

속성

coords

모바일 기기에서 마지막으로 수신된 위치정보 객체를 갖는 읽기전용 속성입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☑ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법 설정

var nlatitude = this.Geolocation00.coords.latitude ;
accuracy	위치정보의 오차범위값을 갖는 하위속성입니다.
altitude	위치정보 중 고도정보를 Meter 단위의 숫자로 갖는 하위속성입니다.
altitudeaccuracy	고도정보의 오차범위값을 갖는 하위속성입니다.
heading	위치정보 중 방향정보를 360도 단위의 숫자로 갖는 하위속성입니다.
latitude	위치정보 중 위도정보를 숫자로 갖는 하위속성입니다.
longitude	위치정보 중 경도정보를 숫자로 갖는 하위속성입니다.
speed	위치정보 중 속도정보를 Meter/Second 단위의 숫자로 갖는 하위속성입니다.

참고

- Android 일 경우 altitudeaccuracy 하위속성을 지원하지 않습니다.
- 하위 속성 중 speed 속성값이 유효하지 않은 값인 경우(0 또는 0보다 작은 값)에는 speed 속성값을 undefined로 반환합니다.

id

Geolocation의 고유 식별자를 설정하는 속성입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☑ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

Geolocation.id

문법 설정

id	Geolocation를 구별할 수 있는 유일값을 갖습니다.

참고

-  addChild나 insertChild 메소드를 사용하여 컴포넌트를 등록할때 parent 가 자식컴포넌트를 구별하기 위한 고유한 key값입니다.

- 속성명이나 메소드명과 같은 예약어를 id 속성값으로 설정할 경우 오류가 발생할 수 있습니다.

- 컴포넌트의 속성은 아니지만 편의를 위하여 넥사크로 스튜디오에서 설정할 수 있는 기능이 제공됩니다.

- name 속성은 사용자가 지정한 컴포넌트의 이름으로 논리적으로 중복이 가능합니다.

- 넥사크로 스튜디오에서 컴포넌트를 생성하거나 id 값을 설정하면 name 속성에 동일한 값이 설정됩니다.

name

Geolocation 의 이름을 설정하는 속성입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

속성 타입

☐ Enum

☐ Expr

☐ Control

☑ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

Geolocation.name[= strName]

문법 설정

strName	컴포넌트의 이름을 설정합니다.

참고

- name 속성은 사용자가 지정한 컴포넌트의 이름으로 논리적으로 중복이 가능합니다.

- 넥사크로 스튜디오에서 컴포넌트를 생성하거나 id 값을 설정하면 name 속성에 동일한 값이 설정됩니다.

parent

Geolocation 의 부모 오브젝트를 갖는 읽기전용 속성입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

속성 타입

☐ Enum

☐ Expr

☐ Control

☑ Hidden

☑ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

Geolocation.parent

문법 설정

var objParent = this.Geolocation00.parent;

참고

- parent 속성은 일반적으로 컴포넌트가 속한 Form을 갖습니다.

- Geolocation 이(가) Div 와 같은 컨테이너 컴포넌트에 자식으로 존재한다면 parent 속성은 해당 컨테이너 컴포넌트를 갖습니다.

- Calendar 와 같이 서브컨트롤이 존재하는 컴포넌트에서 서브컨트롤의 parent 속성은 해당 컴포넌트를 갖습니다.

sourcetype

모바일 기기에서 수신된 위치정보를 제공한 소스를 갖는 읽기전용 속성입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☐ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☑ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

참고

- GPS 에서 수신된 위치정보일 경우 1 로 설정됩니다.
   WPS 에서 수신된 위치정보일 경우 2 로 설정됩니다.

- iOS/iPadOS NRE 는 사용할 수 없는 속성입니다.

timestamp

모바일 기기에서 위치정보를 수신한 시간을 갖는 읽기전용 속성입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☑ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

메서드

getCurrentPosition

모바일 기기의 위치정보를 반환하는 메소드입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

문법

Geolocation.getCurrentPosition ( nAccuracy, nTimeout )

파라미터

Parameters	Type	Description
nAccuracy	Number	위치 정보의 정확도를 숫자로 설정합니다. 값이 작을수록 반환되는 값의 정확도가 높아집니다. Android NRE 는 0~2 범위의 값(ACCURACY_0~ACCURACY_2)을 설정합니다. iOS/iPadOS NRE 는 0~4 범위의 값(ACCURACY_0~ACCURACY_4)을 설정합니다.
nTimeout	Number	위치 정보를 수신할 제한시간을 밀리초(milliseconds) 단위의 숫자로 설정합니다. 200ms~86,400,000ms 사이의 값을 설정할 수 있습니다. 제한시간을 초과할 때까지 응답이 없는 경우 onrecverror 이벤트가 발생합니다.
Geolocation.getCurrentPosition( 2, 1000 );

Parameters

Type

Description

nAccuracy

Number

위치 정보의 정확도를 숫자로 설정합니다.

값이 작을수록 반환되는 값의 정확도가 높아집니다.

Android NRE 는 0~2 범위의 값(ACCURACY_0~ACCURACY_2)을 설정합니다.

iOS/iPadOS NRE 는 0~4 범위의 값(ACCURACY_0~ACCURACY_4)을 설정합니다.

nTimeout

Number

위치 정보를 수신할 제한시간을 밀리초(milliseconds) 단위의 숫자로 설정합니다.

200ms~86,400,000ms 사이의 값을 설정할 수 있습니다.

제한시간을 초과할 때까지 응답이 없는 경우 onrecverror 이벤트가 발생합니다.

Geolocation.getCurrentPosition( 2, 1000 );

반환

Type	Description
Boolean	위치 정보 수신에 성공하면 true 를 반환하고, onrecvsuccess 이벤트가 발생합니다. 위치 정보 수신에 실패하면 false 를 반환하고, onrecverror 이벤트가 발생합니다. nAccuracy 값이 0~4 값이 아니면 false 를 반환합니다.

Type

Description

Boolean

위치 정보 수신에 성공하면 true 를 반환하고, onrecvsuccess 이벤트가 발생합니다.

위치 정보 수신에 실패하면 false 를 반환하고, onrecverror 이벤트가 발생합니다.

nAccuracy 값이 0~4 값이 아니면 false 를 반환합니다.

참고

- Android NRE 는 어플리케이션 설치시 GPS 사용허가를 획득한 경우에만 사용가능합니다.

- iOS/iPadOS NRE 는 기기가 Airplane 모드일 때 GPS 기능을 사용할 수 없습니다.

watchStart

모바일 기기의 위치정보를 일정 간격으로 수신하도록 설정하는 메소드입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

문법

Geolocation.watchStart(nAccuracy, nIntervalTime)

파라미터

Parameters	Type	Description
nAccuracy	Number	위치 정보의 정확도를 숫자로 설정합니다. 값이 작을수록 반환되는 값의 정확도가 높아집니다. Android 일 경우 "0~2"(ACCURACY_0~ACCURACY_2) 범위의 값을 설정합니다. iOS 일 경우 "0~4"(ACCURACY_0 ~ ACCURACY_4) 범위의 값을 설정합니다.
nIntervalTime	Number	위치 정보를 수신할 주기를 밀리초(milliseconds) 단위의 숫자로 설정합니다. 주기는 200ms ~ 86,400,000ms 사이의 값을 설정할 수 있습니다
Geolocation.watchStart(1, 1000);

Parameters

Type

Description

nAccuracy

Number

위치 정보의 정확도를 숫자로 설정합니다.

값이 작을수록 반환되는 값의 정확도가 높아집니다.

Android 일 경우 "0~2"(ACCURACY_0~ACCURACY_2) 범위의 값을 설정합니다.

iOS 일 경우 "0~4"(ACCURACY_0 ~ ACCURACY_4) 범위의 값을 설정합니다.

nIntervalTime

Number

위치 정보를 수신할 주기를 밀리초(milliseconds) 단위의 숫자로 설정합니다.

주기는 200ms ~ 86,400,000ms 사이의 값을 설정할 수 있습니다

Geolocation.watchStart(1, 1000);

반환

Type	Description
Boolean	메소드 실행에 성공하면 "true"를 반환합니다. 메소드 실행에 실패하거나 파라미터값을 잘 못 설정하면 "false"를 반환합니다.

Type

Description

Boolean

메소드 실행에 성공하면 "true"를 반환합니다.

메소드 실행에 실패하거나 파라미터값을 잘 못 설정하면 "false"를 반환합니다.

참고

- nIntervalTime 간격으로 nAccuracy 정확도의 위치 정보를 수신합니다.
  위치 정보 수신에 성공하면 onrecvsuccess 이벤트가 발생합니다.
  위치 정보 수신에 실패하면 onrecverror 이벤트가 발생합니다.

watchStop

watchStart() 메소드로 설정한 주기적인 위치정보 수신을 종료하는 메소드입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

문법

Geolocation.watchStop()

참고

- Android 일 경우 watchStop() 메소드 수행으로 GPS 사용을 변경하지 않습니다.
  환경설정에서 GPS 사용 여부를 변경 해야 합니다.

이벤트

onrecverror

모바일 기기에서 위치정보 수신이 실패했을 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

문법

onrecverror(obj:nexacro.Geolocation,e:nexacro.GeolocationErrorEventInfo);

파라미터

Parameters	Type	Description
obj	Geolocation	Event가 발생한 Object.
e	GeolocationErrorEventInfo	Event Object.

onrecvsuccess

모바일 기기에서 위치정보 수신이 성공했을 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

문법

onrecvsuccess(obj:nexacro.Geolocation,e:nexacro.GeolocationEventInfo);

파라미터

Parameters	Type	Description
obj	Geolocation	Event가 발생한 Object.
e	GeolocationEventInfo	Event Object.