HTML5 網路拓撲圖整合 OpenLayers 實現 GIS 地圖應用

在前面《百度地圖、ECharts整合HT for Web網路拓撲圖應用》我們有介紹百度地圖和 HT for Web 的整合，我們今天來談談 OpenLayers 和 HT for Web 的整合。

HT for Web作為邏輯拓撲圖形元件自身沒有GIS功能，但可以與各種GIS引擎即其客戶端元件進行融合，各取所長實現邏輯拓撲和物理拓撲的無縫融合，本章將具體介紹HT for Web與開發免費的OpenLayers地圖結合應用的關鍵技術點，該文介紹的結合的原理，其實還可推廣到與ArcGIS、百度地圖以及GoogleMap等眾多GIS地圖引擎融合的解決方案。

以上抓圖為本文介紹的例子最終執行效果，接下來我們一步步來實現，首選顯示地圖資訊需要有城市經緯度資料，搜尋了下感謝此篇部落格提供的資料。這麼大量的資料我採用的是《HT圖形元件設計之道（四）》中介紹的getRawText函式方式，有了資料之後剩下就是呈現的問題了，我們需要將HT的GraphView元件與OpenLayers的map地圖元件疊加在一起，也就是OpenLayers的tile地圖圖片在下方，GraphView的元件在上方，由於GraphView預設是透明的，因此非圖元部分使用者可穿透看到地圖內容。找到合適的元件插入位置是頭疼的事情，ArcGIS、百度地圖包括GoogleMap幾乎每個不同的GIS元件都需要嘗試一番才能找到合適的插入位置，其他GIS引擎元件的整合以後章節再介紹，本文我們關注的OpenLayers的插入方式為map.viewPortDiv.appendChild(graphView.getView())。

HT和OpenLayers元件疊加在一起之後，剩下就是拓撲裡面圖元的擺放位置與經緯度結合的問題，常規網路拓撲圖中儲存在ht.Node圖元的position是邏輯位置，和經緯度沒有任何關係，因此在GIS應用中我們需要根據圖元的經緯度資訊換算出position的螢幕邏輯座標資訊，如果你知道投影演算法也可以自己提供函式處理，但所有GIS元件都提供了類似的API函式供呼叫，當然這部分也沒有標準化，不同的GIS元件需要呼叫的API都有差異，但基本原理是一致的，對於OpenLayers我們通過map.getPixelFromLonLat(data.lonLat)可以將經緯度資訊轉換成螢幕畫素邏輯座標，也就是ht.Node需要的position座標資訊。

細心的同學會想到轉換是雙向的，有可能使用者需要拖動圖元節點改變其經緯度資訊，這時候我們就需要另外一個方向函式，即根據螢幕邏輯座標轉換成當前座標對應的經緯度，在OpenLayers中我們通過map.getLonLatFromPixel(new OpenLayers.Pixel(x, y));可以搞定。

顯示搞定後剩下就是互動的問題了，HT自己有套互動體系，OpenLayers也需要地圖漫遊和縮放的互動，兩者如何結合呢？如果能保留住兩者的功能那就最好了，答案時肯定的，我們只需要新增mousedown或touchstart事件監聽，如果graphView.getDataAt(e)選中了圖元我們就通過e.stopPropagation();停止事件的傳播，這樣map地圖就不會響應，這時候HT接管了互動，如果沒有選中圖元則map接管地圖操作的互動。

以上互動設計似乎很完美了，結果執行時發現了幾處折騰了我很久才找到解決方案的坑：

1. 設定map.events.fallThrough = true;否則map不會將事件透傳到HT的GraphView元件
2. graphView.getView().style.zIndex = 999; 需要指定一定的zIndex否則會被遮擋
3. graphView.getView().className = ‘olScrollable’; 否則滾輪不會響應地圖縮放
4. 設定ht.Default.baseZIndex: 1000 否則ToolTip會被遮擋

為了讓這個例子使用者體驗更友好，我還用心折騰了些技術點供參考：

1. 採用開源免費的http://llllll.li/randomColor/隨機顏色類庫，該類庫還有很多非常棒的顏色獲取函式，我只是簡單的為每個省份顯示不一樣的顏色
2. 過載了isVisible、isNoteVisible和isLabelVisible僅在縮放達到一定級別才顯示更詳細的內容，否則縮小時所有城市資訊都顯示完全無法檢視，多少也能提高顯示效能

