NEW 앱인벤터2 강좌36. 컴포넌트 탐구 – 지도(Map)

지도(Map) 속성

속성명

설명

중심좌표(CenterFromString)

지도의 기본 중심 좌표를 지정합니다.

값은 쉼표( , )로 구분된 위도, 경도쌍으로 지정합니다.

기본값은 42.359144, -71.093612 입니다.

팬활성화여부(EnablePan)

팬(손가락을 밀어 지도를 움직이는 동작)을 허용할지 지정합니다.

회전가능여부(EnableRotation)

지도의 회전을 허용할지 지정합니다.

줌가능여부(EnableZoom)

줌(확대/축소)를 허용할지 지정합니다.

높이(Height)

지도의 높이를 지정합니다.

너비(Width)

지도의 너비를 지정합니다.

위치센서(LocationSensor)

기본 내장된 위치 제공자 대신 사용할 위치 센서를 지정합니다.

선택할 수 있는 위치 센서는 앱인벤터의 위치센서 컴포넌트입니다.

만약 지도가 있는 스크린에 위치센서 컴포넌트가 없으면 선택 목록에 아무것도 뜨지 않습니다.

지도유형(MapType)

지도의 유형을 선택합니다. 사용 가능한 종류는 다음과 같습니다:

1: 거리뷰

2: 항공뷰

3: 지형뷰

​

참고: 거리뷰는 OpenStreetMap에서, 항공뷰 및 지형 레이어는 US Geological Survey에서 제공합니다.

회전(Rotation)

지도의 회전 각도를 지정합니다.

크기단위(ScaleUnits)

축척에 사용되는 단위를 지정합니다. 사용가능한 단위는 다음과 같습니다:

1: 미터법

2: 야드법

나침반보이기(ShowCompass)

나침반을 표시합니다.

만약 휴대폰이 나침반을 사용할 수 있으면 나침반이 기기의 방향에 따라 회전합니다.

축척보기(ShowScale)

지도 축척을 표시합니다.

사용자보이기(ShowUser)

사용자의 현재 위치를 표시합니다.

이 기능은 사용자가 위치 서비스를 활성화 해야 쓸 수 있습니다.

줌보이기(ShowZoom)

확대/축소 버튼을 표시합니다.

보이기여부(Visible)

지도 컴포넌트의 보이기 여부를 지정합니다.

줌레벨(ZoomLevel)

확대율을 지정합니다. 확대율을 지도의 유형이나 위치에 따라 다릅니다.

예를 들어 지도의 저장 공간을 절약하기 위해 도시보다 바다에서는 최대 확대율이 낮을 수 있습니다.

지도(Map) 이벤트 블록

블록

설명

사용자가 지도를 이동하거나 확대/축소 또는 회전을 하여서 지도의 경계가 변경되었을 때 실행됩니다.

ㄴ 위도 [숫자]

ㄴ 경도 [숫자]

지도의 한 지점을 빠르게 두번 터치한 경우 해당 좌표를 반환하며 실행됩니다.

ㄴ 형상 [컴포넌트]

마커나 도형 등 지도 위의 형상을 클릭했을 때 클릭된 형상을 반환하며 실행됩니다.

ㄴ 형상 [컴포넌트]

마커나 도형 등 지도 위의 형상을 드래그했을 때 클릭된 형상을 반환하며 실행됩니다.

ㄴ 형상 [컴포넌트]

마커나 도형 등 지도 위의 형상을 길게 클릭했을 때 길게 클릭된 형상을 반환하며 실행됩니다.

ㄴ 형상 [컴포넌트]

마커나 도형 등 지도 위의 형상을 드래그를 시작했을 때 드래그된 형상을 반환하며 실행됩니다.

ㄴ 형상 [컴포넌트]

마커나 도형 등 지도 위의 형상을 드래그를 멈췄을 때 드래그된 형상을 반환하며 실행됩니다.

ㄴ url [텍스트]

ㄴ 형상 [리스트]

URL로 부터 형상을 가져오는데 성공했을 때 실행됩니다.

형상 매개변수는 가져온 형상을 앱인벤터에서 사용하는 형상 리스트 형식으로 변환하여 제공합니다.

ㄴ 메시지

위도 또는 경도가 잘못된 값일 때 메시지를 포함해서 실행됩니다.

범위는 위도가 [-90, 90], 경도가 [-180,180]입니다.

ㄴ url [텍스트]

ㄴ 응답코드 [숫자]

ㄴ 오류메시지 [텍스트]

