Application Service > Maps > Webマップガイド

Maps Webマップを使用するのに必要なJavaScript基盤Web APIを説明します。

API共通情報

事前準備

  • APIを使用するにはアプリケーションキーが必要です。
  • アプリケーションキーは、NHN Cloud Console上部にあるURL & Appkeyメニューで確認できます。

リクエスト共通情報

URL情報

項目 URL
マップ https://api-maps.cloud.toast.com

Webマップ

1. Webマップ

JavaScript基盤のNHN Cloud Maps APIを利用してWebブラウザにマップを表示する方法を説明します。 NHN Cloud 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.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 拡大縮小表示コントロールオプション
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" style="width:500px; height:500px;"></div>
<script type="text/javascript">
    var map;

    function initMap() {
        //宣言したDIVにマップを表示します。
        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
    // 航空写真に変更します。
    window.onload = function (){
        map.setType("SATELLITE");
    };
</script>

マップにイベントを登録

<script type="text/javascript">
    //マップにmoveイベントを登録します。
    window.onload = function (){
        map.on("move", moveHandler);
    }

    //マップイベント発生時のコールバック関数
    function moveHandler(event){
        console.log("event callback!");
    }
</script>

マップのイベントを削除

<script type="text/javascript">
    //マップのmoveイベントを削除します。
     window.onload = function (){
        map.off("move", moveHandler)
    }
</script>

マップマーカーの追加

<script type="text/javascript">
    // マップにマーカーオブジェクトを追加します。
    window.onload = function (){
        var marker = new inavi.maps.Marker({
            map: map,
            position: {
                lng: 127.11,
                lat: 37.40
            }
        });

        // マーカーオブジェクトを移動させます。
        marker.setPosition({lng: 127.110513, lat: 37.402027});
    }
</script>

画面ピクセル座標をWGS座標に変換

<script type="text/javascript">
    window.onload = function (){
        // 画面ピクセル座標をWGS座標に変換します。
        var screen_pixel = {
            x: 100,
            y: 100
        };

        var wgs84 = inavi.maps.Pixel.convertToLngLat(map,screen_pixel);
        console.log(wgs84.lng);
        console.log(wgs84.lat);
    }
</script>

WGS座標を画面ピクセル座標に変換

<script type="text/javascript">
    window.onload = function (){
        // WGS座標を画面ピクセル座標に変換します。
        var wgs84 = {
            lng: 127.11074994024005,
            lat: 37.40215870673785
        };

        var screen_pixel = inavi.maps.LngLat.convertToPixel(map,wgs84);
        console.log(screen_pixel.x);
        console.log(screen_pixel.y);
    }
</script>

マップスタイルの変更

// 作成されたマップオブジェクトのマップスタイルをMap Studioで作成したスタイルに変更します。
<script type="text/javascript">
    window.onload = function (){
        //StyleJosnUrlはMap Studioでスタイル配布時の配布コードを参照
        map.setStyle("{StyleJsonUrl}");
    }
</script>

// マップの初期化時にスタイルを使用する場合
<script type="text/javascript" src="https://api-maps.cloud.toast.com/maps/v3.0/appkeys/{appkey}/maps?callback=initMap&styleID={styleID}"></script>
TOP