以下為最終效果的抓圖、視訊和原始碼：http://v.youku.com/v_show/id_XODM5Njk0NTU2.html

   

function init(){                
    graphView = new ht.graph.GraphView();
    var view = graphView.getView();                 

    map = new OpenLayers.Map("map");
    var ol_wms = new OpenLayers.Layer.WMS(
        "OpenLayers WMS",
        "http://vmap0.tiles.osgeo.org/wms/vmap0",
        {layers: "basic"}
    );
    map.addLayers([ol_wms]);
    map.addControl(new OpenLayers.Control.LayerSwitcher());
    map.zoomToMaxExtent();                
    map.events.fallThrough = true;

    map.zoomToProxy = map.zoomTo;
    map.zoomTo =  function (zoom,xy){
        view.style.opacity = 0;
        map.zoomToProxy(zoom, xy);    
        console.log(zoom);
    };                

    map.events.register("movestart", this, function() {
    });
    map.events.register("move", this, function() {                   
    });
    map.events.register("moveend", this, function() {
        view.style.opacity = 1;
        reset();
    });                

    graphView.getView().className = 'olScrollable';
    graphView.setScrollBarVisible(false);
    graphView.setAutoScrollZone(-1);
    graphView.handleScroll = function(){};
    graphView.handlePinch = function(){};     
    graphView.mi(function(e){
        if(e.kind === 'endMove'){
            graphView.sm().each(function(data){
                if(data instanceof ht.Node){
                   var position = data.getPosition(),
                       x = position.x + graphView.tx(),
                       y = position.y + graphView.ty();  

                   data.lonLat = map.getLonLatFromPixel(new OpenLayers.Pixel(x, y));                                                                     
                }                            
            });
        }
    });
    graphView.enableToolTip();
    graphView.getToolTip = function(event){
        var data = this.getDataAt(event);
        if(data){
            return '城市：' + data.s('note') + '
經度：' + data.lonLat.lon + '
維度：' + data.lonLat.lat;
        }
        return null;
    };
    graphView.isVisible = function(data){
        return map.zoom > 1 || this.isSelected(data);
    };
    graphView.isNoteVisible = function(data){
        return map.zoom > 6 || this.isSelected(data);
    }; 
    graphView.getLabel = function(data){
        return '經度：' + data.lonLat.lon + '\n維度：' + data.lonLat.lat;
    };
    graphView.isLabelVisible = function(data){
        return map.zoom > 7 || this.isSelected(data);
    };                 

    view.addEventListener("ontouchend" in document ? 'touchstart' : 'mousedown', function(e){
        var data = graphView.getDataAt(e);
        if(data || e.metaKey || e.ctrlKey){
            e.stopPropagation();
        }                      
    }, false); 
    view.style.position = 'absolute';
    view.style.top = '0';
    view.style.left = '0';
    view.style.right = '0';
    view.style.bottom = '0';                
    view.style.zIndex = 999;
    map.viewPortDiv.appendChild(view);

    var color = randomColor();
    lines = china.split('\n');
    for(var i=0; i<lines.length; i++) {
        line = lines[i].trim();
        if(line.indexOf('【') === 0){
            //province = line.substring(1, line.length-1);                
            color = randomColor();
        }else{
            var ss = line.split(' ');
            if(ss.length === 3){
                createNode(parseFloat(ss[1].substr(3)), parseFloat(ss[2].substr(3)), ss[0].substr(3), color);                                                      
            }
        }
    }                                
}

function reset(){
    graphView.tx(0);
    graphView.ty(0);
    graphView.dm().each(function(data){                    
        if(data.lonLat){                            
            data.setPosition(map.getPixelFromLonLat(data.lonLat));                           
        }
    });
    graphView.validate();
}

function createNode(lon, lat, name, color){
    var node = new ht.Node();
    node.s({
        'shape': 'circle',
        'shape.background': color,
        'note': name,                    
        'label.background': 'rgba(255, 255, 0, 0.5)',                    
        'select.type': 'circle'
    });
    node.setSize(10, 10);
    var lonLat = new OpenLayers.LonLat(lon, lat);
    lonLat.transform('EPSG:4326', map.getProjectionObject());
    node.setPosition(map.getPixelFromLonLat(lonLat));
    node.lonLat = lonLat;
    graphView.dm().add(node);
    return node;
}