URL로 부터 형상을 가져오는 데 실패한 경우 각종 오류 정보와 함께 실행됩니다.

ㄴ 위도 [숫자]

ㄴ 경도 [숫자]

지도의 한 지점을 길게 누른 경우 해당 좌표를 반환하며 실행됩니다.

지도의 초기화가 완료되어서 사용자가 사용할 수 있는 상태가 되었을 때 실행됩니다.

ㄴ 위도 [숫자]

ㄴ 경도 [숫자]

지도의 한 지점을 한번 터치한 경우 해당 좌표를 반환하며 실행됩니다.

사용자가 지도의 확대율을 변경하였을 때 실행됩니다.

지도(Map) 함수 블록

블록

설명

ㄴ 위도 [숫자]

ㄴ 경도 [숫자]

– (반환) 생성된 마커 [컴포넌트]

해당 위도, 경도에 새로운 마커를 생성합니다.

그리고 생성된 마커의 컴포넌트 객체를 반환합니다.

ㄴ 설명

– (반환) 형상 컴포넌트 [컴포넌트]

리스트로 된 형상 설명을 형상 컴포넌트로 변환하여 반환합니다.

ㄴ url [텍스트]

해당 URL에서 GeoJSON 형식의 형상을 가져옵니다.

​

만약 가져오는데 성공하면 [형상을 얻었을 때] 이벤트가 실행되며, 가져온 GeoJSON을 구문분석하여 리스트로 만들어 매개변수로 반환합니다.

​

가져오는데 실패하면 [열기 오류가 발생했을 때] 이벤트가 실행됩니다.

ㄴ 위도 [숫자]

ㄴ 경도 [숫자]

ㄴ 줌 [숫자]

지도 중심을 지정된 위도, 경도로 이동하면서 확대율 또한 조정합니다.

ㄴ 경로 [텍스트]

지도 컴포넌트 위의 형상들을 해당 경로에 GeoJSON 형식으로 저장합니다.

지도(Map) 속성 지정 블록​

블록

입력형식

설명

리스트

동서남북 각 경계의 좌표를 리스트로 받아서 해당 좌표들이 경계가 되도록 지도를 이동합니다.

​

((북쪽위도, 서쪽경도), (남쪽위도, 동쪽경도)) 형식으로 리스트를 지정해주면 됩니다.

​

자세한건 아래 문단을 참고해주세요.

텍스트

지도의 중심좌표를 지정합니다.

위도, 경도 형식으로 입력합니다.

논리

지도의 이동 허용 여부를 지정합니다.

논리

지도의 회전 허용 여부를 지정합니다.

논리

지도의 확대 허용 여부를 지정합니다.

리스트

리스트로 부터 형상을 가져옵니다.

숫자

지도의 높이를 px단위로 지정합니다.

숫자

지도의 높이를 현재 스크린 높이에 대한 비율로 지정합니다.

예시로 높이 비율이 50이면 스크린 높이의 반만큼 길어집니다.

위치센서

기본 위치 제공자 대신 사용할 위치 센서 컴포넌트를 지정합니다.

숫자

지도의 유형을 선택합니다. 사용 가능한 종류는 다음과 같습니다:

1: 거리뷰

2: 항공뷰

3: 지형뷰

숫자

지도의 회전 각도를 지정합니다.

숫자

축척에 사용되는 단위를 지정합니다. 사용가능한 단위는 다음과 같습니다:

1: 미터법

2: 야드법

논리

나침반의 표시 여부를 지정합니다.

논리

축척의 표시 여부를 지정합니다.

논리

사용자의 표시 여부를 지정합니다.

논리

줌 컨트롤러의 표시 여부를 지정합니다.

논리

지도의 보이기 여부를 지정합니다.

숫자

지도의 너비를 px단위로 지정합니다.

숫자

지도의 너비를 현재 스크린 너비에 대한 비율로 지정합니다.

예시로 너비 비율이 50이면 스크린 너비의 반만큼 길어집니다.

숫자

확대율을 지정합니다. 확대율을 지도의 유형이나 위치에 따라 다릅니다.

예를 들어 지도의 저장 공간을 절약하기 위해 도시보다 바다에서는 최대 확대율이 낮을 수 있습니다.

지도(Map) 속성 블록

블록

반환형식

리스트

논리

논리

논리

리스트

숫자

숫자

숫자

숫자

숫자

숫자

논리

논리

논리

논리

숫자

숫자

논리

숫자

숫자

컴포넌트