Application Service > Maps > 웹 지도 가이드

Maps 웹 지도를 사용하는 데 필요한 JavaScript 기반 웹 API를 설명합니다.

API 공통 정보

사전 준비

  • API를 사용하려면 앱키가 필요합니다.
  • 앱키는 TOAST Console 상단 URL & Appkey 메뉴에서 확인할 수 있습니다.

요청 공통 정보

URL 정보

항목 URL
지도 https://api-maps.cloud.toast.com

웹 지도

1. 웹 지도

JavaScript 기반 TOAST Maps API를 이용해 웹 브라우저에 지도를 표시하는 방법을 설명합니다. TOAST Maps API는 WGS84(EPSG:4326) 좌표를 사용합니다.

주요 Maps API 안내

추가적인 Maps API 상세 사용법은 iNavi Maps API Center를 참고하시기 바랍니다.

API 명 Parameter Returns 설명
new inavi.maps.Map(options) options.container : string inavi.maps.Map 지도 객체 지도를 표시할 DOM 엘리먼트의 ID
options.type : string 지도의 타입
'NORMAL' : 일반 맵,
'SATTELITE' : 항공 맵
default: 'NORMAL'
options.center : LngLatLike 지도의 중심 좌표
options.zoom : number 지도의 레벨
options.heading : number 북쪽을 기준으로 반시계 방향으로 회전한 각도
options.tilt : number 지도를 눕혔을 때의 기울기
options.maxZoom : number 북쪽을 기준으로 반시계 방향으로 회전한 각도
options.heading : number 최대 확대 레벨
options.hash : boolean 주소 표시줄에 지도 정보 표시 여부
options.zoomable : boolean 확대 가능 여부
options.draggable : boolean 드래그 가능 여부
options.rotatable : boolean 회전 가능 여부
options.keyboard : boolean 키보드를 사용한 지도 이동 가능 여부
options.disableDefaultUI : boolean 기본 컨트롤 숨김 여부
options.logoScaleControl : LogoScaleControlOptions 로고 및 스케일 표시 컨트롤 옵션
options.compassControl : CompassControlOptions 나침반 표시 컨트롤 옵션
options.zoomControl : ZoomControlOptions 확대 축소 표시 컨트롤 옵션
changeType(type) type : string 지도의 타입
'NORMAL' : 일반 맵,
'SATTELITE' : 항공
default: 'NORMAL'
on(eventType, listener) eventType : string load,
zoomstart, zoom, zoomend,
rotatestart, rotate, rotateend,
tiltstart, tilt, tiltend,
click, dblclick,
mousedown, mouseup, mousemove,
mouseenter, mouseleave, mouseover, mouseout,
contextmenu,
wheel,
touchstart, touchend, touchcancel, touchmove,
movestart, move, moveend,
dragstart, drag, dragend
listener : Function 등록할 리스너
once(eventType, listener) eventType : string load,
zoomstart, zoom, zoomend,
rotatestart, rotate, rotateend,
tiltstart, tilt, tiltend,
click, dblclick,
mousedown, mouseup, mousemove,
mouseenter, mouseleave, mouseover, mouseout,
contextmenu,
wheel,
touchstart, touchend, touchcancel, touchmove,
movestart, move, moveend,
dragstart, drag, dragend
listener : Function 등록할 리스너
off(eventType, listener) eventType : string load,
zoomstart, zoom, zoomend,
rotatestart, rotate, rotateend,
tiltstart, tilt, tiltend,
click, dblclick,
mousedown, mouseup, mousemove,
mouseenter, mouseleave, mouseover, mouseout,
contextmenu,
wheel,
touchstart, touchend, touchcancel, touchmove,
movestart, move, moveend,
dragstart, drag, dragend
listener : Function 제거할 리스너
new inavi.maps.Marker(option) option.map : Map inavi.maps.Marker 마커 객체 지도 객체
option.icon : string 아이콘 URL
option.position : LngLatLike 마커 생성 좌표
option.anchor : string 좌표가 위치할 곳
top-left, top, top-right,
left, center, right,
bottom-left, bottom, bottom-right
option.title : string 툴팁 문자열
option.offset : Array 픽셀 단위 오프셋
option.draggable : boolean 드래그 가능 여부
option.zIndex : number z-index 값
option.opacity : number 투명도
inavi.maps.LngLat.convertToPixel(lngLat) lngLat.lng : number 화면 픽셀 좌표 WGS84 경도
lngLat.lat : number WGS84 위도
inavi.maps.Pixel.convertToLngLat(pixel) pixel.pxX : number 경위도 좌표 화면 픽셀 x 좌표
pixel.pxY : number 화면 픽셀 y 좌표

Maps API 사용

<script type="text/javascript" src="https://api-maps.cloud.toast.com/maps/v3.0/appkeys/{appkey}/maps?callback=initMap"></script>
<div id="div_map"></div>
<script type="text/javascript">
    function initMap() {
        //선언한 DIV에 지도를 표출합니다.
        var map = new inavi.maps.Map({
            container: "div_map",
            center: {
                lng: 127.11,
                lat: 37.40
            },
            zoom: 12,
            type: "NORMAL"
        });
    }
</script>

지도 모드 변경

<script type="text/javascript">
    // 생성된 지도 객체의 지도 Type을 변경합니다.
    // 일반: NORMAL, 항공배경: SATTELITE
    // 항공배경지도로 변경합니다.
    map.setType("SATTELITE");
</script>

지도 이벤트 등록

<script type="text/javascript">
    //지도에 move 이벤트를 등록합니다.
    map.addListener("click", clickHandler)

    //지도 이벤트 발생 시 콜백 함수
    function clickHandler(event){
        console.log("event callback!");
    }
</script>

지도 이벤트 제거

<script type="text/javascript">
    //지도에 move 이벤트를 제거합니다.
    map.off("move", moveHandler)
</script>

지도 마커 추가

<script type="text/javascript">
    // 지도에 마커 객체를 추가합니다.
    var marker = new inavi.maps.Marker({
        map: map,
        position: {
            lng: 127.11,
            lat: 37.40
        }
    });

    // 마커 객체를 이동시킵니다.
    marker.setPosition({lng: 127.2, lat: 37.5});
</script>

화면 픽셀 좌표를 WGS 좌표로 변환

<script type="text/javascript">
    // 화면 픽셀 좌표를 WGS 좌표로 변환합니다.
    var screen_pixel = {
        pxX: 100,
        pxY: 100
    };

    var wgs84 = inavi.maps.Pixel.convertToLngLat(screen_pixel);
    console.log(wgs84.lon);
    console.log(wgs84.lat);
</script>

WGS 좌표를 화면 픽셀 좌표로 변환

<script type="text/javascript">
    // WGS 좌표를 화면 픽셀 좌표로 변환합니다.
    var wgs84 = {
        lon: 127.11074994024005,
        lat: 37.40215870673785
    };

    var screen_pixel = inavi.maps.LngLat.convertToPixel(wgs84);
    console.log(screen_pixel.pxX);
    console.log(screen_pixel.pxY);
</script>
TOP